Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

Using the Image Layers group of attributes the user specifies one or several layers of images to output simultaneously from the rendering process.  Each can be set to be displayed on screen (in a window) or be saved to a file or both. By default, the Image Layers group of attributes is setup to output only one image layer: the RGBA components representing the main image, also commonly referred to as the Beauty. And it is setup to be outputted on screen.

It is possible to add any number of layers, each set to output any complementary values to the Beauty image. These are derived from variables computed inside shaders and are commonly called Arbitrary Output Variables (AOVs). Example of layers are: depth values associated to the Beauty image, original color of surfaces (without the effect of the lighting), the specular and diffuse shading components of the Beauty image. These layers can be useful for compositors to have many options while composing the final image. Refer to Supported AOVs for further details on supported AOVs.

Layers can not only be generated using different AOVs, they can also be generated from different camera angles. This is very powerful for fast simultaneous multi-camera rendering (for 3D stereo for example). Additionally, each layer can contain a different subset of the objects in the scene. These are more advanced options and are described in the Display Advanced Attributes.

Info

All the layers are rendered simultaneously. Adding many layers do not generally increase rendering time significantly. This is different and not to be confused with the 3Delight for Maya functionality of Render Passes. Those are processed sequentially and can produce totally different output from one pass to another.

 

The Image Layers group


Global Options


The first section of the Image Layers group controls default values and output behaviour for each image layers.

Default Image Filename

Specifies the default file location for the image layers. By default, the location is based on the scene name, the render pass name and the AOV name. See File Path Expressions for details on how it is possible to construct relative paths and paths containing dynamically expanded tokens.

 Default Image Format

Specifies the default file format for the image layers, including the bit depth. The default is 8-bit TIFF files. Many formats are supported and each have specific requirements as to what bit depths are supported. Refer to Image File Formats for more details.

 Batch Output Mode

Each image layer (AOV) have an output toggle controlling wether it should be saved to file (this is explained in details in the following section). Since these toggle may be manipulated frequently while working interactively and they may be forgotten in a OFF position while sending the rendering on a render farm using the Maya Batch command line, the Batch Output Mode controls wether these toggles should be ignored (overridden) when rendering in batch mode. This option is useful to make sure all image layers are saved when rendering using the Maya Batch command line, regardless of the status of the toggle. The options are:

 

Enable file output as selected
Indicates to output the image layer to file (in batch mode) only if the corresponding output toggle is selected. This is the default and it follows the same behaviour as in interactive mode.
Enable all file output and selected JPEG
___________________________________
Indicates to ignore (override) the output toggle and request that all image layers be saved to file when in batch mode. With regard to the automatically generated JPEG version, only those that are selected will be outputted to file (meaning the Batch Output Mode have no overriding effect to the JPEG output toggle and those are outputted only if enabled, wether in batch or interactive mode).

 

Interactive Output Mode

Each image layer (AOV) have a toggle controlling wether it should be saved on file or not  (this is explained in details in the following section). The Interactive Output Mode allows to globally control the behaviour of the output toggles. The options are:

 

Section
Column
width1%

 

Column
width99%
Enable file output as selected

Indicates to output the image layer to file (in interactive mode) only if the corresponding file output toggle is selected. This is the default behaviour.

Disable file output

Indicates to disable the output of the image layer to file (in interactive mode). Both the regular and JPEG file output toggles will be ignored. This is useful to work interactively only by looking at the image layers on screen and ignore the file output toggle (and possibly assigning them to be used mostly in batch mode).

Enable file output only for selected displays
______________________________________

This is an hybrid option. While working interactively, one may be interested to output to file only those image layers that he is actively working on; those that are selected to be displaying on screen. With this option, the image layers will be saved to file only if the display on screen toggle in selected.



 

List of Layers (AOVs)


By default, the list is populated with only one image layer, the RGBA ("Beauty") layer, and additional layers can be added. Each layer can be selected to be displayed on screen and/or be saved to file. They can be saved in the specified format and also simultaneously in JPEG (similar in concept to a digital camera where one can select to save a RAW image and/or a JPEG). The output for each layer is controlled using the the three toggles present at the beginning of each layer in the list:

 

Section
Column
width1%

 

Column
width99%

Enables the display of the image layer in a window on screen. The selection of which window (i.e. which application)
is not a rendering attributes but a user preference that can be specified in the The 3Delight Preferences.

Enables the output of the image layer to file (referred to as the standard file). The file location and format is specified
by the Default Image Filename and Default Image Format attributes unless overridden for that layer in the options listed
below the list of layers.

Enables the output of the image layer as a JPEG. The file location is the same as specified for the standard file,
only this time with the .jpg extension.

If all three toggles are selected, the image layer will be outputted simultaneously in a screen window, on file and as a jpeg. If none are selected, the image layer is inactive.

Below the list there are four buttons:

Add...

For adding layers. A separate dialogue will pop for selecting the AOV for that layer.

Warning

Note: There are currently a problem with that dialog: when selecting a new AOV in the AOV Selector and pressing OK, the ones already present in the list of Layer (AOV) are removed. As a temporary work around, simply make sure you select these AOVs you have already present in your list of layers (AOV) in the AOV Selector before you press OK. This way they will remain. (You can make multiple selections in the AOV Selector using the modifier keys).

 

Remove

Select a layer (AOV) in the list to remove it. Note that the RGBA ("Beauty") layer can not be removed.

Duplicate

Select a layer (AOV) in the list to duplicate it. You can then change some of the per layer attributes for the duplicated layer (otherwise you simply end up with exactly the same AOV without any differences to it).

View...

Select a layer (AOV) to view it. This opens the Image Filename for hat layer in a viewing application. Refer to The 3Delight Preferences for how to select which application should be launched.

 

Per Layer Attributes


When selecting a layer in the list of layers, the following list of attributes are available. These are per-layer attributes. Advanced collapsable layout. Refer to the Display Advanced Attributes for a description of these advanced attributes.

...