Go to: Synopsis. Return value. Keywords. Flags. Python examples.
geomToBBox([combineMesh=boolean], [keepOriginal=boolean], [name=string], [nameSuffix=string], [shaderColor=[float, float, float]], [single=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
geomToBBox is undoable, NOT queryable, and NOT editable.
Create polygonal mesh bounding boxes for geometry.
Can also create a single bounding box per hierarchy.
None
bounding, box
combineMesh, keepOriginal, name, nameSuffix, shaderColor, single
Long name (short name) |
Argument types |
Properties |
combineMesh(cm)
|
boolean
|
|
|
Combine resulting bounding boxes.
Mutually exclusive with -s/single option.
|
|
name(n)
|
string
|
|
|
Specifies the bounding box name.
|
|
nameSuffix(ns)
|
string
|
|
|
Specifies the bounding box name suffix.
|
|
keepOriginal(ko)
|
boolean
|
|
|
Do not remove the selected nodes used to create the bounding boxes.
|
|
single(s)
|
boolean
|
|
|
Create a single bounding box per hierarchy selected.
|
|
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.
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# Create two poly spheres and parent them together
#
cmds.polySphere()
cmds.move(-1, 0, 3)
cmds.polySphere()
cmds.move(3, 0, -1)
cmds.parent( 'pSphere2', 'pSphere1' )
# Select the parent sphere
#
cmds.select( 'pSphere1', replace=True )
# Create a bounding box per shape in the object hierarchy selected,
# add a name and suffix for that bounding box and add a RGB color for the
# shader color.
#
cmds.geomToBBox(name='MyBBox', nameSuffix='_perShape', shaderColor=[0,1,0.043])
# Create two poly spheres and parent them together
#
cmds.polySphere()
cmds.move(-1, 5, 3)
cmds.polySphere()
cmds.move(3, 5, -1)
cmds.parent( 'pSphere3', 'pSphere4' )
# Select the parent sphere
#
cmds.select( 'pSphere4', replace=True )
# 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.
#
cmds.geomToBBox(single=True, name='MyBBox', nameSuffix='_hierarchy', shaderColor=[0.928,0.460,1])