This page contains information on the Layers panel in V-Ray Frame Buffer.


Overview


The Layers panel in V-Ray Frame Buffer provides a new powerful workflow for making adjustments to your rendered image. You can bring out render elements and compose them together with individual color corrections in the panel's Composite mode, or deconstruct light contribution in the scene and fine-tune each light individually in the completed render using the VRayLightMix mode. You can also color correct the final render just like you were able to do in the previous version of VFB. For more information on how to work with the Layers, see VFB Composite courseware page.


 UI Path: ||V-Ray Frame Buffer|| > Layers




Layers Menu


Commands available for the Layers panel are located at the top of the panel. Press on the the icons to see the expanded list of commands for the stacked buttons.






Creates a layer. Multiple layers of the same type can be added.

Folder - Allows grouping multiple layers in folders. This is only available when the Source layer is set to Composite;
BackgroundAdds a background color correction layer;
Render element - Selects a render element from your image that you can use in compositing. This is only available when the Source layer is set to Composite;
Constant - Adds a solid color that can be used to achieve an effect on another layer (for example to multiply by the constant);
Exposure - Adds an Exposure color correction layer;
White Balance - Adds a White Balance color correction layer;
Hue/Saturation - Adds a Hue/Saturation color correction layer;
Color Balance - Adds a Color Balance color correction layer;
Curves – Adds a Curves color correction layer;
Lookup Table - Allows loading a LUT file for color transformations;
Filmic Tonemap – Contains different types of mapping curves and gamma corrections. Also allows selection of a color space.
Integer mask element – Mask is used with integer render elements like VRayRenderID, VRayObjectID, and VRayMtlID Render Elements.
MultiMatte mask element – Mask is based on the MultiMatte Render Element.
Cryptomatte mask element –  Mask 
is based on the VRayCryptyomatte Render Element.
Proportion Guide – Adds a grid proportion guide layer.

Deletes the selected layer(s).

Saves a layer tree preset.

Loads a layer tree preset.

Quick access to custom layer presets. You must set the path to it in the VFB Settings.

Undo various actions related to layers, such as create, delete, reorder, or modify a layer.

Redo various actions related to layers, such as create, delete, reorder, or modify a layer.


Context Menu

Command

Description

ResetResets all changes done to the selected layer.
SaveSaves the layer as a preset.
LoadLoads a preset for the selected layer.
DeleteDeletes the selected layer.
Save all CCs as LUTBakes all the color corrections to a LUT file (.cube). It can be used with RMB on a Display Correction layer and saves only the corrections in its section, but ignores their masks.
New LayerCreates a new layer.
DuplicateDuplicates the selected layer.
Blend ModesSpecifies how the selected layer blends with the result from all layers below it.

Color correction layers like Exposure and White Balance can be applied to a single layer instead of the entire composite.

You can do that by selecting a layer and then adding a new correction or by dragging the correction layer to another layer until an arrow icon appears.

The Stamp, Display CorrectionLens Effects, Sharpen/Blur, Denoiserand Source layers are listed in the Layers panel by default to any rendered image. Their order cannot be changed.

Layers can be disabled from the visibility icon (), reordered, nested, stacked in folders, etc.

Corrections are applied from the bottom to the top, except for nested layers, which are executed after their parent.

Color corrections and the denoiser channel are saved in the output image just like they are applied in the VFB.

Adjustments made to the Display Correction layer are only applied for preview purposes in the VFB. Display corrections are usually saved for 8-bit image formats like JPEG and PNG and not to EXR files, which are expected to be linear.

If you want to keep the layers that come with the Maya scene, turn the Auto Load Layers option off from VFB > Settings > History tab. If you want to load layers from an external image, enable the Auto Load Layers option and check how you save those images.

Blend modes


Layers are applied from the bottom to the top, where the bottom is the background (BG) and the top is the foreground (FG) of the composite.

Opacity – Controls the weight of the layer. A value of 0 means no effect and a value of 1.0 means full effect.

Blend Mode – Specifies how the layer blends with the result from all layers below it:


