RenderSettings

The RenderSettings node defines the 3D render output settings (camera to use, renderer, size of output image) for an image.

Connection Type

Connection Name

Function

Input

input

The place in the node graph where you want to define the 3D render output settings.

 

Control (UI)

Default Value

Function

cameraName

/root/world/cam/camera

Specifies the camera that the scene should be rendered through. The field contains a path to the camera's location in the scene graph. The cameraName parameter options are available by clicking the dropdown menu.

For more information, refer to the Scene Graph Location Widget Type in Common Parameter Widgets.

renderer

dl

Specifies the renderer to use.

resolution

512x512

Sets the size of the output image.

overscan

0

Pads the data window of the resulting render by the specified pixel amount on each side. The frame window is unchanged.

adjustScreenWindow

No adjustment

Adjusts the pixel aspect ratio to match one of the device aspect ratio's dimensions. Either the height or the width of the screen window is adjusted to match the output resolution.

maxTimeSamples

1

Sets how many times a point is sampled when the shutter is open. For animated parameters within Katana (such as transforms), this is how many samples are evaluated from shutter open to close. The higher the number, the more accurate the motion blur.

shutterOpen

0

Specifies the timing of the opening and closing of the camera shutter.

shutterClose

0

cropWindow

0.0, 1.0, 0.0, 1.0

Specifies the render crop window in normalized coordinates: xmin xmax ymin ymax, starting in the upper left-hand corner. The part of the image that renders has a dotted red line around it.

Note:  Note: The dotted red line isn't displayed unless you are viewing the RenderSettings node.

interactiveOutputs

all

Specifies whether all the AOVs are rendered during Preview Render, or whether only the primary pass is rendered. If you set the output to primary, the Local Assignment box turns yellow to indicate that you are using local values.

adjustScreenWindowWhen

deferred