pymel.core.modeling.geomToBBox¶
- geomToBBox(*args, **kwargs)¶
Create polygonal mesh bounding boxes for geometry. Can also create a single bounding box per hierarchy.
Flags:
Long Name / Short Name Argument Types Properties bakeAnimation / ba bool 
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 bool
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 bool
Do not remove the selected nodes used to create the bounding boxes. name / n unicode
Specifies the bounding box name. nameSuffix / ns unicode
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 bool
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 have multiple arguments, passed either as a tuple or a list. Derived from mel command maya.cmds.geomToBBox
Example:
import pymel.core as pm # Create two poly spheres and parent them together # pm.polySphere() # Result: [nt.Transform(u'pSphere1'), nt.PolySphere(u'polySphere1')] # pm.move(-1, 0, 3) pm.polySphere() # Result: [nt.Transform(u'pSphere2'), nt.PolySphere(u'polySphere2')] # pm.move(3, 0, -1) pm.parent( 'pSphere2', 'pSphere1' ) # Result: [nt.Transform(u'pSphere2')] # # Select the parent sphere # pm.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. # pm.geomToBBox(name='MyBBox', nameSuffix='_perShape', shaderColor=[0,1,0.043]) # Result: [u'MyBBox_perShape', u'MyBBox_perShape1'] # # Create two poly spheres and parent them together # pm.polySphere() # Result: [nt.Transform(u'pSphere1'), nt.PolySphere(u'polySphere1')] # pm.move(-1, 5, 3) pm.polySphere() # Result: [nt.Transform(u'pSphere2'), nt.PolySphere(u'polySphere2')] # pm.move(3, 5, -1) pm.parent( 'pSphere2', 'pSphere1' ) # Result: [nt.Transform(u'pSphere2')] # # Select the parent sphere # pm.select( 'pSphere1', 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. # pm.geomToBBox(single=True, name='MyBBox', nameSuffix='_hierarchy', shaderColor=[0.928,0.460,1]) # Result: [u'MyBBox_hierarchy'] # # Create and simple animation and bake the animation on the bounding box for # a specific time frame and incremental evaluation time. pm.polySphere(name="BouncingBall") # Result: [nt.Transform(u'BouncingBall'), nt.PolySphere(u'polySphere1')] # pm.currentTime(1) # Result: 1.0 # pm.setKeyframe() # Result: 10 # pm.currentTime(5) # Result: 5.0 # pm.move( 0, 10, 0) pm.setKeyframe() # Result: 10 # pm.currentTime(9) # Result: 9.0 # pm.move( 0, 0, 0) pm.setKeyframe() # Result: 10 # pm.geomToBBox(keepOriginal=True, name="BakedAnimBBox", bakeAnimation=True, startTime=3, endTime=7, sampleBy=0.5) # Result: [u'BakedAnimBBox1'] # pm.currentTime(1) # Result: 1.0 #