When adding a new layer, it is placed on top of the stack and it is considered the foreground (FG).

The result of all layers below it is considered the background (BG). Layers are applied from the bottom to the top.

Where darker and lighter pixels are mentioned below, it is in relation to mid-grey.



Blend Mode*Description
OverwriteDisplays the current layer (FG) on top of all layers (BG) without blending. This is the default.
AverageThe average of the current layer (FG) and the result from the layers below it (BG).
AddAdds the FG to the BG.
SubtractSubtracts the FG from the BG.
DarkenCompares the FG to the BG and takes the darker pixel values of the two.
MultiplyMultiplies the FG by the BG.
Color BurnThe color of the FG is applied to darker pixels in the BG.
Linear BurnSame as Color Burn but with less contrast.
LightenCompares the FG to the BG and takes the lighter of the two.
ScreenMakes both light and dark areas lighter.
Pin LightReplaces the BG colors depending on the brightness of the FG color.
If the FG color is lighter than mid-gray, BG colors darker than the FG color are replaced and vice versa.
DifferenceCompares the pixels in the BG and FG and subtracts the darker pixels from the brighter ones.
ExclusionSame as Difference but with less contrast.
HueUses the hue from the FG , while the value and saturation are taken from the BG.
SaturationUses the saturation from the FG, while the value and hue are taken from the BG.
ColorUses the hue and saturation from the FG, while the value is taken from the BG.
ValueUses the value from the FG, while the hue and saturation are taken from the BG.
Hard Mix (8bit)Adds the FG to the BG and for each color component returns a value of 255 if the result is 255 or greater, or returns 0 if the result is less than 255.
Color Dodge (8bit)The color of the FG is applied to lighter pixels in the BG.
Linear Dodge (8bit)Same as Color Dodge but with less contrast.
Spotlight (8bit)Same as Multiply, but with twice the brightness.
Spotlight Blend (8bit)Same as Spotlight, but additionally brightens the BG.
Overlay (8bit)Darker pixels become darker where the BG is dark and brighter pixels become brighter where the BG is bright.
Soft Light (8bit)Darker pixels become darker where the FG is dark and brighter pixels become brighter where the FG is bright.
Hard Light (8bit)Spotlight is applied to pixels where the FG is dark and Screen is applied to pixels where the FG is bright.

*  All 8-bit blend modes clamp colors to a maximum value of 1.0.


Stamp


The stamp layer can be used as a convenient way to add rendering metadata to the image (V-Ray version, render time, frame number, computer name, etc.). When enabled, it appears as a line of text and is always positioned on top of all other active layers. See also the Frame Stamp Parameters available in Render Settings > System.

Alignment – Specifies where to print the information. You can choose from Left, Right, or Center horizontal alignment, and Bottom or Top vertical alignment.

Color – Changes the stamp text color.

Font – Opens the Select Font window to change the font, style, and size of the text.

Variables – The stamp text to be printed. Can contain variables, that will be replaced by V-Ray with the corresponding value for each render. Type variables directly into the stamp textbox with a % symbol in front and separate them with a | symbol, or choose from the variables table below and use the Insert variable button. Example: %rendertime | %frame | %camera


Field

Description

vraycoreVersion of the V-Ray core
rendertimeThe render time for the last completed frame
vrayversionInternal V-Ray version
filenameMax project file name
frameCurrent frame number
primitivesNumber of internal V-Ray primitives used in rendering
computernameThe name of the computer this frame was rendered on
dateDate at the end of rendering
timeTime at the end of rendering
wWidth
hHeight
ramPhysical memory available (RAM)
vmemVirtual memory available
mhzThe speed in Mhz of the CPUs
cpuCPU type and number of CPUs available
osOS version
cameraCamera name
numPassesSampling level reached: number of passes
numSubdivsSampling level reached: number of subdivs
noiseThresholdNoise threshold reached (progressive sampler only)


Masks


The V-Ray Masks are used to refine only selected parts of the rendered image in the New VFB. They can be applied to Color correction layers, the Lens Effects layer, the Denoiser layer and also to Folders in the VFB layers tree.

