Versions Compared

Key

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

...

Section
Column
width50%

The V-Ray Frame Buffer (VFB) is a second-generation V-Ray virtual frame buffer.

VFB is much more than a render image holder. It provides a higher level of post-processing adjustments and the ability to modify your scene from inside the VFB. Here is a list of benefits you should know:


Fancy Bullets
typecircle
  • Image preview:
    Loads render
elements
  • channels via a dropdown list;
    Works with display corrections;
    Loads various 8-bit and 32-bit file formats, including V-Ray resumable files;
    Image comparison between 2 or 4 renders;
  • Image management:
    Keeps the rendered image in full 32-bit floating point format;
    Can store history of rendered images with their post-rendering corrections;
    Can save corrected output to various image formats;
  • Image editing and post-processing:
    Set Color Corrections for rendered image and its
elements
  • channels;
    Composite mode for Back to Beauty workflow including layers corrections;
    LightMix control on lights contribution in the rendered image;
  • Scene editing:
    Can modify actual light values by transferring updated intensity and color from LightMix mode;
    IPR camera navigation and focus control from inside VFB;
  • Render management:
    Denoiser control;
    Region rendering control and test resolution;
    Allows you to choose the order in which the buckets are rendered;
    Automatic render resolution adjustment in IPR when the VFB window is resized;



Column
width5%


Column
width45%

Image Removed
The V-Ray frame buffer with its render history and color correction windows docked

UI Path: ||Render Settings window|| > Common tab > Render View rollout

Image Removed

VFB Menu

Image Added


UI Path

...


Section
Column
width50%

||V-Ray menu|| > V-Ray Frame Buffer

The Frame Buffer automatically opens when you start a render with V-Ray.

Column
width5%


Column
width45%

Image Added




VFB Menu

...

The V-Ray Frame Buffer menu The V-Ray Frame Buffer menu holds the main frame buffer commands. Some of the options are also available in the VFB Toolbar for quick access.


Menu

Menu Options

File

Save current channel – Saves the currently loaded channel to an image file format.

Save all image channels to separate files – Saves all the render

elements Clear image – Clears the contents of the frame buffer.

channels to separate files.

Save all image channels to single file – Saves the image to a single multi-channel EXR or .vrimg file.

Load image – Opens an image file to be previewed in the V-Ray Frame Buffer.

Batch image processing – Allows processing of multiple .vrimg files with the same layer tree changes at the same time.

Batch Image Processing

Image Modified

Input folder – Specifies a path to load images from.

Output folder – Specifies a path for the output images.

Layer preset – Specifies a path to a layer tree corrections preset.

Output filenames suffix – Specifies the suffix added to the output image filenames.

Overwrite existing – Enables overwrite of existing files with the same name in the output folder.

Render

Start interactive rendering – Starts IPR.

Abort rendering – Stops the current rendering.

Render Starts rendering.

Image

Follow mouse – Renders the closest buckets found to the mouse pointer, when using the bucket image sampler. If the progressive sampler is used, V-Ray samples the closest pixels to the mouse pointer.

Follow mouse – Drag the mouse over the VFB while rendering to change what part of the image is sampled first;
Follow mouse (locked) – Locks the bucket (or sampling) starting point.

Copy current channel to clipboard – Copies the current channel to the clipboard. It can then be pasted wherever you need.

Duplicate to host frame buffer – Copies the currently loaded render from the VFB to the Cinema 4D Picture Viewer. 

Clear image – Clears the contents of the frame buffer. This is useful when starting a new render to prevent confusion with the previous image.

View

Display color space –Specifies the color space, in which the image is displayed.

None – Does not specify a color space;
sRGB – Displays the image in sRGB color space;
OCIO – Displays the image in a color space loaded from an OCIO configuration file;
ICC – Displays the image in a color space loaded from an ICC configuration file;
Gamma 2.2 – Displays the image in Gamma 2.2 color space.

