Getting Started with Voxel Editing

This page introduces the basic editing workflow for voxel grids in Foxel.

Activate a Voxel Grid

Before you can edit voxels, the voxel grid of a Voxel Layer must be active.

An object is considered active when it is the only selected object or, if several objects are selected, the first selected object.
The active object is also the one shown in the Inspector.

You can activate a voxel grid in several ways:

• click a Voxel Layer in the Hierarchy
• activate a transform tool and click a Voxel Layer in the scene
• hold Ctrl and click a Voxel Layer in the scene while a voxel tool is active

When a voxel grid is active, its voxel outlines are shown in the workspace.

Note

The voxel data of a Voxel Reference cannot be edited directly. To change it, open and edit the source asset instead.

Understand Tools and Tool Modes

Editing in Foxel is based on two choices:

• the tool, which defines what you do
• the tool mode, which defines how the action is applied

For example:

• the Draw Tool creates voxels
• the Erase Tool removes voxels
• the Paint Tool assigns the active color
• the Material Tool assigns the active material

The selected mode then decides whether you edit a point, a rectangle, a box, a brush stroke, or a flood-filled region.

A Simple First Workflow

A good first exercise is:

1. Create or open a Voxel Layer.
2. Activate the voxel grid.
3. Choose the Draw Tool.
4. Choose Point Mode or Box Mode.
5. Draw a few voxels.
6. Switch to Erase Tool to remove unwanted parts.
7. Use Paint Tool or Material Tool to refine the result.

Useful Shortcuts

• Ctrl + click in the scene can activate a Voxel Layer while a voxel tool is active.
• Alt + click samples the clicked voxel's color and material.
• With transform tools, scene clicks can also be used to choose the object you want to work on.

Where to Go Next

• Read Voxel Tools for an overview of the available tools.
• Read Voxel Tool Modes to understand the different editing behaviors.
• Read Selection and Eyedropper when you want more control over existing voxel data.