When one or more masks are applied to the same folder or layer, a mask icon is placed in front of it in the layer tree to signify its presence. The parameters of each mask are available in their own separate tabs to the Properties of the masked layer or folder.

When a folder or a layer has mask(s), the Show masks' preview option is available in the Parameters Tab of the respective folder/color correction layer. This option shows a preview of the masks elements when selected.

For more information on masks, see the Masks page.




Display Correction


The Display Correction layer specifies the color space, in which the image is displayed. You can choose between sRGB, Gamma 2.2, OCIO and ICC or select None to return to a linear display.

The ICC correction allows you to apply an ICC profile to the image, so that (for example) it matches the appearance of the image in Adobe PhotoShop. This is a display correction that is only applied when the image is viewed in the frame buffer. It is not applied when the image is saved to a file.

The OCIO correction allows you to apply color corrections from an .ocio color profile to image colors. When this correction is enabled and no specific .ocio profile is specified, it attempts to read the OCIO environment variable and apply the profile specified in it.

Save RGB primaries conversion to image – This option affects only 32bit format images like .exr and .vrimg formats. For it to take effect, you should use sRGB Display Correction. When enabled, it converts the color space (RGB primaries conversion) set in the Color management to sRGB linear and save it to the output.


Normally you would specify the ICC file for your calibrated monitor here. Programs like PhotoShop display images using your (primary) monitor's ICC profile automatically. However (at least for the moment), Maya is not a color-managed application and you must manually load the monitor ICC profile into the V-Ray frame buffer in order to match the appearance of your images in PhotoShop.

The Display Correction layer cannot be removed or reordered. It is always applied on top of all other layers, as it specifies the display color space of the resulting image or composite in the frame buffer.

The Exposure slider in the Display Correction layer is only for display purposes and is not saved when writing to files.


OpenColorIO (OCIO)


Input color space – Specifies the input color space for the image; normally this is a linear color space as V-Ray internally works in that space.

Display Device – Specifies the device on which the VFB with the image is displayed.

View Transform – Specifies the viewing transformation.

Save in image – Saves/bakes the OCIO effect along with the image. This does not affect multi-channel images (such as multi-channel .exr).



ICC


ICC file – Specifies the full path to the ICC file.

Profile cached – When loading an ICC file, this checkbox indicates whether the file is smaller or bigger than a given threshold of 64k. If the file is smaller than 64k, the checkbox is enabled to indicate that the ICC file is directly embedded in the scene. If the loaded file is bigger than 64k, the checkbox is inactive, which indicates that you have to set the correct path to load it.

Rendering Intent – Specifies an ICC color replacement scheme. You can choose from PerpetualRelative colorimetricAbsolute colorimetric, and Saturation.

Back point compensation – Enables back point compensation.


Source


The Source layer determines the input of the layers stack. It specifies if you work on your rendered image, composite or light mix.

RGB - The rendered image is the source.

LightMix - This mode allows you to adjust the intensity and color of your lights during and after the render. Changes can be transferred back to the lights in the scene. To use the LightMix, add a VRayLightMix render element before rendering.

Composite - You can add Render element layers in this mode and start compositing your image from the render elements rendered with it. For example, you can do a simple Back to Beauty compositing of your image in this mode. See the VFB Composite courseware page for more information.



LightMix Mode


LightMix needs to be added to the render elements for this mode to be available. Alternatively, LightMix can be added inside the VFB. Click on the Add LightMix to the scene option. Start a new render to apply the changes.

When the Source is set to LightMix, you can enable/disable lights and adjust light intensity and color during and after the render. The modifications can be saved as light mix presets and reused. Start a new render and VRayLightMix automatically creates Environment and Self Illumination render elements. See the LightMix page and the VFB Light Mix courseware page for more information and examples.



Reset – Resets all changes made to default values.

Save – Saves the changes as light mix preset.

Load – Loads a light mix preset.

To scene – Applies the current VRayLightMix changes to the scene. This sends all changes to colors/intensities back to the scene lights.

