Table of Contents

This page provides information about the V-Ray Frame Buffer settings.



The V-Ray Frame Buffer offers options to configure the Render View, Render Region, History, and Layers options. The settings mainly control visibility, location of stored renders and presets, amount of disk space to use and navigation within the VFB.


UI Path: ||V-Ray Frame Buffer|| > Options menu > VFB settings



Render View

The Render View tab controls zooming, panning and comparing of rendered images. Note that the Compare and Keyboard Pan options are available only when the Show Advanced Settings checkbox is selected.


Zoom Multiplier – Multiplies the zoom for one mouse click.

Outside Margin – The fraction of the displayed region allowed to be outside of the displayed image. Useful when panning the image while zoomed in.


Compare Fit Mode – Specifies how to fit the compared images when their resolutions are not the same. You can choose between HorizontalVertical and Center.

Split Hit Tolerance – Specifies a number of pixels around the split lines when deciding they are close enough to be dragged with the mouse.

Center zoom on Split Line – When enabled, zooming in/out, while in history compare mode, is centered around the split position(s).

Keyboard Pan

Use VFB 3.x keyboard pan – When enabled, keyboard pan is in image pixels. When disabled, keyboard pan is in fractions of the displayed image.

Keyboard pan display fraction – Specifies the number of pixels (or fraction of the image) to pan with the keyboard.

Keyboard pan shift multiplier – Specifies a multiplier for the pan amount when the Shift key is pressed.

Bucket outlines – Controls the appearance of buckets in VFB during rendering.

Different color by bucket – Each core from local rendering machine receives its own color for the bucket outlines and machine name. Each DR server will have its own single unique color for the markings.
White – All bucket outlines, names of DR servers and the local rendering machine are in white.
Black – All bucket outlines, names of DR servers and the local rendering machine are in black.
None – No bucket outlines and markings are displayed during rendering.


Render Region

This tab holds settings related to the Render Region in the VFB. Note that only the Show controls on hover only and the Show region sizes options are visible when the Show Advanced Settings checkbox is cleared.

Thickness – Controls the thickness of the render region hover controls.

Opacity – Adjusts the opacity of the region hover controls in a 0-255 range.

Distance – Specifies the distance between the region controls and the render region itself.

Hit Tolerance – Specifies how far (in pixels) away from the region controls the controls can be picked.

Corner Ratio – Determines the size of the corner controls of the render region. The value is calculated as a ratio of the region width to its height.

Middle Ratio – Controls the ratio of the side render region controls.

Move Ratio – Controls the move ratio of the render region controls.

Show controls on hover only – When enabled, controls are visible only when hovering over the render region. When disabled, the controls are always visible.

Move the region with the crosshair – Allows moving the region with the crosshair in its center. When disabled, the region is moved with the additional move controls that appear between the controls for resizing the region.

Fill rectangles – When enabled, the region controls have fill. Otherwise, the controls are only drawn as outlines.

Draw Outlines – When enabled, the region controls have outlines.

Show region sizes – When enabled, the size value of all four sides of the render region rectangle are visible.



The History tab controls the render history settings such as location, amount of disk space to use and visibility parameters. Note that the Font size and Background opacity sliders are only available when the Show Advanced Settings checkbox is selected.

Enabled – Enables/disables render history, where the VFB keeps a history of previously rendered images.


Use Project Path – This option is currently work in progress.

History Folder – Specifies the location where render history images are saved as V-Ray Image files (.vrimg).

Max Size on Disk (MBs) – Specifies the maximum amount of disk space to use for the render history images. When the history exceeds the specified amount, the oldest images are deleted.

Auto Save – When enabled, all rendered images are automatically saved to the history.

Auto Load Layers – When enabled, loading an image from history also loads the layer tree saved with the image.

Resize VFB on load – When enabled, the VFB is automatically resized to fit the loaded image.

Position and Thumbnail

Left/Bottom – Specifies the position of the Render History panel.

Min Thumbnail Width – Specifies the minimum width of the thumbnails in the Render History panel. You can additionally specify the image ratio for the thumbnails.

Center/Fit Inside/Fit Outside – Specifies how to fit the thumbnail in the History panel.

Info Font and Background

Font size - resolution and time – Specifies the font size of the resolution and time information on the thumbnail.

Font size - note – Specifies the font size of the notes on the thumbnails.

Font size - shortcut key – Specifies the font size of the 1-9 shortcut keys.

Background opacity - resolution and time – Specifies the opacity of the resolution and time background.

Background opacity - note – Specifies the opacity of the note background.

Background opacity - compare letter – Specifies the opacity of the compare letter background.

Show resolution/time – Specifies whether to show details about resolution and time of the rendered image. You can choose between NeverOn History HoverOn Image Hover, and Always

Show note/name – Specifies whether to show the name/note at the bottom of the thumbnail. You can choose between NeverOn History HoverOn Image Hover, and Always

Show shortcut key – Specifies whether to show shortcut keys on the rendered image thumbnail. You can choose between NeverOn History HoverOn Image Hover, and Always



The Layers tab specifies a location to store the layer tree presets.

Preset path – Shows the path where the layer tree presets are saved.

Browse for Layers path – Specifies a path to save the layer tree presets.

Recent – Shows a list of recently used locations for loading layer tree presets.