Skip to content

Nodes · 3D

VDBRead

3Dv1app

Overview

Reads a .vdb volume cache (smoke, clouds, fire from FX or a bought pack) into the scene as a standard UsdVol prim. Loads off-thread — the box draws dim while streaming, bright when ready. Rendering the volume itself lands with the volume pass; today you get the placed, pickable bounding box.

How to

How-to

  1. Set file (a smoke.####.vdb sequence resolves per frame) and the grid.
  2. Loads off-thread; the panel names the resolved frame and turns amber when it is missing.
  3. A VolumeShade sets the look.

Inputs

InputWhat it takes
inthe image this node works on

Outputs

OutputType
outScene

Parameters

ParameterTypeDefaultWhat it does
txFloat0.0Translate X — position along the world X axis, metres.
tyFloat0.0Translate Y — position along the world Y axis (up), metres.
tzFloat0.0Translate Z — position along the world Z axis, metres. The camera looks down −Z.
rxFloat0.0Rotate around X, degrees.
ryFloat0.0Rotate around Y (turntable), degrees.
rzFloat0.0Rotate around Z (roll), degrees.
sxFloat1.0Scale along X. 1 = unchanged.
syFloat1.0Scale along Y.
szFloat1.0Scale along Z.
fileTextThe .vdb on disk. Big caches stream in the background — the viewport never waits on this file.
gridTextdensityWhich grid (field) to read — 'density' in most smoke/cloud caches, 'temperature' for fire. Empty = the first float grid in the file.
emission_gridTextA companion grid of the same file that scales the emission (Houdini's flame or heat), the way its Pyro shader splits fire. Empty = the density scales it.
temperature_gridTextA companion grid a blackbody VolumeShade colours by (temperature). Empty = none.
unitsChoicevoxelWhat one unit of density means. world integrates per metre along the ray, as Houdini's renderers do; voxel per index voxel, the look older comps were made with. New nodes are created in world. voxelworld
firstInt0The clip's frame range on disk.
lastInt0The clip's frame range on disk.
beforeChoiceblackWhat plays outside the range: hold the end frame, loop, bounce, or black. holdloopbounceblack
afterChoiceblackWhat plays outside the range: hold the end frame, loop, bounce, or black. holdloopbounceblack
frame_modeChoicenoneWhere the cache sits in time, the Read node's meaning: none plays the file's own numbers; start_at slides the sequence so its first frame lands on start_at; offset adds frame_offset. nonestart_atoffset
start_atInt1The shot frame the sequence's first frame lands on when frame_mode is start_at.
frame_offsetInt0Frames added to the shot frame to find the file when frame_mode is offset.
disabledBoolfalseBypass: the node passes its first input through untouched (D in the graph). The knobs keep their values for when it comes back.
labelTextA note shown under the node in the graph — what this node is FOR. Never affects the render or the cache.
hide_inputBoolfalseDraw the node without its input wire — a tidy graph for a node whose source is obvious (a Dot, a viewer tap).

See also

  • The 3D system — How to put geometry, cameras and volumes in the comp — without becoming a 3D application.