Voxel Tree, Numeric & Edit Node

A voxel scene is a tree of nodes: shapes, the shapes they add to or cut out of, and groups that hold them. Three windows let you work with that tree directly. The Voxel Tree lists every node and lets you hide, reorder, regroup, rename and delete them. The Numeric window shows the selected node's numbers so you can type exact values. Edit Node holds a node's name, blend and material. Open the first two from Window → Voxel Tree and Window → Numeric; both are listed in every mode and both can be docked. Edit Node opens from a row of the tree.

The Voxel Tree

Each row is one node, indented under the node it belongs to. Order and nesting matter: a shape set to add joins everything under it, and a shape set to subtract cuts only what is under it — nothing beside or above it is affected. Until you add a shape from the Voxel palette the window just says so.

From left to right, a row has these parts:

Control	What it does
Pen	Opens Edit Node on this row. It does not change the selection, so the gizmo stays where it was.
Eye	Hides the node and everything under it; click again to show it.
Caret	Folds or unfolds what is under the node. On a node with linked mirrored copies, it also hides or shows those copies, even though they sit beside it rather than under it.
Name	Click to select, Shift-click to add the node to the selection or take it out again, Ctrl-click to open Edit Node, double-click to rename. Drag it to move the node (see below). Hover it to see how much memory it holds, and how much with everything under it.
Add / Subtract / Intersect	Shown on shapes only. Each click moves to the next operation: Add joins the shape to everything under it, Subtract cuts it out of everything under it, Intersect keeps only where the shape and everything under it overlap. A group has no solid of its own, so it has no button here.
Bin	Deletes the node and everything under it.

What the name shows

A row's name carries some extra information, so you can read the scene without opening anything:

• A coloured dot at the left edge is the colour of the node's material, whether it is the node's own or one it inherits. Rows with the same dot share a material.
• A tag after the name says what kind of node it is: [group], [curve], [flattened], [clone] and [mirror] for live copies, or the deform a group applies: [twist], [bend], [taper], [shear], [rotate] or [drag net].
• A warning sign before the name marks a curve or free-form outline that has not been flattened yet, so unfinished work is easy to spot.
• A lock at the right shows a locked node (closed) or a deform group that is not locked yet (open). Click the lock to lock or unlock the node.
• A gauge marks a node that takes most of the exact preview's time. Right-click it and choose Flatten to make it cheaper.
• A link marks every member of a linked mirror group, the source and its copies alike: they change together.

At the foot of the window, Scene memory: shows what the whole voxel scene holds in memory. Flattened shapes are nearly all of it.

Live copies

The copies a clone or a reflection makes are listed so you can see them, but they are rebuilt from the node that owns them, so they cannot be edited on their own: their pen and eye are greyed, and their right-click menu only says A live copy: edit the original and it follows. To edit the copies one by one, right-click the original and choose Deactivate (keep the copies).

The right-click menu

Right-click a row's name for the commands that act on that node. Some only appear when they apply.

Command	What it does
Deactivate (keep the copies)	Only on a node with live clones or reflections. Turns them into ordinary nodes beside it, where they are; they stop following it and can be edited separately.
Edit Node	Opens the Edit Node window on this node.
Rename	Turns the name into a text field. Press Enter or click away to keep the new name; an empty name is ignored.
Duplicate Node	Makes a copy of the node and selects the copy.
Freeze Curve	Curves only. Keeps the solid the curve made and removes the curve and its cross-section, so it can no longer be reshaped. Greyed until the curve has a cross-section.
Lock / Unlock	A locked node can only be placed: nothing moves into or out of it, and what it holds is no longer listed, so it shows as a single row. If something inside it was selected, the selection moves to the locked node.
Flatten / Flatten Selected	Bakes the node and everything under it — or, when the row is part of a larger selection, all the selected nodes — into one object. The tooltip shows the bake's sample count and memory first. The parts are gone for good, though Undo still takes it back.
Send to Sculpt / Send Selected to Sculpt	Makes a sculptable mesh of the node — each shape or group its own mesh in the Sculpt Tree; the shapes stay here too. It first asks for Max polygons: the dialog says how many polygons the send would make at the sculpt's detail, and over your limit the shapes are meshed at a coarser detail (still an even mesh of quads). The limit you set is offered next time; 0 is no limit.
Remesh	On a flattened object: bakes it again at the current resolution. Detail an earlier, coarser bake lost does not come back.
Delete Node	Deletes the node and everything under it.

Moving nodes by dragging

Drag a row's name onto another row. Where you drop decides what happens:

• The top third of the target row puts the node just above it, beside it in the same parent.
• The middle puts the node inside it, as its child.
• The bottom third puts the node just below it.

To take a node out of every group, drop it on the empty strip under the last row, marked Drop here to move a node back to the top level. Nothing can be dropped inside a locked node, and a linked mirror group always moves as one block, so it is never split up or dropped into the middle of another one.

Group and Ungroup

Group and Ungroup sit near the foot of the Voxel sidebar. A group is a place to hang things: it has no solid of its own, and grouping moves nothing and changes nothing about the form.

