Name

perspective()

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))

Examples

  • // Re-creates the default perspective
    size(400, 400, P3D);
    noFill();
    float fov = PI/3.0;
    float cameraZ = (height/2.0) / tan(fov/2.0);
    perspective(fov, float(width)/float(height), 
                cameraZ/10.0, cameraZ*10.0);
    translate(200, 200, 0);
    rotateX(-PI/6);
    rotateY(PI/3);
    box(180);
    Image output for example 1

Syntax

  • perspective()
  • perspective(fovy, aspect, zNear, zFar)

Parameters

  • fovy(float)field-of-view angle (in radians) for vertical direction
  • aspect(float)ratio of width to height
  • zNear(float)z-position of nearest clipping plane
  • zFar(float)z-position of the farthest clipping plane

Return

  • void