References

Reference objects use data from other assets.

Foxel provides two reference categories:

• Voxel References
• Pixel References

A voxel object can be either a Voxel Layer or a Voxel Reference. A pixel object can be either a Pixel Layer or a Pixel Reference. Use the broader terms only when a concept applies to both.

Voxel References

Voxel References load data from other assets and display the result as voxel data inside a Voxel Scene.

Depending on the reference type, the source data may be scanned, converted, or voxelized before it is displayed.

Voxel References can also be transformed at the grid level, for example by rotating, flipping, or cropping the generated voxel data.

Scene Reference

A Scene Reference loads voxel data from another Voxel Scene.

The voxel data is generated by scanning a region of the source scene and merging the voxel result into a single grid.

Properties

Voxel Scene	The source Voxel Scene.
Scan Box	Defines which Scan Box is used for scanning the source scene.

A Scene Reference can use either the asset's Default Scan Box or a custom Scan Box.

Movie Reference

A Movie Reference loads voxel data from a Voxel Movie.

It displays the voxel data of a selected frame.

Properties

Voxel Movie	The source Voxel Movie.
Frame	Defines which frame is displayed.

Heightmap Reference

A Heightmap Reference converts a Heightmap into voxel data.

Properties

Heightmap	The source Heightmap.
Height Offset	Adds an offset to the generated height values.
Height Scale	Multiplies the generated height values.

Mesh Reference

A Mesh Reference voxelizes mesh data from a Mesh Asset.

Properties

Mesh Asset	The source Mesh Asset.
Scan Box	Defines which Scan Box is used for voxelization.

Shared Voxel Reference Properties

All Voxel Reference types share the following properties:

Crop	Enables cropping of the generated voxel grid.
Crop Box Position	Defines the position of the crop box inside the voxel grid.
Crop Box Size	Defines the size of the crop box. Voxel data outside this region is excluded.

Pixel References

Pixel References load data from other assets and display the result as pixel data inside a Heightmap.

At the moment, Pixel References can reference Heightmaps only.

The loaded pixel grid can be flipped, rotated, and scaled.

Pixel Reference Properties

Heightmap	The source Heightmap.
Grid Flip X	Flips the pixel grid horizontally.
Grid Flip Y	Flips the pixel grid vertically.
Grid Rotate	Rotates the pixel grid.
Grid Scale X	Scales the pixel grid along the X axis.
Grid Scale Y	Scales the pixel grid along the Y axis.

TIP

For more information about updating, converting, and breaking references, see Referencing Assets.