EmbedInSpace
ABSTRACT
The EmbedInSpace operation converts a mesh in axes space to world space
IMPORTANT ELEMENT
While I think this function is still a bit verbose, it is still probably the easiest way to work with axes
PARAMETERS
| mesh | Represents the mesh-tree containing meshes to be positioned in 3D space. All provided meshes will be positioned accordingly. |
| root | The root of the mesh-tree, serving as the container for mesh selection. |
| tag_predicate(tag) | Determines whether a mesh should be included in the positioning operation based on the provided tag. |
| axis_center | A 3-vector indicating the center coordinates of the axes in the 3D space. |
| x_unit | A scalar indicating what x value in axes space maps to 1 in world space |
| y_unit | A scalar indicating what y value in axes space maps to 1 in world space |
| z_unit | A scalar indicating what z value in axes space maps to 1 in world space |
RETURN
If the complete mesh set is provided, all meshes will be individually positioned according to the specified axes in the 3D space. The return value is the mesh-tree of all the positioned meshes. However, if only a subset is chosen, the returned value will comprise a mesh-tree of the positioned selected meshes, while the unselected meshes will remain unchanged. Crucially, all meshes you didn't select will still be included in the result mesh_tree, but be provided as is (i.e., not positioned).
DECLARATION
func EmbedInSpace([mesh_tree] {[full] {mesh}, [tag_pred] {root, tag_predicate(tag)}}, axis_center, x_unit, y_unit, z_unit)