Zoom VFB – Zooms in/out the rendered image in the VFB.

Zoom 50% – Zooms out to 50%;
Zoom 100% – Zooms to 100%. Alternatively, double-click in the VFB with the left mouse button;
Zoom 150% – Zooms in to 150%.
Zoom to fit – Zooms the current image to fit in the VFB. If Render Region is active – zooms to the region.

Channels – Chooses which channels to see.

View red channel – Displays the red channel;
View green channel – Displays the green channel;
View blue channel – Displays the blue channel;
Switch to alpha channel – Displays the alpha channel;
Monochromatic mode –Displays the image in monochromatic mode.

Test resolutionEnables test resolution in VFB. The submenu allows different percentages of the render resolution to be set as the test resolution. You can choose between 10%, 25%, 50%, 75%, 110%, 125% and 150%. Please note that this only affects V-Ray and does not affect the native Cinema 4D test resolution setting found under Cinema 4D's Render Settings.

Color clamping – Opens the color clamping submenu options:

Force color clamping – Forces color clamping;
View clamped colors – Displays the clamped colors.

Use pixel aspect – Enables visualization of the pixel aspect ratio.

Flip – Mirrors the image in the VFB. This is a view only option, the flipped image cannot be exported. This function is only active while holding the menu button or the hotkey for the corresponding type of flip. The effect does not interrupt interactive rendering.

Flip horizontally– Mirrors the image horizontally.

Flip vertically – Mirrors the image vertically.

Panorama View – Shows the image in 360° view.

Show History – Shows the History panel. 

Show Layers – Shows the Layers panel.

Options

VFB settings – Opens the VFB Settings window where you can adjusts settings for Render View, Render Region, History and Layers.

VFB Toolbar

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Specifies RGB values. Click on the arrow to open a context menu with the available option.

None – Does not specify the RGB value.
HSV – Specifies the Hue, Saturation and Value of the pixel under the current mouse position.
Web – Specifies the HEX of the pixel under the current mouse position.
8bit – Specifies the 8bit color palette of the pixel under the current mouse position.

...

Image Removed

...

Image Removed

...

Image Removed

...

Color clamping – Opens the color clamping submenu options:

Force color clamping – Forces color clamping;
View clamped colors – Displays the clamped colors.

Use pixel aspect – Enables visualization of the pixel aspect ratio.

Flip – Mirrors the image in the VFB. This is a view only option, the flipped image cannot be exported. This function is only active while holding the menu button or the hotkey for the corresponding type of flip. The effect does not interrupt interactive rendering.

Flip horizontally– Mirrors the image horizontally.

Flip vertically – Mirrors the image vertically.

Panorama View – Shows the image in 360° view.

Show History – Shows the History panel. 

Show Layers – Shows the Layers panel.

Options

VFB settings – Opens the VFB Settings window where you can adjusts settings for Render View, Render Region, History and Layers.


VFB Toolbar

...


Image Added

This dropdown gives access to render channels rendered for the scene. The selected render channel is displayed in the VFB. By default, the RGB color and Alpha render channels are available. Any additional render channels that have been added to the scene also appear in the drop-down.

Image Added

Displays the red channel.

Image Added

Displays the green channel.

Image Added

Displays the blue channel.

Image Added

Displays the Alpha channel.

Image Added

Saves the image to disk. Press and hold the icon to bring up the submenu:

Save current channel – Saves the current channel to an image file format;
Save all image channels to separate files – Saves all the render channels into separate files;
Save all image channels to single file – Saves the image into a single multi-channel EXR or .vrimg file.

Image Added

Clears the contents of the frame buffer. This is useful when starting a new render to prevent confusion with the previous image.

Image Added

Renders the closest buckets found to the mouse pointer, when using the bucket image sampler. If the progressive sampler is used, V-Ray samples the closest pixels to the mouse pointer. With this option enabled, you can right-click on the image and select Lock bucket starting point to lock the bucket (or sampling) starting point.

