This page provides information about the Preview tab of the V-Ray Volumetric Grid.


Page Contents ×


The parameters in this rollout control the representation of the cache files in the viewport. 





Detail Reduction | detailReduction – Decreases the grid and particle detail in the preview. A value of 0 means no reduction. Increase this value if the interface starts to lag due to the cache files being very large. This parameter controls both the viewport preview and the GPU preview.

Auto Reduction | viewAutoReduction – Enables automatic adjustment of the Detail Reduction parameter to improve display performance. The preview detail is reduced up to a point where the preview displays fast without blocking the interface. Note that the detail only decrease automatically, but does not increase.

Only if Selected | onlyIfSelected – When enabled, the contents of the cache file are only shown when the V-Ray Volume Grid is selected.

Active View Only | activeViewOnly – When enabled, the contents of the cache file are only shown in the active viewport.

Show Box | showGrid – When enabled, displays the Volume Grid's loaded cache bounding box in the viewport.

Graph Cells | showGridCells – When enabled and Show Box is enabled, displays a lattice with the cell sizes on the sides of the Volume Grid's box.

Mesh Preview



Show Mesh viewMesh – Turns the mesh preview on or off. This mode overrides the Voxel Preview mode. Note that if Render Mode is set to Ocean Mesh, the ocean has lower detail in the preview than in the render in order to speed up the viewport display.

Depth Sorting | viewMeshAlphaSort – When enabled, turns on precise mesh drawing when using transparency.

Color viewMeshColor – Specifies the color of the preview mesh.

Alpha | viewMeshAlphaSort – Specifies the alpha of the preview mesh, allowing transparent mesh preview.

Voxel Preview

The default preview mode that displays the individual content of each cell. All enabled channels are drawn if their content is between the corresponding thresholds.

Only the channels present in the cache file for the current frame and remapped to the corresponding Volume Grid native channel can be previewed. To see the list of available channels and their ranges, go to the Frame Info tab.

Only the Overlap Of | andReduction – When enabled, all channels in a cell must meet the selected threshold conditions to visualize the cell.

Temperature | viewTemp, viewTempColor, viewTempColor2, viewTempThreshold, viewTempThreshold2 – Enables the representation of the temperature.
Smoke | viewSmoke, viewSmokeColor, viewSmokeColor2, viewSmokeThreshold, viewSmokeThreshold2 – Enables the representation of the smoke.
Fuel | viewFuel, viewFuelColor, viewFuelColor2, viewFuelThreshold, viewFuelThreshold2 – Enables the representation of the fuel.
Viscosity | viewVisc, viewViscColor1, viewViscColor2, viewViscThreshold1, viewViscThreshold2 – Enables the representation of the viscosity.
Velocity | viewVel, viewVelColor, viewVelColor2, viewVelThreshold, viewVelThreshold2 – Enables the representation of the velocity.
RGB | viewUVW, viewUVWThreshold, viewUVWThreshold2 – Enables the representation of the RGB channel or the Wavelet channel, depending on which one is being used.

Auto Range | viewAutoRange – When enabled, automatically adjusts the preview ranges of visible channels for the current frame so that important data is always visible and the preview is always quick.

Slice Preview

The Slice preview displays only a single plane of voxels which can be convenient for debugging and fine-tuning a simulation.

Draw Just a Slice
 | viewSliceAxis – When enabled, only a voxel-thick cross-section of the grid becomes visible. This allows for a better view of occluded details and can help when previewing very rich data such as velocity fields.

Along X / Y / Z axis – Slices the grid along the specified axis.
 – Turns the Draw Just a Slice feature off.

Slice Level | viewSliceLevel – Specifies the offset of the slice from the bottom center of the grid in voxels.

GPU Shade Preview

Produces a render-like preview in the viewport calculated on the GPU. Note that the video card must support at least OpenGL 2.1. Known limitations:

  • Does not support textures
  • Ignores emissive lights
  • 8-bit color depth (but since the color is premultiplied with the alpha, the actual color range is bigger).

Note: The default rendering settings are not suitable for previewing liquids. First, you must disable Fire if there is no burning in the simulation. Second, enable Solid mode in the Extra Attributes, and set the proper Surface Level in the Surface section of the Rendering rollout. Finally, clicking the Reset button in the Smoke Opacity rollout sets up the right settings for the preview.


Enable gpuViewEnbl – Enables the GPU shading preview. Cannot be used with solid geometry.

Required GPU memory – Shows the approximate texture RAM that is used for the preview. Note that the GPU can allocate textures that exceed the available GPU memory but at the cost of speed. Also, there is no way to tell if the GPU can handle the texture without trying.

Diffuse Lighting | gpuViewLighting – When enabled, turns on the diffuse lighting.

Add Selected Lights to GPU Preview – When a light and a Volume Grid are selected, the selected light is added to the GPU preview. This button is a shortcut for adding the selected light to the Lights phxlight_set# which is automatically created with the Volume Grid. You could do this manually by Middle-Mouse-Button drag & drop of the light into the Lights set in the Outliner.

Lights | gpuViewLight – A set that specifies the exact lights used in the preview. If empty, the Maya viewport lights are used, which can be controlled by the viewport Lighting menu. You may need to select Use All Lights to enable the actual lighting. Note that V-Ray lights may not be used as Maya viewport lights and you should add them to the Lights set explicitly. If no lights are selected neither for the Maya viewport, nor added to the Lights set, the Volume Grid uses one default directional light.

Max Lights | gpuViewMaxLights – Sets the maximum number of lights used in the GPU preview. If there are more eligible lights depending on the conditions described in the Lights option above, only the closest lights to the Volume Grid are used, and the directional lights are always with lowest priority.

Ambient Lighting | gpuViewAmbient – When Diffuse Lighting is enabled, this specifies the color of the ambient light.

Background | gpuViewBackground – Specifies the background color when saving preview images in 24-bit format. This can be useful for programs that do not support premultiplied images.

Gamma gpuViewGammaEnbl, gpuViewGamma – Specifies the gamma for the GPU preview. Affects the viewport preview only.