Control	What it does
Group	Wraps the selected nodes in a new group, which becomes the selection. Select two or more nodes — shift-click — to group them. They must sit under the same parent; otherwise the status bar says the group was refused.
Ungroup	Select a group first. Dissolves it and puts its children back where they are now. Only a group can be ungrouped — a shape's children are what it adds to or cuts out of, so dissolving it would change the form — and an empty group has nothing to ungroup.

The Numeric window

Numeric shows the numbers of the selected node — the active one, if several are selected. Its title names the tool in use, for example Numeric - Move. With nothing selected it asks you to select a node in the Voxel Tree; while you are drawing a new shape it says to drag in a Top, Front or Side view, and then shows the draft's numbers. Tools such as Twist, Bend, Mirror, Mask or the sculpt brushes show their own settings here too; those are covered on their own pages.

For a selected node it has two pages:

• While Move, Rotate or Scale is engaged, it shows that tool's three values, the tool's falloff, and Apply. The heading reads the node's name followed by the tool and whether the values are world, local or relative.
• With no transform tool engaged, it shows the shape's own settings. The heading reads the node's name and its kind, such as Box or group.

While you draw a new shape, Position, Size and Rotation all show at once, since the shape is being placed, sized and turned in one go.

Position, Size and Rotation

Each set folds behind a chevron and stays closed until you open it. Every row is an axis button followed by a field.

Control	What it does
Position (X, Y, Z)	Where the node sits. In relative mode, how far it has moved since the drag began.
Size (X, Y, Z)	The node's dimensions. In relative mode, a percentage of the size it had when the gesture began, so 100% means unchanged. A group's size is the size of what is under it, and typing a new one scales everything inside to fit. An empty group has no size. A locked node keeps its size, so this set is hidden for it.
Rotation (H, P, B)	Heading, pitch and bank in degrees. In relative mode, the turn since the drag began.
Axis button	Locks that axis: the gizmo drops its handle, the axis stops moving and the field greys out. Click again to free it.
Apply	Finishes the edit and puts the Move, Rotate or Scale tool away. Return does the same.

Typing values

The fields are text fields. Type a value with or without a unit (25 mm, 2'5"), or simple math worked left to right (1 m + 500 cm / 2, 90 + 45 / 3). A number on its own is read in the unit chosen in the Voxel sidebar's Units row. The value takes effect when you leave the field; text that cannot be read is dropped and the field goes back to its old value. Beside each field is the stepping control chosen under Numerical sliders: in Settings > Interface.

Snap step

The snap lives beside Units in the Voxel sidebar: a checkbox to turn snapping on and a step field, greyed while snapping is off. Move, Rotate and Scale each remember their own setting. For Move and Scale the step is one length for all three axes; for Rotate it is the rotation snap step, in degrees. With snapping on, typed values are rounded to the step and the field's step buttons move by it, so typing can never put a node somewhere the gizmo could not. A size shown as a percentage in relative mode is not snapped.

The shape's own settings

With no transform tool engaged, Numeric shows what a shape has beyond its size. A value lands when you leave its field.

Shape	Settings
Box	Corner radius, with Chamfer for a straight 45-degree bevel instead of a round.
Round Cone	Depth: how deep it is front to back, as a percentage of its width. 100% is round.
Cylinder	Soft Rims with a Rim radius (and Chamfer); Wall makes a hollow tube open at both ends, with a Wall thickness.
Prism	The number of sides (3 to 64) and X, Y or Z buttons for which way the flat top and bottom face.
Torus	Start angle and End angle, Diameter and Tube diameter, Ring sides and Tube sides (3 to 16, or Round), Ring rotation, Tube rotation, Outer corners, Inner corners and Tube twist (turns). The last five are greyed until the ring or tube has sides.
Gear	Axis, Number of teeth, Inner radius, Taper %, Outer radius, Thickness, Smooth teeth, and Center hole with a Hole diameter.

Other shapes have nothing to set beyond their size, and the window says so. A flattened shape has no settings of its own either; it shows its sample count and memory instead, and you place and size it with Move, Rotate and Scale. A locked node notes that only its placement can change, and a deform group shows the amount it applies.

The Edit Node window

Open it with a row's pen, by Ctrl-clicking the row's name, or with Edit Node in the right-click menu. It floats over the viewport rather than docking, and it follows the selection: select another node, in the tree or the viewport, and it shows that one. Clicking on empty space leaves it where it is, and it closes by itself if its node is deleted.

Control	What it does
Name	The node's name, as shown in the tree.
Blend	Rounds the joint where this node meets what it touches — both its own children and its siblings. Zero leaves a hard crease. The unit is shown beside the label.
Material colour swatch	The colour of the node's material. A material is shared, so changing it recolours every node using it. A node with no material of its own gets a new one the first time you change the colour, rather than recolouring the parent it inherits from.
Material dropdown	Picks one of the scene's materials, or (none). A node using its parent's material shows (from parent) and the material's name.
New	Creates a new material for this node, starting from the colour it shows now, and lets you name it. Press Enter to keep the name.
Colored Cuts	Only for a node set to subtract. On: the faces it cuts take its colour. Off: they keep the colour of what was cut.
Uncuttable	Nothing can cut into this node or anything under it: a subtract passing through it leaves it whole.