perspective()#

Sets a perspective projection applying foreshortening, making distant objects appear smaller than closer ones.

Examples#

example picture for perspective()
def setup():
    py5.size(100, 100, py5.P3D)
    # re-creates the default perspective
    py5.no_fill()
    fov = py5.PI/3.0
    camera_z = (py5.height//2.0) / py5.tan(fov/2.0)
    py5.perspective(fov, py5.width/py5.height,
                    camera_z/10.0, camera_z*10.0)
    py5.translate(50, 50, 0)
    py5.rotate_x(-py5.PI/6)
    py5.rotate_y(py5.PI/3)
    py5.box(45)

Description#

Sets a perspective projection applying foreshortening, making distant objects appear smaller than closer ones. The parameters define a viewing volume with the shape of truncated pyramid. Objects near to the front of the volume appear their actual size, while farther objects appear smaller. This projection simulates the perspective of the world more accurately than orthographic projection. The version of perspective without parameters sets the default perspective and the version with four parameters allows the programmer to set the area precisely. The default values are: perspective(PI/3.0, width/height, cameraZ/10.0, cameraZ*10.0) where cameraZ is ((height/2.0) / tan(PI*60.0/360.0)).

Underlying Processing method: perspective

Signatures#

perspective() -> None

perspective(
    fovy: float,  # field-of-view angle (in radians) for vertical direction
    aspect: float,  # ratio of width to height
    z_near: float,  # z-position of nearest clipping plane
    z_far: float,  # z-position of farthest clipping plane
    /,
) -> None

Updated on September 01, 2022 16:36:02pm UTC