geomToBBox

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

Synopsis

geomToBBox [-bakeAnimation] [-combineMesh] [-endTime time] [-keepOriginal] [-name string] [-nameSuffix string] [-sampleBy time] [-shaderColor float float float] [-single] [-startTime time]

geomToBBox is undoable, NOT queryable, and NOT editable.

Return value

None

Keywords

Flags

Long name (short name)	Argument types	Properties
-bakeAnimation(-ba)
Bake the animation. Can be used with startTime, endTime and sampleBy flags. If used alone, the time slider will be used to specify the startTime and endTime.
-combineMesh(-cm)
Combine resulting bounding boxes. Mutually exclusive with -s/single option.
-endTime(-et)	time
Used with bakeAnimation flag. Specifies the end time of the baking process.
-keepOriginal(-ko)
Do not remove the selected nodes used to create the bounding boxes.
-name(-n)	string
Specifies the bounding box name.
-nameSuffix(-ns)	string
Specifies the bounding box name suffix.
-sampleBy(-sb)	time
Used with bakeAnimation flag. Specifies the animation evaluation time increment.
-shaderColor(-sc)	float float float
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.
-single(-s)
Create a single bounding box per hierarchy selected.
-startTime(-st)	time
Used with bakeAnimation flag. Specifies the start time of the baking process.

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 pSphere2 pSphere1;

// Select the parent sphere
//
select -r pSphere1;

// 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;

// Create and simple animation and bake the animation on the bounding box for
// a specific time frame and incremental evaluation time.
polySphere -name "BouncingBall";
currentTime 1;
setKeyframe;
currentTime 5;
move 0 10 0;
setKeyframe;
currentTime 9;
move 0 0 0;
setKeyframe;

geomToBBox -keepOriginal -name "BakedAnimBBox" -bakeAnimation -startTime 3 -endTime 7 -sampleBy 0.5;
currentTime 1;