Camera Projections

Camera Projections

Built-in RIS camera projection plugins are available via PrmanGlobalSettings:

images/rfkCameraProjection.png

Custom camera project plugins are not currently supported by RfK.

Projection Types

default

Use the default camera projection set in CameraCreate.
images/rfkCameraCreate.png

sphere

Spherical camera projection. Valid parameters:

  • hsweep
  • vsweep

RIB declaration:

Projection "sphere" "float hsweep" [360] "float vsweep" [180]

cylinder

Cylindrical camera projection. Valid parameters:

  • hsweep

RIB declaration:

Projection "cylinder" "float hsweep" [360]

torus

Torus camera projection. Valid parameters:

  • hsweep
  • vsweep
  • minor

RIB declaration:

Projection "torus" "float hsweep" [360] "float vsweep" [180] "float minor" [0.25]

PxrLightProbe

Paul Debevec style light probe projection.

RIB declaration:

Projection "PxrLightProbe"

Projection Parameters

hsweep

This gives the angle range to be covered by the -1 to 1 span in screen window coordinates in horizontal direction. By default these ranges will be covered exactly by square images; wider or taller images will cover a larger sweep in one direction or the other.

vsweep

Similar to hsweep but for the vertical direction.

minor

For torus projection, this sets the minor parameter which is the ratio of the minor radius to the major radius.

Projection Modifiers

A projection modifier emits an additional RiProjection into the RIB. It must be after the camera projection.

PxrRollingShutter

Valid parameters:

angle - This only changes the time samples in motion blur. It does not affect the ray position.

images/rfkCameraProjectionModifier.png

RIB declaration:

Projection "perspective" "fov" [65.9]
Projection "PxrRollingShutter" "float angle" [90]