Go to: Synopsis. Return value. Keywords. Flags. MEL examples.

Synopsis

geomToBBox [-combineMesh] [-keepOriginal] [-name string] [-nameSuffix string] [-shaderColor float float float] [-single]

geomToBBox is undoable, NOT queryable, and NOT editable.

Create polygonal mesh bounding boxes for geometry. Can also create a single bounding box per hierarchy.

Return value

None

Keywords

bounding, box

Flags

combineMesh, keepOriginal, name, nameSuffix, shaderColor, single
Long name (short name) Argument types Properties
-combineMesh(-cm) create
Combine resulting bounding boxes. Mutually exclusive with -s/single option.
-name(-n) string create
Specifies the bounding box name.
-nameSuffix(-ns) string create
Specifies the bounding box name suffix.
-keepOriginal(-ko) create
Do not remove the selected nodes used to create the bounding boxes.
-single(-s) create
Create a single bounding box per hierarchy selected.
-shaderColor(-sc) float float float create
Set the color attribute of the Lambert material associate with the bounding box. The RGB values should be defined between 0 to 1.0. Default value is 0.5 0.5 0.5.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

// Create two poly spheres and parent them together
//
polySphere;
move -1 0 3;
polySphere;
move 3 0 -1;
parent pSphere2 pSphere1;
// Select the parent sphere
//
select -r pSphere1;
// Create a bounding box per shape with the object hierarchy selected,
// add a name and suffix for that bounding box and add a RGB color for the
// shader color.
geomToBBox -name "MyBBox" -nameSuffix "_perShape" -shaderColor 0 1 0.043;
// Create two poly spheres and parent them together
//
polySphere;
move -1 5 3;
polySphere;
move 3 5 -1;
parent pSphere3 pSphere4;
// Select the parent sphere
//
select -r pSphere4;
// Create one bounding box for the entire hierarchy selected,
// add a name and suffix for that bounding box and add a RGB color for the
// shader color.
//
geomToBBox -single -name "MyBBox" -nameSuffix "_hierarchy" -shaderColor 0.928 0.460 1;