Crop Generated Reference Data

All Voxel Reference types in Foxel share crop settings.

These settings let you limit the generated voxel grid after the reference result has been created. This makes cropping a different step from choosing a Scan Box.

Why This Matters

It is easy to confuse crop settings with Scan Boxes, but they control different stages of the workflow.

A Scan Box affects which part of the source asset is used.

Crop affects which part of the generated voxel result is kept.

Both can change the visible result, but they do not do the same thing.

Shared Voxel Reference Crop Settings

All Voxel Reference types share these properties:

• Crop
• Crop Box Position
• Crop Box Size

These settings apply to the generated voxel grid of the Reference.

They do not edit the source asset.

What Each Crop Setting Does

Crop

Crop enables cropping of the generated voxel grid.

When cropping is enabled, only the voxel data inside the crop region is kept.

Crop Box Position

Crop Box Position defines the position of the crop box inside the generated voxel grid.

Use this to move the crop region to the part of the generated result you want to keep.

Crop Box Size

Crop Box Size defines the size of the crop box.

Voxel data outside that crop region is excluded.

Use this to control how much of the generated voxel result remains visible and usable in the scene.

What Cropping Actually Affects

Cropping does not change the source asset itself.

It also does not change which part of the source asset was used for generation.

Instead, it limits the generated voxel data after the Reference result already exists.

That is why crop is best understood as a shaping step on the generated voxel grid.

Crop Versus Scan Box

The distinction between Crop and Scan Box is important.

Scan Box

A Scan Box defines which region of the source asset is used before voxelization or generation.

Use a Scan Box when the source region itself needs to be controlled.

Crop

Crop defines which region of the generated voxel grid is kept afterward.

Use Crop when the generated result should be trimmed inside the scene without changing the source setup.

A simple way to remember the difference is:

Scan Box = source region before generation
Crop = generated voxel region after generation

Why Cropping Is Useful

Cropping is useful when:

• The generated result is larger than needed.
• You want to trim the Reference result without changing the source setup.
• You want tighter control over the final voxel grid inside the scene.
• You only need part of the generated voxel data.
• You want to keep a Reference compact and focused.

Cropping is especially useful when the source asset should stay unchanged, but the scene only needs a smaller generated region.

What To Remember

• All Voxel References share crop settings.
• Crop enables cropping of the generated voxel grid.
• Crop Box Position controls where the crop box is placed.
• Crop Box Size controls how large the crop region is.
• Voxel data outside the crop region is excluded.
• Crop works on the generated result, not on the source asset.
• Scan Box controls the source region before generation.
• Crop controls the generated voxel region after generation.