PxrCamera

PxrCamera

A camera model that approximates a number of real world physical effects. This supports all of the traditional prman perspective camera settings including shaped motion blur and bokeh.

Some examples of the effects PxrCamera can do:

images/pxrcamera.png

Parameters

Standard Perspective

Field of View

Field of view (FOV) in degrees. For rectangular images this is normally the FOV along the narrower image dimension.

RIB: float fov
Default: 90.0

Tilt-Shift

Tilt Angle

Angle in degrees to tilt the lens. Makes the plane of focus non- parallel to the image plane. Has no effect unless depth of field is enabled. Positive tilts up, bringing the focus in the top of the image closer and pushing the focus in the bottom further. Negative does the reverse.

RIB: float tilt
Default: 0.0

Roll Angle

Roll the lens clockwise. If the lens tilt is non-zero this can be used to rotate the plane of focus around the image center.

RIB: float roll
Default: 0.0

Shift X

Shift the lens horizontally. This can be used to correct for perspective distortion. Positive values shift towards the right.

RIB: float shiftX
Default: 0.0

Shift Y

Shift the lens vertically. This can be used to correct for perspective distortion "keystone" effects. To keep vertical lines parallel, aim the camera horizontally and adjust this to include the subject. Positive values shift towards the top.

RIB: float shiftY
Default: 0.0

Lens Distortion

Radial Distortion 1

Quadratic radial lens distortion coefficient. Positive values produce pincushion distortion. Negative values produce barrel distortion.

RIB: float radial1
Default: 0.0

Radial Distortion 2

Quartic radial lens distortion coefficient. Positive values produce pincushion distortion. Negative values produce barrel distortion.

RIB: float radial2
Default: 0.0

Assymetric Distortion X

Distortion applied only in the X direction. Horizontal lines will remain straight. Positive values produce pincushion-like distortion. Negative values produce barrel-like distortion.

RIB: float assymX
Default: 0.0

Assymetric Distortion Y

Distortion applied only in the Y direction. Vertical lines will remain straight. Positive values produce pincushion-like distortion. Negative values produce barrel-like distortion.

RIB: float assymY
Default: 0.0

Anamorphic Squeeze

Anamorphic lens squeeze. Values greater than one decrease the effect of the lens distortion in the X direction. Values less than one increase it.

RIB: float squeeze
Default: 1.0

Chromatic Aberration

Transverse

Transverse (or lateral) chromatic aberration. This specifies the magnification factors for the red, green, and blue primaries respectively. When unequal, this can produce a tinge which is most pronounced near the image edges. It will increase color noise, however.

RIB: color transverse
Default: 1.0 1.0 1.0

Axial

Axial (or longitudinal) chromatic aberration. This specifies the chromatic focal shift for the red, green, and blue primaries respectively. When unequal, this can produce a tinge on bokeh and out of focus objects. It will increase color noise, however.

RIB: color axial
Default: 0.0 0.0 0.0

Vignetting

Natural

Natural vignetting. When one, directions off of the primary camera axis will be darkened realistically. Wide-angle perspectives will show this effect more strongly. Setting to zero disables this and intermediate values will blend accordingly.

RIB: float natural
Default: 0.0

Optical

Optical vignetting. Simulates light blockage due to a hood or other additional lens elements. With depth of field enabled, this creates cat's eye bokeh. However, it also increases image noise.

RIB: float optical
Default: 0.0

Shutter

Sweep

Shutter direction. Specifies the direction that the shutter sweeps. The default, down, is the most common direction for rolling shutters.

  • down
  • right
  • up
  • left
RIB: string sweep
Default: "global"

Duration

Exposure duration. Zero means an ideal rolling shutter where each line is exposed instantaneously when read. The default, one, is equivalent to a global shutter where all lines are exposed and read at the same time.

RIB: float duration
Default: 1.0