Image Added

Allows you to render regions in the VFB. See the Render Region section for more information.

Image Added

Starts IPR.

Image Added

Stops the current rendering.

Image Added

Starts a production render.


...

Bottom Toolbar


Image Added

Locks the mouse pointer coordinates and displays information for the selected pixel.

Image Added

Shows corrected colors.

Image Added

Shows the V-Ray log.

Image Added

Displays the coordinates of the mouse pointer.

Image Added

Specifies the sampled area size. Click on the arrow to open a context menu with the available sampled area sizes: 1x1, 3x3, 5x5, and 7x7.

Image Added

Specifies whether color and display corrections are applied (RGB) or not (Raw) when showing the sampled pixel values at the current mouse pointer position.

Image Added

Displays the RGB pixel values at the current mouse pointer position before applying any color corrections.

Image Added

Specifies RGB values. Click on the arrow to open a context menu with the available option.

None – Does not specify the RGB value.
HSV – Specifies the Hue, Saturation and Value of the pixel under the current mouse position.
Web – Specifies the HEX of the pixel under the current mouse position.
8bit – Specifies the 8bit color palette of the pixel under the current mouse position.


Image Added

Displays the Hue, Saturation and Value of the pixel under the current mouse position when HSV is selected.

Image Added

Displays the HEX of the pixel under the current mouse position when Web is selected.

Image Added

Displays the 8-bit color palette of the pixel under the current mouse position when 8bit is selected.


Render History

...

The V-Ray Frame Buffer keeps a history of previously rendered images and lists each with a number, thumbnail, and textual details in the Render history panel. Up to four images can be called from the history to be compared in the VFB (as shown in this section). History files are stored as .vrimg files in a user-specified folder. Render history settings can be configured in the VFB Settings window.


Section
Column
width30%


Column
width40%

Image Added

Column
width30%




Section
Column
width30%


Column
width40%

Image Added

Column
width30%




Image Added

Saves the current image from the VFB to the render history. The image is placed at the top of the render history list

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Save current channel – Saves the current channel to an image file format;
Save all image channels to separate files – Saves all the render elements into separate files;
Save all image channels to single file – Saves the image into a single multi-channel EXR or .vrimg file.

...

Image Removed

...

Image Removed

...

Image Removed

...

Enables/disables test resolution in the VFB. Press and hold to bring up the submenu to select the percentage of the render resolution to set as the test resolution.

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

...

Render History

...

.

Image Modified

Enables or disables image A/B vertical comparison. Select images A and B from the render history. You can switch between comparison modes by holding down on this button or by using the hotkeys.

Image Modified

Enables or disables image A/B horizontal comparison. Select images A and B from the render history. You can switch between comparison modes by holding down on this button or by using the hotkeys.

Image Modified

Enables or disables image A/B/C/D comparison. Select images A, B, C, and D from the render history. You can switch between comparison modes by holding down on this button or by using the hotkeys.

Image Removed

Saves the current image from the VFB to the render history. The image is placed at the top of the render history list.

Image Modified

Loads the selected image from the render history to the VFB.

Image Modified

Removes the selected image from the render history.

Image Modified

A search field where you can filter the images based on the scene paths and notes.
Section
Column
width62%
UI Text Box
typetip

The keyboard keys from 1 to 9 can be used to quickly load the first 9 images from the history to the VFB.

Edit note – Allows you to add a text comment to the image; the comment appears below the image.

Set A – Sets the render as A image for comparison.

Set B –  Sets the render as B image for comparison.

Load to VFB – Loads the selected image in the VFB (same as double-clicking on the image).

Delete – Deletes the selected image from history. The image is moved to the system's Recycle Bin and can be restored from there if needed.

Load layers – Loads the layer tree preset of the selected image.

Load V-Ray settings –  Loads the V-Ray settings used for the saved render.

