V-Ray Frame Buffer | VFB

This page provides information on the V-Ray Frame Buffer and its features.

Section Contents

    Page Contents

    Overview

    The V-Ray Frame Buffer is a display window for V-Ray renderings that includes a number of V-Ray-specific features. While V-Ray can render to the 3ds Max Rendered Frame Window (RFW or VFB), the V-Ray Frame Buffer has some additional capabilities:

    • Switches between render elements via a dropdown of all render elements

    • Keeps the image in full 32-bit floating point format

    • Performs Color Corrections on the rendered image

    • Allows you to choose the order in which the buckets are rendered

    • Can store a list of recently rendered images and switch between them or compare them

    • Applies simple Lens Effects to the rendered image

    • Automatically adjusts render resolution when the VFB window is resized with V-Ray RT ActiveShade and V-Ray IPR

    • The ability to load progressive resumable files (.vrprog ) and the V-Ray .vrimg file format.

    To use the V-Ray Frame Buffer for rendering, turn on the Enable built-in frame buffer option in the Frame buffer rollout under the V-Ray tab in the Render Setup window.

    The V-Ray VFB can also be controlled with environment variables or MAXScript. See Controlling the VFB Programmatically for details.

    The V-Ray VFB also has some limitations which are listed in the Notes section below.

    images/plugins/servlet/confluence/placeholder/unknown-macro

    UI Paths:

    ||V-Ray Toolbar|| > Last VFB button

    images/download/attachments/13830823/max2016_vray34501_VFB_UIPath.png

    ||Render Setup window|| > V-Ray tab > Frame buffer rollout > Show last VFB button


    images/download/attachments/13830823/max2106_33004_VFB_renderSettingsFrameBuffer.png


    VFB Toolbar

    images/download/attachments/13830823/max35004_VFB_RenderElementDropdown_UI.png

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

    images/download/attachments/13830823/image2014-1-24_1_49_11.png

    This part of the toolbar sets the currently selected channel, as well as the preview mode. Choose which channels to see with the help of the buttons. You can also view the rendered image in monochromatic mode.

    images/download/attachments/13830823/Max2016_vray35501_VFB_RGBSwitch.png The RGB Button switches the current channel to RGB color by default. When effects are applied, such as the VRayDenoiser or Lens Effects, the button will toggle between the effectsResult channel and RGB color channel.

    images/download/attachments/13830823/image2014-1-24_1_49_24.png

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

    images/download/attachments/13830823/image2014-1-24_1_49_32.png

    Save all image channels to separate files – Saves all the render elements into separate files. (available from flyout)

    images/download/attachments/13830823/max2016_35_UI_VFB_SaveAllSingleFile.png

    Save all image channels to single file – Saves the image into a single file. If a multi-channel type file is used (.exr, .vrimg) all the render elements will be saved in the same file. (available from flyout)

    images/download/attachments/13830823/image2014-1-24_1_49_42.png

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

    images/download/attachments/13830823/max2016_vray35002%29_VFB_clipboard.png

    Copies the current channel to the clipboard.

    images/download/attachments/13830823/image2014-1-24_1_49_53.png

    Clears the contents of the frame buffer. Sometimes helpful when starting a new render to prevent confusion with the previous image.

    images/download/attachments/13830823/image2014-1-24_1_50_1.png

    Creates a 3ds Max virtual frame buffer copy of the current V-Ray frame buffer. You can turn this on and of on-the-fly while rendering.

    images/download/attachments/13830823/image2014-1-24_1_50_10.png

    Forces V-Ray to render the closest bucket found to the mouse pointer. Drag the mouse over the V-Ray frame buffer while rendering to see which buckets are rendered first. You can turn this on and off on-the-fly while rendering.

    images/download/attachments/13830823/image2014-1-24_1_50_20.png

    Allows you to render regions in the V-Ray VFB.

    images/download/attachments/13830823/image2014-1-24_1_50_27.png

    Links the V-Ray VFB to Pdplayer.

    images/download/attachments/13830823/max2016_vray30501_toolbar_startInteractive.png

    When V-Ray Adv is the production renderer, this will start IPR. When V-Ray RT is the production renderer, this will start an ActiveShade render. (If there are no pre-existing V-Ray RT ActiveShade settings, the ActiveShade render will use the current RT production render settings.)

    images/download/attachments/13830823/max2016_vray30501_toolbar_refreshInteractive.png

    Refreshes interactive rendering.

    images/download/attachments/13830823/image2014-1-24_1_53_0.png

    Stops the current rendering.

    images/download/attachments/13830823/image2014-1-24_1_51_15.png

    Repeat the last render.

    images/download/attachments/13830823/image2014-1-24_1_58_24.png

    Opens the Color Corrections window which lets you define color corrections of various color channels. Right-click to dock or undock it.

    images/download/attachments/13830823/image2014-1-24_1_58_39.png

    Forces color clamping in the V-Ray VFB. Click and hold left mouse button to display the clamped colors in the V-Ray VFB.

    images/download/attachments/13830823/image2014-1-24_1_59_22.png

    Permanently opens the info window which will give you information about the pixel you right-click the mouse pointer on. If you right-click the mouse pointer over a pixel without turning this setting on you will see the info dialog only while your mouse button is down.

    images/download/attachments/13830823/image2015-2-3_16_54_17.png

    Enables the White balance color correction.

    images/download/attachments/13830823/image2014-1-24_1_59_40.png

    Enables the Hue/Saturation/Lightness color corrections.

    images/download/attachments/13830823/image2014-1-24_1_59_56.png

    Enables the color balance color corrections.

    images/download/attachments/13830823/image2014-1-24_2_1_9.png

    Enables the levels color corrections.

    images/download/attachments/13830823/image2014-1-24_2_1_22.png

    Enables the curve color corrections.

    images/download/attachments/13830823/image2014-1-24_2_1_40.png

    Enables the exposure corrections.

    images/download/attachments/13830823/image2015-2-3_16_56_5.png

    Enables the usage of a background image.

    images/download/attachments/13830823/image2014-1-24_2_1_58.png

    Displays the image in sRGB color space. Click and hold the left mouse button to switch between sRGB color space and ICC.

    images/download/attachments/13830823/image2014-1-24_2_2_46.png

    Enables and disables the effect of the Look Up table loaded in the Color Corrections settings. Hold down to chose between LUT and OCIO color corrections.

    images/download/attachments/13830823/image2014-1-24_2_2_58.png

    Shows the V-Ray VFB history window. Right-click to dock or undock it.

    images/download/attachments/13830823/image2014-1-24_2_3_19.png

    Enables visualization the pixel aspect ratio.

    images/download/attachments/13830823/image2014-1-24_2_3_52.png

    Enables or disables stereoscopic preview. Click and hold down the left mouse button to pick between several stereoscopic modes.

    images/download/attachments/13830823/image2014-1-24_2_4_16.png

    Opens forth the Lens Effects controls. Right-click to dock or undock them.

    images/download/thumbnails/13830823/FrameBuffer_v04.png

    Opens the Messages window.

    Color Corrections

    The V-Ray VFB has a robust Color Corrections control (as seen in the image in the Overview) that is enabled with its icon (shown in the table above) which is in the lower left corner of the VFB window. Color Corrections include Exposure, Hue/Saturation, Curves, etc. and are all covered here.

    Render History

    The V-Ray VFB keeps a history of previously rendered images, and lists each with a number, thumbnail, and textual details in the Render history. This history can be accessed through the H icon at the bottom of the VFB window. The Render history can be docked to the VFB (as shown below) or can float separately. In addition to keeping history, this feature can display two images in the VFB for comparison (as shown below), which is revealed via a sliding division line. History files are stored as .vrimg files in a user-specified folder.

    images/download/attachments/13830823/max2016_3.45_VFB_Compare_AB.png
    VFB with docked Render history, comparing A and B images with vertical division line

    images/download/attachments/13830823/image2014-1-24_2_6_51.png

    Enables the V-Ray VFB history.

    images/download/attachments/13830823/image2014-1-24_2_7_13.png

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

    images/download/attachments/13830823/image2014-1-24_2_7_32.png

    Loads the image selected in the Render history to the VFB.

    images/download/attachments/13830823/image2014-1-24_2_7_43.png

    Removes the selected image from the Render history.

    images/download/attachments/13830823/image2014-1-24_2_8_1.png

    Sets the currently selected image as image A for A/B comparison in the VFB.

    images/download/attachments/13830823/image2014-1-24_2_8_16.png

    Sets the currently selected image as image B for A/B comparison in the VFB.

    images/download/attachments/13830823/image2014-1-24_1_53_50.png

    Swaps the A and B images.

    images/download/attachments/13830823/image2014-1-24_1_53_22.png

    Enables or disables the image comparison. Click and hold the button to switch between horizontal and vertical comparison.

    images/download/attachments/13830823/image2014-1-24_2_8_26.png

    Opens a menu with two options: History Settings and Dock History. The History Settings options opens a window for specifying the location for the history and turning on auto-save. The Dock History option docks or undocks the VFB history.

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

    Right-clicking on an image in the VFB history brings up a pop-up menu with some useful options:

    images/download/attachments/13830823/Renderhistory_RightClickSettings.png


    Edit comment – Allows you to add a text comment to the image; the comment appears in the "Details" column.

    Set A – Sets the image as the 'A' image when comparing two images.

    Set B – Sets the image as the 'B' image when comparing two images.

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

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

    Load V-Ray Settings – Sets the current render settings to the ones used to render the selected image.

    Compare V-Ray Settings – Shows a table with the differences between the settings used to render the selected image and ones currently set in the V-Ray renderer.

    Load Color Corrections – Loads the VFB color correction controls from the selected image.

    Reload History – Re-reads the history image list. This may be needed if the history folder is updated outside of 3ds Max (f.e. from another 3ds Max session).

    Stamp Tools

    images/download/attachments/13830823/2016_35_VFB_stampTools.png


    images/download/attachments/13830823/2016_32_VFB_showStampCtrls.png

    Toggles open Stamp Tools at the bottom of the VFB

    images/download/attachments/13830823/2016_32_VFB_applyStamp.png

    Applies a stamp with rendering metadata to the image

    images/download/attachments/13830823/2016_32_VFB_insertVariables.png

    Opens the Stamp Variables window to make it easy to copy different types of information onto the stamp

    images/download/attachments/13830823/2016_32_VFB_alignStamp.png

    Align stamp options; Click and hold to change from Left alignment to Right alignment or Center alignment

    images/download/attachments/13830823/2016_32_VFB_stampPlacement.png

    Change stamp placement from align Bottom to align Top

    images/download/attachments/13830823/2016_32_VFB_stampFont.png

    Choose Font window to change font, its style and size

    Stamp Variables

    Stamp variables can be typed directly into the stamp textbox with a % symbol before and separated with a | symbol. Example: %rendertime | %frame | %camera

    Alternatively, the Stamp variable window can be used to select/highlight variables and clip on the Copy to stamp button to add them to the stamp textbox

    Field

    Description

    vraycore

    Version of the V-Ray core

    rendertime

    The render time for the last completed frame

    vrayversion

    Internal V-Ray version

    filename

    Maya project file name

    frame

    Current frame number

    primitives

    Number of internal V-Ray primitives used in rendering

    computername

    The name of the computer this frame was rendered on

    date

    Date at the end of rendering

    time

    Time at the end of rendering

    w

    Width

    h

    Height

    ram

    Physical memory available (RAM)

    vmem

    Virtual memory available

    mhz

    The speed in Mhz of the CPUs

    cpu

    CPU type and number of CPUs available

    os

    OS version

    camera

    Camera name

    numPasses

    Sampling level reached: number of passes

    numSubdivs

    Sampling level reached: number of subdivs

    noiseThreshold

    Noise threshold reached (progressive sampler only)

    VFB Shortcuts

    These shortcuts navigate through the VFB image. Please note that VFB window must have the current focus for the shortcuts to have effect:

    Mouse

    Description

    CTRL+Left click, CTRL+Right click

    Zoom in/Zoom out

    Mouse wheel

    Zoom in/Zoom out

    Double-click left button

    Zoom to 100%

    Right click

    Show the info window with the properties of the last pixel clicked. To see the info non-stop, turn on the info button images/download/attachments/13830823/image2014-1-24_1_59_220.png

    Page Up/Page Down

    Switch between render elements

    Middle button dragging

    Pan (hand tool)

     

     

    Keyboard

    Description

    + / -

    Zoom in/Zoom out

    *

    Zoom to 100%

    Arrow keys

    Pan left, up, right, down

    1-9

    Load the respective image from the VFB history

    Ctrl+C

    Copy the VFB image to the Windows clipboard; the image is copied exactly as it appears on the screen (meaning sRGB/LUT/OCIO etc corrections are applied). The full resolution image is copied to the clipboard, even if the VFB view is zoomed in/out.

    Changing the Background Color

    To change the background color of the VFB, right-click on the background and select one of the options from the pop-up menu.

    images/download/attachments/13830823/FrameBuffer_bgColor6.png

    ActiveShade V-Ray RT Options

    When rendering with the VFB using V-Ray RT in Active shade mode, there are extra options available when you right-click on top of the render (clicking in the negative space around the render will bring up the background color options).

    images/download/attachments/13830823/ActiveShadeOptions_v01.png

    Real Zoom – When enabled, scrolling will not function in zooming the pixels of the rendered image but will move closer or further from the rendered geometry.

    View Navigation – Requires a camera view. Adjusts the view angle from the render in the VFB instead of in the viewport. Simply click and drag in the rendering area of the VFB window.

    Pause/Resume – Pause/resume rendering.

    Re-initialize – Restart rendering.

    Select object – Directly select scene objects by clicking on them in the VFB rendering area.

    Get object material – Pick a scene material from an object that is being rendered. You only need to click on that object in the VFB rendering area and the material editor will open with it.

    Set focus distance – Sets the target distance for the Depth of Field effect to the location clicked in the VFB rendering area.

    The Undo shortcut (Ctrl+Z) for these actions will not work within the VFB window. It only works when the focus is on the 3ds Max windows.


    Pixel info – Opens the standard V-Ray VFB pixel information window.

    images/download/attachments/13830823/Max_Pixel_Info.png

    Notes

    • The V-Ray VFB does not display the G-Buffer layers (like Coverage etc.)

    • The V-Ray VFB does not work with strip rendering

    • The V-Ray VFB does not work with rendering to fields

    • Even though you select the V-Ray VFB as your output, the 3ds Max VFB is still created and thus takes additional memory. If you want to reduce that memory, you need to uncheck the Get resolution from MAX option, set the 3ds Мax resolution to a low value like 100 x 100, and then select your real output resolution in the V-Ray VFB options.

    • If you have selected an output image file from the Common tab of the Render Scene dialog, V-Ray will fill out the 3ds Max RFW, and this will be saved as your image. If you want to save the V-Ray VFB instead, you should use the Split render channels or Render to V-Ray raw image file option of the V-Ray VFB.

    • The OpenEXR file format is an open file format for high dynamic range images originally developed by Industrial Light and Magic. The official site of the OpenEXR file format is http://www.openexr.com/

    • When using the ActiveShade RT right-click options, the primary 3ds Max window needs the cursor focus to use Ctrl+Z to Undo.

    • If Lens Effects or the VRayDenoiser render element are enabled, 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.