To Composite – Sends the Light Selects from LightMix to Composite for additional post adjustments.

Recent – Shows a list of recent light mix presets.

Checkbox – Enables/Disables the selected light.

Multiplier – Specifies an intensity multiplier.

Color Slot – Specifies a color for the selected light.










Lens Effects


The Lens Effects layer simulates real-world camera lens effects such as bloom and glare. The plug-in uses a fast multi-threaded technique to compute the result and provide immediate update in V-Ray VFB. V-Ray Lens Effects are applied in the effectsResult channel together with other post effects executed over the RGB rendered image. See the Lens Effects page for more information on the individual parameters of this layer.



Background


This layer allows you add a background to your rendering.

Opacity – Controls the layer opacity.

Color – Picks a solid color to be used as background.

File – Loads a file that is going to be used as a background. Image sequences can be loaded as well using the <frameNum> tag.

Recent – Lists recently used files.

Stretch Controls the aspect ratio of the image by stretching the image to fit the VFB.

Fit Keeps the aspect ratio of the image. Enlarges or shrinks the VFB to fit the image.

Fill – Keeps the aspect ratio of the image and cuts some parts of the picture to fill the VFB.

Horizontal offset – Controls the background image position by the X axis.

Vertical offset – Controls the background image position by the Y axis.

As foreground – When enabled, the image loaded in the field above is used as a foreground. This means that the image is on top of the rendering and you are able to see the rendering only if the image has an alpha channel.

Save in image – When enabled, saves the layer to the image.

Color transformation – This dropdown allows display corrections to be applied to the Background layer independently.

Auto – Recognizes what the desired transformation would be based on the image suffix (_srgb, _lin_srgb, _acescg...) and sets those settings automatically.

Manual – Allows manual setup of the color transformation options. The options can be left at Auto and be determined automatically by V-Ray. The options can be set to None and apply no transformations.

RGB color space – Choose which color space to use for the color transformations. sRGB is the color space for most monitors and computer displays. ACEScg allows for greater range of color transformations in post. It has a wider gamut of colors than the sRGB linear gamut.

Transfer function – Alters the pixel values to a new range. Gamma 2.2 is the standard for most monitors.

OCIO – Allows an Input color space to be selected when an OCIO profile is already loaded. OCIO profiles can be loaded either through the Display Correction layer or through the OCIO environment variable.

Input color space – Determines the input color space for the background image; normally this is a linear color space as V-Ray internally works in that space.


MAYA2024_VRay6.2_Layers_Background_Params






You can add layers that affect only the Background layer by one of the following ways:

  • drag-n-drop
  • from the context menu of Background layer
  • from the Layer menu with the Background layer selected

Constant


This color correction applies a solid color that can be used as a constant to achieve an effect on another layer. For example, it can be multiplied by another layer.



Exposure


This color correction applies exposure and contrast to the image. An Exposure value of 0.0 leaves the original image brightness, +1.0 makes it twice as bright, and -1.0 makes it twice as dark. Highlight Burn selectively applies exposure corrections to highlights in the image. Positive Contrast values push the colors away from the medium gray value to increase image contrast, while negative values push the colors closer to medium grey.



White Balance


The White Balance sliders correct the colors in the image so that objects that are white appear as pure white (and not tinted blue, yellow, red, etc.) in the final image.

Temperature - Adjusts the white balance of the image by specifying the color temperature in Kelvin. Lower values make the image bluer, higher ones make it more amber.

Magenta - Green tint – Adjusts the white balance of the image to make it greener (negative values) or more purple (positive values).

Color tint – Picks or chooses a color to be the new "white point" for the image, adjusting all colors. Use it to pick a neutral color from the image (e.g. one that should be white or gray).

Render view color picker – Picks a color from the render window. Left-click to choose a new "white point" or a tint to neutralize. Right-click to pick a tint to boost.


Hue/Saturation


This correction applies HSL transformation on the image colors. Moving the Hue slider changes the overall hue of the image colors (grey colors remain intact). Lower Saturation values move the image towards greyscale while higher values increase the colors' intensities. Higher Lightness values add white to the image, whereas lower values subtract white from the image.



