Camera
Produces scenes containing a camera. To choose which camera is used for rendering, use a StandardOptions node.
user
Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.
out
The output scene.
enabled
The on/off state of the node. When it is off, the node outputs an empty scene.
name
The name of the object in the output scene.
sets
A list of sets to include the object in. The names should be separated by spaces.
transform
The transform applied to the object.
projection
The base camera type.
Supports two standard projections: orthographic and perspective. For less standard projections that require renderer-specific implementations, such as spherical, you will need to use a downstream CameraTweaks node to adjust this camera’s parameters.
perspectiveMode
The input values to use in defining the perspective
projection. They can be either a horizontal field of view
(fieldOfView
), or a film back/sensor (aperture
) and
focal length (focalLength
). The latter two can take the
exact measurements from a real camera and lens setup. With
either perspective mode, perspective is stored as
aperture
and focalLength
parameters on the camera.
fieldOfView
The horizontal field of view, in degrees.
In the camera’s parameters, projection is always stored as
aperture
and focalLength
. When using the Field of
View perspective mode, the aperture has the fixed
dimensions of 1, 1
, and this plug drives the
focalLength
parameter.
apertureAspectRatio
The vertical field of view, according to the ratio
(horizontal FOV) / (vertical FOV)
. A value of 1 would
result in a square aperture, while a value of 1.778 would
result in a 16:9 aperture.
“Aperture” in this sense is equivalent to film back/sensor.
The final projection of a render using this camera will
depend on these settings in combination with the
resolution
and filmFit
render settings.
aperture
The width and height of the aperture when using the Aperture and Focal Length perspective mode. Use this in conjunction with a focal length to define the camera’s equivalent field of view.
“Aperture” here is equivalent to the film back/sensor on a real camera. A handful of default camera presets are provided, including Full Frame 35mm and several popular Alexa and RED bodies. Once the aperture is set, the focal length can then be adjusted on its own to control the field of view, just like on a real camera.
When setting the aperture manually, the x
and y
dimensions can be measured in any unit of length, so long
as they use the same unit as the focal length. You can
safely follow convention and use millimeters for both.
The final field of view of a render will depend on these
settings in combination with the resolution
and filmFit
render options.
focalLength
The focal length portion of the Aperture and Focal Length perspective mode. This is equivalent to the lens’s focal length in a real camera setup. Use this in conjunction with the aperture to set the camera’s equivalent field of view. Like on a real camera, the aperture is typically constant, and the focal length is then adjusted to control the field of view.
This can be a distance in any unit of length, as long as you use the same unit for the aperture. You can safely follow convention and use millimeters for both.
The final field of view of a render using this camera will
depend on these settings in combination with the
resolution
and filmFit
render options.
orthographicAperture
The width and height of the orthographic camera’s aperture, in world space units.
apertureOffset
Offsets the aperture parallel to the image plane, to achieve a skewed viewing frustum. The scale of the offset depends on the projection and perspective mode:
Perspective projection: - Field Of View mode: 1 offset = 1 horizontal field of view. - Aperture and Focal Length mode: 1 offset = 1 aperture unit of measure (for example, 1mm).
Orthographic projection: 1 offset = 1 world space unit.
For use in special cases, such as simulating a tilt-shift lens, rendering tiles for a large panorama, or matching a plate that has been asymmetrically cropped.
fStop
The setting equivalent to the f-number on a camera, which ultimately determines the strength of the depth of field blur. A lower value produces more blur. As in a real camera, fStop
is defined as focalLength / lens aperture
.
To enable depth of field blur (if your renderer supports it), give this plug a value greater than 0, and, on a downstream StandardOptions node, enable the Depth Of Field plug and turn it on.
focalLengthWorldScale
The scale to convert from focal length units to world space
units. Combined with f-stop to calculate the lens aperture.
Set this to scale the lens units into scene units, to
ensure the depth of field blur correctly scales to the
scene. Once this plug is set, the fStop
plug can be
adjusted to match a real-world lens setting.
For example, given a lens with a focal length in mm, and a scene that uses decimeters for its world space units, the Millimeters to Decimeters preset would provide the proper conversion.
The default value of 0.1 scales millimeter (default focal length unit) to centimeter (default world space unit of Alembic and USD scene formats). Other default presets for scaling to decimeter or meter are also available.
If using Field Of View projection mode, you won’t have a
focal length plug to work with, and the aperture size will
be (1,1). To compensate, select Custom and then input a
value that scales the scene unit of measure to a realistic
aperture size. For example, 3.5
would convert 1
centimeter (Alembic/USD default) to 35mm, which would
simulate a 35mm lens.
focusDistance
The distance from the camera at which objects are in perfect focus, in world space units.
clippingPlanes
The near and far clipping planes, defining a region of forward depth within which objects are visible to this camera.
renderSettingOverrides
Render settings specified here will override their corresponding global render options.
renderSettingOverrides.filmFit
Overrides the filmFit
render option:
How the aperture gate (the frame defined by the aperture) will fit into the resolution gate (the framed defined by the data window). Fitting is applied only if the respective aspect ratios of the aperture and the resolution are different. The following fitting modes are available:
Horizontal: The aperture gate will fit horizontally between the left/right edges of the resolution gate, while preserving its aspect ratio. If the aperture’s aspect ratio is larger than the resolution’s, the top/bottom edges of the aperture will be cropped. If it’s smaller, then the top/bottom edges will capture extra vertical scene content.
Vertical: The aperture gate will fit vertically between the top/bottom edges of the resolution gate, while preserving its aspect ratio. If the aperture’s aspect ratio is larger than the resolution’s, the left/right edges of the aperture will be cropped. If it’s smaller, then the left/right edges will capture more horizontal scene content.
Fit: The aperture gate will fit horizontally (like Horizontal mode) or vertically (like Vertical mode) inside the resolution gate to avoid cropping the aperture, while preserving its aspect ratio. If the two gates’ aspect ratios differ, the aperture will capture extra horizontal or vertical scene content.
Fill: The aperture gate will fill the resolution gate such that none of the aperture captures extra scene content, while preserving its aspect ratio. In other words, it will make the opposite choice of the Fit mode. If the two gates’ aspect ratios differ, the aperture will be horizontally or vertically cropped.
Distort: The aperture gate will match the size of the resolution gate. If their aspect ratios differ, the resulting image will appear vertically or horizontally stretched or squeezed.
renderSettingOverrides.shutter
Overrides the shutter
render option:
The interval over which the camera shutter is open. Measured in frames, and specified relative to the frame being rendered.
renderSettingOverrides.resolution
Overrides the renderResolution
render option:
The resolution of the image to be rendered.
renderSettingOverrides.pixelAspectRatio
Overrides the pixelAspectRatio
render option:
The width / height
aspect ratio of the individual pixels in
the rendered image.
renderSettingOverrides.resolutionMultiplier
Overrides the resolutionMultiplier
render option:
Multiplies the resolution of the render by this amount.
renderSettingOverrides.overscan
Overrides the overscan
render option:
Whether to enable overscan, which adds extra pixels to the sides of the rendered image.
Overscan can be useful when camera shake or blur will be added as a post-process. This plug just enables overscan as a whole – use the Overscan Top, Overscan Bottom, Overscan Left and Overscan Right plugs to specify the amount of overscan on each side of the image.
renderSettingOverrides.overscanLeft
Overrides the overscanLeft
render option:
The amount of overscan at the left of the image. Specified as a 0-1 proportion of the original image width.
renderSettingOverrides.overscanRight
Overrides the overscanRight
render option:
The amount of overscan at the right of the image. Specified as a 0-1 proportion of the original image width.
renderSettingOverrides.overscanTop
Overrides the overscanTop
render option:
The amount of overscan at the top of the image. Specified as a 0-1 proportion of the original image height.
renderSettingOverrides.overscanBottom
Overrides the overscanBottom
render option:
The amount of overscan at the bottom of the image. Specified as a 0-1 proportion of the original image height.
renderSettingOverrides.cropWindow
Overrides the renderCropWindow
render option:
Limits the render to a region of the image. The rendered image will have the same resolution as usual, but areas outside the crop will be rendered black. Coordinates range from (0,0) at the top-left of the image to (1,1) at the bottom-right. The crop window tool in the viewer may be used to set this interactively.
renderSettingOverrides.depthOfField
Overrides the depthOfField
render option:
Whether to render with depth of field. To ensure the effect is visible, you must also set an f-stop value greater than 0 on this camera.
visualiserAttributes
Attributes that affect the visualisation of this camera in the Viewer.
visualiserAttributes.scale
Scales non-geometric visualisations in the viewport to make them easier to work with.
visualiserAttributes.frustum
Controls whether the camera draws a visualisation of its frustum.