Skip to main content

The Viewer

Double-click a VDBST or SVT in the Content Browser. The viewer opens with the settings panel on the left and a raymarched preview on the right.

The VDB Studio viewer with numbered areas

The viewer is a preview renderer with its own look. It renders independently of any level, so you can judge a volume without building a scene. Settings are stored on the asset as you change them; save the asset to keep them.

#ControlPurpose
1SAVE PRESETSaves the look. LOAD PRESET is beside it.
2CREATE / UPDATE MATERIALGenerates or rebuilds the volume's material.
3Bake buttonsCompute data for the level. See Lighting and Shadows.
4Sparse Volume Texture InfoResolution, memory and channels of the asset. Click it to expand.
5SearchFilters the settings by name.
7LODResolution level sampled.
8RayMarchingRender quality against speed.
9ViewExposure, tonemapper, background.
10ShowBounding box, grid, checker, up axis.
11RealtimeRuns a clock for animated micro detail.
12FPSFrame rate and render statistics.
13Smooth PlaybackStreams without waiting (SVT).
14FlipbookRecords a flipbook texture.
15PlayStarts and pauses the sequence.
16TimelineScrubs through frames.
17Frame counterCurrent and last frame.
18FPS fieldPlayback rate.
19Frame BlendingInterpolates between frames.
20LoopRepeats the sequence.

Sparse Volume Texture Info expanded

InputAction
Left mouse dragOrbit
Middle or right mouse dragPan
Mouse wheelZoom
FFrame the volume
Hold L + left mouse dragRotate the light

Playback​

Press Play (15) or drag the timeline (16). The FPS field (18) sets the playback rate, independent of the rate the sequence was exported at. Frame Blending (19) is covered in Playback and Frame Blending.

A fire playing in the viewer

While paused, the image keeps refining until it is clean. Any camera or setting change restarts that refinement.

Toolbar menus​

RayMarching (8), View (9) and Show (10) open drop-down panels of settings. The numbers on each panel match the tables in the Viewer Settings reference.

The RayMarching menu

The View menu

The Show menu

The defaults suit most volumes. Step Size is the first control to raise if the viewer is slow, and Max Accumulated Samples the first to raise if the paused image stays noisy.

Matching a level​

Set View > Tonemapper to Unreal to match a level that uses Manual exposure with Apply Physical Camera Exposure off and Exposure Compensation 0. Exposure 1 corresponds to that level. Use ACES 1.0 SDR (OCIO) to match a level viewed through an OpenColorIO transform.

Tonemappers compared

Settings panel​

The buttons at the top save presets, generate materials and run bakes. The categories below hold every look control, numbered in the order you normally work through them. The next page goes through them.