Py5Shape.specular()#

Sets the specular color of a Py5Shape object’s material, which sets the color of highlight.

Examples#

example picture for specular()
 1def create_strip(r, g, b):
 2    s = py5.create_shape()
 3    s.begin_shape(py5.TRIANGLE_STRIP)
 4    s.fill(0, 51, 102)
 5    s.specular(r, g, b)
 6    s.vertex(10, 40, -25)
 7    s.vertex(20, 0, -10)
 8    s.vertex(30, 40, 0)
 9    s.vertex(40, 0, 5)
10    s.vertex(50, 40, 0)
11    s.vertex(60, 0, -10)
12    s.vertex(70, 40, -25)
13    s.end_shape()
14    return s
15
16
17def setup():
18    py5.size(100, 100, py5.P3D)
19    py5.background(0)
20    py5.light_specular(255, 255, 255)
21    py5.directional_light(204, 204, 204, 0, 0, -1)
22    py5.shape(create_strip(255, 255, 255), 0, 5)
23    py5.shape(create_strip(204, 102, 0), 0, 50)

Description#

Sets the specular color of a Py5Shape object’s material, which sets the color of highlight. Specular refers to light which bounces off a surface in a preferred direction (rather than bouncing in all directions like a diffuse light). Use in combination with Py5Shape.emissive(), Py5Shape.ambient(), and Py5Shape.shininess() to set the material properties of a Py5Shape object.

This method can only be used within a Py5Shape.begin_shape() and Py5Shape.end_shape() pair. The specular color setting will be applied to vertices added after the call to this method.

Underlying Processing method: PShape.specular

Syntax#

specular(gray: float, /) -> None
specular(rgb: int, /) -> None
specular(x: float, y: float, z: float, /) -> None

Parameters#

  • gray: float - value between black and white, by default 0 to 255

  • rgb: int - color to set

  • x: float - red or hue value (depending on current color mode)

  • y: float - green or saturation value (depending on current color mode)

  • z: float - blue or brightness value (depending on current color mode)

Updated on November 12, 2021 11:30:58am UTC