rotate_z()

rotate_z()#

Rotates around the z-axis the amount specified by the angle parameter.

Examples#

example picture for rotate_z()

def setup():
    py5.size(100, 100, py5.P3D)
    py5.translate(py5.width//2, py5.height//2)
    py5.rotate_z(py5.PI/3.0)
    py5.rect(-26, -26, 52, 52)

example picture for rotate_z()

def setup():
    py5.size(100, 100, py5.P3D)
    py5.translate(py5.width//2, py5.height//2)
    py5.rotate_z(py5.radians(60))
    py5.rect(-26, -26, 52, 52)

Description#

Rotates around the z-axis the amount specified by the angle parameter. Angles should be specified in radians (values from 0 to TWO_PI) or converted from degrees to radians with the radians() function. Coordinates are always rotated around their relative position to the origin. Positive numbers rotate in a clockwise direction and negative numbers rotate in a counterclockwise direction. Transformations apply to everything that happens after and subsequent calls to the function accumulates the effect. For example, calling rotate_z(PI/2) and then rotate_z(PI/2) is the same as rotate_z(PI). If rotate_z() is run within the draw(), the transformation is reset when the loop begins again. This function requires using P3D as a third parameter to size() as shown in the example.

Underlying Processing method: rotateZ

Signatures#

rotate_z(
    angle: float,  # angle of rotation specified in radians
    /,
) -> None

Updated on March 06, 2023 02:49:26am UTC

Contents