Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

perspectivecamera

This node defines a perspective camera. The canonical camera is viewing in the direction of the Z- axis. The node is usually connected into a transform node for camera placement. It has the following attributes:

NameTypeDefault
fovfloat

The field of view angle, in degrees.

NameTypeDefault
depthoffield.enableinteger0

Enables depth of field effect for this camera.

NameTypeDefault
depthoffield.fstopdouble

Relative aperture of the camera.

NameTypeDefault
depthoffield.focallengthdouble

Vertical focal length, in scene units, of the camera lens.

NameTypeDefault
depthoffield.focallengthratiodouble1

Ratio of vertical focal length to horizontal focal length. This is the squeeze ratio of an anamorphic lens.

NameTypeDefault
depthoffield.focaldistancedouble

Distance, in scene units, in front of the camera at which objects will be in focus.

NameTypeDefault
depthoffield.aperture.enableinteger0

By default, the renderer simulates a circular aperture for depth of field. Enable this feature to simulate aperture “blades” as on a real camera. This feature affects the look in out-of-focus regions of the image.

NameTypeDefault
depthoffield.aperture.sidesinteger5

Number of sides of the camera’s aperture. The minimum number of sides is 3.

NameTypeDefault
depthoffield.aperture.angledouble0

A rotation angle (in degrees) to be applied to the camera’s aperture, in the image plane.

NameTypeDefault
unitlengthmillimetersdouble

Physical length, in millimeters, of one scene unit. Since NSI only uses virtual scene units, this has no effect on the rendered images. However, this value can be useful if the renderer has to communicate with other software or file formats using physical units. For example, the focal length of the camera, expressed in millimeters, would be the product depthoffield.focallength * unitlengthmillimeters.