Color Balance


This correction adjusts the overall color tone of the image, as well as the tone of the dark (shadow), medium, and bright (highlight) colors. The color corrections are additive in that the All correction affects all colors of the image, and the Shadows/Midtones/Highlights options adjust the individual components in the image on top of the All correction.



Curves


This correction allows you remap the image colors with a Bezier curve. The control also allows you to save and load .acv curve files from Adobe PhotoShop.

Controlling the View

Use the mouse wheel to zoom in and out of the curve view. Drag with the middle mouse button to pan.

Controlling the Bezier Points

Click on a point to select it. Draw a rectangle to select multiple points at once. Click and drag on a selected point or its tangents to move them. To add a new point, Ctrl+click on the curve. To delete points, select them and press Del, or alternatively Shift+click on a point. Once a point is selected, you can also use the input coordinates field to modify its position. To display the input coordinates field, either press Enter or right-click on the point and then select Edit point.

Right-click on a point to bring up a context menu with additional options for that point.



 


Context Menu

Right-clicking in the curve view brings up a context menu with additional options:

Menu ItemDescription
Zoom allAdjust the curve view so that all points are visible.
Undo/RedoUndo and redo modifications to the curve.
LoadLoad the curve control from a file. Two formats are available: native .bcurve and PhotoShop .acv.
SaveSave the curve control to a file. Two formats are available: native .bcurve and PhotoShop .acv.
Reset MasterReset the curve control to its default state.
Select internal onlySelect only the points which are currently visible in the curve view.
Select allSelect all points.
Snap to gridToggle snapping to the curve grid. When enabled, moving points snaps them to the grid nodes.


When working with .acv files, some approximations are performed because the curves in the .acv files are described by a different mathematical formulas.

Lookup Table


This correction allows you to remap the image colors based on an IRIDAS .cube LUT (Look-Up Table) file.

Work in linear – The image is considered in linear color space.

Work in log – The image is converted to a logarithmic color space before applying the look-up table. Then it is converted back to linear color space.

Work in sRGB – The image is converted to a sRGB space before applying the look-up table. Then it is converted back to linear color space.

Save in image – Saves/bakes the LUT effect along with the image. This does not affect multi-channel images (such as multi-channel .exr).


Filmic Tonemap


This correction allows you to control different types of mapping curves, make gamma correction and select a color space. Note that color values are mapped per channel.

Tone mapping space – Specifies the color space where the operator is applied. Converts the image to the selected space and back, if needed. You can choose between Linear sRGB and ACEScg. For more information about ACEScg, visit the ACEScg Workflow Setup page.

Type – Specifies the type of curves used for the tone mapping. You can choose between Linear, Hejl-Dawson, AMPAS (ACEScg), Hable, and Power Curve.

Log space – Converts the image to log space before applying the tone mapping.

Gamma – Specifies the gamma correction. It is applied before the operator.

Use blue fix – Applies an additional transformation to ACEScg primitives that results in pure blues burning out through cyan instead of magenta. Available when Tone mapping space is set to ACEScg.

AMPAS (ACEScg)

AMPAS mode applies an approximate ACES standard curve.

Hejl-Dawson Type 

Shadows – Shadow compression. Higher values darken the shadows, while also brightening the mid tones.

Highlights – Highlight compression. Higher values reduce burnout.

Hable Type 

Shoulder strength – Determines how sharp the shoulder is. Higher values sharpen the shoulder, which results in an overall brighter image.

Linear strength – Determines the strength of the effect from changing Linear angle.

Linear angle – Determines the angle of the curve at the base. Higher values increase the angle.

Toe strength – Low to mid tone compression. Higher values darken the low and mid tones.

White point – The intensity, which gets mapped to 1. This parameter scales the whole curve evenly.

Power Curve Type 

Toe length – Determines the range of low to mid tones that are compressed.

Toe strength – Low to mid tone compression. Higher values darken the low and mid tones.

Contrast – Higher values increase the contrast between low and high tones.

