PrmanRender

An optional camera input. The scene is rendered from the perspective of this camera. If the camera input is not connected, PrmanRender uses a default camera positioned at the origin and facing in the negative Z direction.

Either:

• A Scene node that is connected to the objects and lights you want to render, or

• a 3D object or MergeGeo node.

PrmanRender Tab

When enabled, add reflections to your render. You can adjust the parameters for your reflections using the Reflection node’s Properties panel.

When enabled, add refractions to your render. You can adjust the parameters for your refractions using the Refraction node’s Properties panel.

When enabled, add depth of field to your render.

Sets the projection mode during render:

• perspective - objects in front of the camera have the illusion of depth defined by the camera's focal-length and aperture.

• orthographic - objects are viewed using parallel projection.

• render camera - take the projection mode from the camera input.

Sets the number of pixels to render beyond the left/right and top/bottom of frame, if requested by subsequent operations.

Sets the global ambient light level.

Sampling Tab

Sets the maximum number of specular reflection and refraction bounces PrmanRender uses to trace your scene and make render calculations.

Sets the number of samples to render per pixel. Having more samples increases your render quality, but also increases render time.

NOTE:  Setting this value to 1 turns antialiasing off.

Sets the number of shading calculations for primitives. For example, a shading rate of 1.0 specifies one shading sample per pixel.

This value, along with pixel samples, directly affects your rendering time and the final quality of your results. A low shading rate value means your render will take more time, but the quality will be very high. A high value on the other hand means your render is faster, but the final quality will not be as good.

Select the filtering algorithm to use when remapping pixels from their original positions to new positions. This allows you to avoid problems with image quality, particularly in high contrast areas of the frame (where highly aliased, or jaggy, edges may appear if pixels are not filtered and retain their original values).

• Impulse - remapped pixels carry their original values.

• Cubic - remapped pixels receive some smoothing.

• Keys - remapped pixels receive some smoothing, plus minor sharpening (as shown by the negative -y portions of the curve).

• Simon - remapped pixels receive some smoothing, plus medium sharpening (as shown by the negative -y portions of the curve).

• Rifman - remapped pixels receive some smoothing, plus significant sharpening (as shown by the negative -y portions of the curve).

• Mitchell - remapped pixels receive some smoothing, plus blurring to hide pixelation.

• Parzen - remapped pixels receive the greatest smoothing of all filters.

• Notch - remapped pixels receive flat smoothing (which tends to hide moire patterns).

• Lanczos4, Lanczos6, and Sinc4 - remapped pixels receive sharpening which can be useful for scaling down. Lanczos4 provides the least sharpening and Sinc4 the most.

Sets the antialiasing method used to filter the pixel samples into the final color.

Sets the size of the antialiasing pixel filter to be used.

Sets the number of samples to render, per pixel, to produce motion blur. The maximum is 5.

This determines the number of samples of the 3D scene used so as low a value as possible is best for setup speed and memory use. If the motion in the scene over the shutter period is relatively linear, lower values can be used. If the motion is complex, then values toward the higher end of the range may be required.

If the rendered result shows banding or stepping that looks like too few motion blur samples, first try increasing the 'pixel samples' setting.

Sets the number of frames the shutter stays open when motion blurring. For example, a value of 0.5 corresponds to half a frame.

This value controls how the shutter behaves with respect to the current frame value. It has four options:

• centred - center the shutter around the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 29,5 to 30,5.

• start - open the shutter at the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 30 to 31.

• end - close the shutter at the current frame. For example, if you set the shutter value to 1 and your current frame is 30, the shutter stays open from frame 29 to 30.

• custom - open the shutter at the time you specify. In the field next to the dropdown menu, enter a value (in frames) you want to add to the current frame. To open the shutter before the current frame, enter a negative value. For example, a value of - 0.5 would open the shutter half a frame before the current frame.

If the shutter offset parameter is set to custom, this parameter is used to set the time that the shutter opens by adding it to the current frame. Values are in frames, so -0.5 would open the shutter half a frame before the current frame.

Adds randomness to the distribution of samples in time so they don’t produce regularly spaced images. The larger the value, the larger the time difference between the samples.

Sets the shutter opening mode:

• None - instantaneous open and close.

• Linear - the shutter opens and closes in linear intervals.

• Bezier - the shutter opens and closes more gradually, according to a Bezier curve.

Shader Tab

Sets the type of vectors you’d like to render:

• off - no motion vector information is rendered.

• velocity - store the velocity of every single pixel in the motion vector channels.

• distance - for every pixel, store the distance (in pixels) between samples in the motion vector channels.

When motion vectors is set to anything other than off, the selected vector type is written to this channel or channels.

When enabled, shader vectors are output as well as motion vectors.

When output vectors is enabled, the shader vector surface points are written to this channel or channels.

When output vectors is enabled, the shader vector surface normals are written to this channel or channels.

When enabled, filter the scene information generated by Nuke for RenderMan. Nuke then calls a Python function called nukescripts.renderman.filterRIB.

NOTE:  Filtering can make the render start up slightly slower as a temporary RIB file is created for each render.

When filter is enabled, specify your filter arguments. This string is passed by Nuke’s Python filter function as extra arguments to RenderMan. If you want to use your own filter, you can also replace Nuke’s Python function, and have your arguments passed directly to your own Python function.

For example, set the filter arguments to -rif myfilter.so to load your own RI filter.

ouput

Sets the RIB dump file path and name.

TIP:  For multiple frames use the #### pattern.

Click to dump RIB files for a given sequence the path specified in the file control.

NOTE:  You can execute from the command line using the -X nodeName switch.

These functions run prior to starting rendering in execute(). If they throw an exception, the render aborts.

These functions run prior to starting rendering of each individual frame. If they throw an exception, the render aborts.

These functions run after each frame is finished rendering. They are not called if the render aborts. If they throw an exception, the render aborts.

These functions run after rendering of all frames is finished. If they throw an error, the render aborts.