StandardOptions

Specifies the standard options (global settings) for the scene. These should be respected by all renderers.

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 processed output scene.

enabled

The on/off state of the node. When it is off, the node outputs the input scene unchanged.

in

The input scene

options

The options to be applied - arbitrary numbers of user defined options may be added as children of this plug via the user interface, or using the CompoundDataPlug API via python.

options.renderCamera

The primary camera to be used for rendering. If this is not specified, then a default orthographic camera positioned at the origin is used.

options.filmFit

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.

options.renderResolution

The resolution of the image to be rendered.

options.pixelAspectRatio

The width / height aspect ratio of the individual pixels in the rendered image.

options.resolutionMultiplier

Multiplies the resolution of the render by this amount.

options.renderCropWindow

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.

options.overscan

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.

options.overscanTop

The amount of overscan at the top of the image. Specified as a 0-1 proportion of the original image height.

options.overscanBottom

The amount of overscan at the bottom of the image. Specified as a 0-1 proportion of the original image height.

options.overscanLeft

The amount of overscan at the left of the image. Specified as a 0-1 proportion of the original image width.

options.overscanRight

The amount of overscan at the right of the image. Specified as a 0-1 proportion of the original image width.

options.depthOfField

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.

options.cameraBlur

Whether or not camera motion is taken into account in the renderered image. To specify the number of segments to use for camera motion, use a StandardAttributes node filtered for the camera.

options.transformBlur

Whether or not transform motion is taken into account in the renderered image. To specify the number of transform segments to use for each object in the scene, use a StandardAttributes node with appropriate filters.

options.deformationBlur

Whether or not deformation motion is taken into account in the renderered image. To specify the number of deformation segments to use for each object in the scene, use a StandardAttributes node with appropriate filters.

options.shutter

The interval over which the camera shutter is open. Measured in frames, and specified relative to the frame being rendered.

options.sampleMotion

Whether to actually render motion blur. Disabling this setting while motion blur is set up produces a render where there is no blur, but there is accurate motion information. Useful for rendering motion vector passes.

options.performanceMonitor

Enables a performance monitor and uses it to output statistics about scene generation performance.

extraOptions

An additional set of options to be added. Arbitrary numbers of options may be specified within a single IECore.CompoundObject, where each key/value pair in the object defines an option. This is convenient when using an expression to define the options and the option count might be dynamic. It can also be used to create options whose type cannot be handled by the options CompoundDataPlug.

If the same option is defined by both the options and the extraOptions plugs, then the value from the extraOptions is taken.