Shoulder length – Determines the range of mid to high tones that are compressed.

Shoulder strength – Mid to high tone compression. Higher values darken the mid and high tones.

White point – The intensity, which gets mapped to 1. This parameter scales the whole curve evenly.





Example: Filmic Tonemap Layer


For the second image in the example below default values of the Filmic Tonemap layer are used. The type is the default Hable.







Example: Filmic Tonemap Types


Linear

Hejl-Dawson

AMPAS

Hable

Power Curve



ICC Profile



The ICC profile layer provides all options of the Display Correction ICC mode. On top of that, as a layer it can be blended with the other layers.

ICC file – Specifies the full path to the ICC file.

Profile cached – When loading an ICC file, this checkbox indicates whether the file is smaller or bigger than a given threshold of 64k. If the file is smaller than 64k, the checkbox is enabled to indicate that the ICC file is directly embedded in the scene. If the loaded file is bigger than 64k, the checkbox is inactive, which indicates that you have to set the correct path to load it.

Rendering Intent – Specifies an ICC color replacement scheme. You can choose from PerpetualRelative colorimetricAbsolute colorimetric, and Saturation.

Back point compensation – Enables back point compensation.


Sharpen/Blur


This corrections allows you to apply sharpen and blur to your rendered image, even at the same time, if needed.

Calculate Sharpen/Blur – Enables computation on the sharpen/blur post effect and automatically sets it visible when computed.

Sharpen amount – Applies sharpening to the image. Increasing the amount leads to a sharper image, while setting the amount to 0 switches off this filter.

Sharpen radius – Determines the radius in pixels used for sharpening. Higher values lead to more extensive sharpening.

Blur radius - Determines the radius in pixels used for blurring. Higher values lead to greater blurring effect.


 


Denoiser


This layer provides access to the VRayDenoiser render element (if available) from inside the VFB. To enable the layer, add a VRayDenoiser before rendering.
Alternatively, you can add a VRayDenoiser inside the VFB. Click on the Add Denoiser to the scene option. This option is active only when VRayDenoiser is unavailable. Start a new render to apply the changes.


Calculate denoiser – Enables/disables the denoiser calculation. This can be useful sometimes while adjusting your render. Disabling the denoiser layer visibility instead still calculates the denoiser in the background. Read more about this working with the denoiser on the V-Ray Denoiser page.

Update – Updates the Denoiser layer manually and also initiates a Lens Effects update.

Preset and Hardware acceleration are available for the Default V-Ray Denoiser only.

Preset – Offers presets to automatically set Strength and Radius values.

Default – Applies mid-level denoising.
Mild – Applies a more subtle level of denoising than the Default preset.
Strong – Applies a stronger level of denoising than the Default preset.
Custom – Allows the Strength and Radius parameters to be set to custom values.

Hardware accelerated – Uses the GPU device(s) to accelerate the denoising calculations. In case there is no compatible GPU device, denoising will automatically fall back to use the CPU, even if the option is enabled.  

Select Denoiser – Selects the Denoiser render element, displaying its attributes in the attribute editor.



Proportion Guide



This layer overlays a grid on top of the rendered image, allowing proper alignment of the objects in the scene. Similar to their use in photography, these grids are universal for setting up appealing images.


Note: Clicking on the  icon opens the Line Width and Color options, that allow you to determine the width and the color of the grid lines.


Rule of Thirds – Overlays the rendered image with a rule of thirds grid. This guide is used for placing the subject in either the left or right third of the image.

Diagonals – Overlays the rendered image with two diagonals.

Golden Ratio – Overlays the rendered image with a golden ratio grid to help achieve a more natural arrangement.

Center Cross – Overlays the rendered image with two perpendicular lines, that intersect at the center of the render.

Custom Grid – Overlays the rendered image with a custom grid. Clicking on the icon opens the Columns and Rows options that allow you to determine the number of columns and rows in the Custom Grid.


 

Notes


  • Color corrections in RGB mode are applied to all Beauty render elements and some Utility render elements too. They are not applied to render elements that present masks or hold geometry or computational data for the rendered frame.