Compare V-Ray settings – Opens the Compare V-Ray settings dialogue, where you can compare the render setups of saved renders.

Image Info – Opens a window containing detailed information about the image, including, but not limited to, Aperture, Camera Far and Near Range, File Path, V-Ray version, render time. Keep in mind that the camera values are saved in system units. Also, the vrayrevison info displayed in the list is not related to the saved .vrimg file but to the current V-Ray build installed for Cinema 4DBlender.

Copy scene pathCopies the full path to the scene.

Copy project pathCopies the full path to the project.

Upload image(s) to Chaos Collaboration – Uploads an image to Chaos Cloud Collaboration for sharing and commenting.

Reload history – ReReload history – Re-reads the history image list. This may be needed if the history folder is updated outside of Cinema 4DBlender (e.g. from another Cinema 4D Blender session).

UI Text Box
typeinfo

Manually saved .vrimg files can also be added to the History folder, but they need to be saved with all image channels in one .vrimg file to keep the complete image info.

Column
width5%


Column
width33%

...

The V-Ray Frame Buffer includes a suite of color corrections and tools for adjusting the imageimage-adjusting tools. The tools are added as layers and displayed in a layer tree. You can enable or disable a particular tool using the visibility icon () to the left of its name.

...

Section
Column
width55%

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

Folder – Allows grouping multiple layers;
Background – Adds a background color correction layer;
Render Element – Selects a render element channel 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 – A Lookup Table layer 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.

For more information, see the Layers page.

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 create layer.

Redo create layer.
Column
width5%


Column
width45%

...

Section
Column
width50%
CommandDescription
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.
New LayerCreates a new layer.
DuplicateDuplicates the selected layer.
Blend ModesSpecifies how the selected layer blends with the result from all layers below it. See the Layers page for more info on the types of Blend Modes.
Column
width5%


Column
width45%

...

These shortcuts navigate through the VFB image. You can also find them in the VFB Settings window. Please note that the VFB window must have the current focus for the shortcuts to have effect:

MouseDescription
Mouse wheelZoom in/Zoom out
Double-click left buttonZoom to 100%
Middle button draggingPan (hand tool)
Ctrl+Shift+Left clickZoom in the rendered image
Ctrl+Shift+Right clickZoom out the rendered image


KeyboardDescription
Ctrl+Shift+left click, + / =Zoom in
Ctrl+Shift+right click, -/_Zoom out
Double click, *Zoom to 100%
Arrow keysPan left, up, right, down
FFit region or whole image in the VFB
EscAbort render
QSet history A/B vertical compare mode
WSet history A/B horizontal compare mode
EEnable history A/B/C/D compare mode
1-9Load the respective image from the VFB history
HShow/hide history
Ctrl+LShow/hide the whole right panel
PShow/hide only layers of tree
LLocks the mouse pointer coordinates and displays information for the selected pixel, i.e. activates the Lock pixel info coordinates button.


Notes

...

Fancy Bullets
typecircle
  • VFB does not display display the G-Buffer layers (like Coverage etc.).
  • VFB does not work with strip rendering.
  • VFB does not work with rendering to fields.
  • The OpenEXR file format is an open file format for high dynamic range(HDR) images originally developed by Industrial Light and Magic. The official site of the OpenEXR file format is http://www.openexr.com/
  • If Lens Effects or the VRayDenoiser render element If Lens Effects or the V-Ray Denoiser render channel is enabled,  then then the RGB Color channel is saved with the name RGB_color and the effectsResult channel is saved as effectsResult when saving all channels from VFB.
  • If an 8-bit file is saved through the VFB or the Render Output / Save image settings, the color space (for example, sRGB) is embedded and the image appears as in the frame buffer when loaded in an external image viewer. If a 32-bit (exr, hdr, tif) image is saved, it remains linear and relies on the external image viewer to handle the display color space.