Create voxel stack
create_voxel_stackBuild a voxel stack visualization driven by any TOP: luminance sets column height and per-instance color, with isometric or perspective camera.
Instructions
Isometric voxel-stack renderer driven by any TOP. Builds a single instanced Geometry COMP (boxSOP, N=cols·rows instances up to 256×256) with a CHOP chain sampling luminance for column height and per-instance color. Color modes: source_color (sample TOP directly), palette (Monument-Valley pastel ramp), height_ramp (same palette, height-based). Isometric ortho cam (rx=-35.264°, ry=45°) by default; perspective available. Exposes HeightScale, VoxelSize, and RotateY controls. If source_top_path is omitted, an animated noiseTOP drives the stack.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| parent_path | No | Parent network where the voxel stack container is created. | /project1 |
| name | No | Base name for the container (defaults to 'voxel_stack'). | |
| source_top_path | No | Path to an existing TOP that drives heights and colors. If omitted, a built-in animated noiseTOP feeds the stack. | |
| grid_size | No | Voxel grid cols × rows. Hard-capped at 256×256 (65k instances). | |
| voxel_size | No | Cube edge length in world units; also the XZ spacing between voxels. | |
| height_scale | No | Multiplier on luminance → Y translate. 0 = flat slab. | |
| color_mode | No | Per-instance color: sample source TOP directly (source_color), look up into a palette ramp (palette), or use a default pastel height ramp (height_ramp). | source_color |
| palette | No | Ramp endpoints as [r,g,b] tuples (2–8 stops). Used only when color_mode='palette'. Defaults to a Monument-Valley pastel 5-stop ramp. | |
| output_resolution | No | Render TOP resolution [width, height]. | |
| camera_mode | No | Isometric uses ortho camera at rx=-35.264°, ry=45° (classic iso). Perspective uses a standard 35mm orbit cam. | isometric |
| expose_controls | No | When true, expose HeightScale, RotateY, and VoxelSize knobs on the container. |