pymel.core.modeling.polyBevel

polyBevel(*args, **kwargs)

Bevel edges.

Flags:
Long name (short name) Argument Types Properties
angleTolerance (at) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

This flag specifies the angle beyond which additional faces may be inserted to avoid possible twisting of faces. If the bevel produces unwanted faces, try increasing the angle tolerance. C: Default is 5 degrees. Q: When queried, this flag returns a double.

autoFit (af) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Computes a smooth roundness, new faces round off a smooth angle. C: Default is on. Q: When queried, this flag returns an int.
caching (cch) bool ../../../_images/create.gif ../../../_images/edit.gif
 
Toggle caching for all attributes so that no recomputation is needed
constructionHistory (ch) bool ../../../_images/create.gif ../../../_images/query.gif
 

Turn the construction history on or off (where applicable). If construction history is on then the corresponding node will be inserted into the history chain for the mesh. If construction history is off then the operation will be performed directly on the object. Note:If the object already has construction history then this flag is ignored and the node will always be inserted into the history chain.

fillNgons (fn) bool  
   
mergeVertexTolerance (mvt) float  
   
mergeVertices (mv) bool  
   
miteringAngle (ma) float  
   
name (n) unicode ../../../_images/create.gif
 
Give a name to the resulting node.
nodeState (nds) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

Defines how to evaluate the node. 0: Normal1: PassThrough2: Blocking3: Internally disabled. Will return to Normal state when enabled4: Internally disabled. Will return to PassThrough state when enabled5: Internally disabled. Will return to Blocking state when enabledFlag can have multiple arguments, passed either as a tuple or a list.

offset (o) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
This flag specifies the offset distance for the bevelling. C: Default is 0.2. Q: When queried, this flag returns a float.
offsetAsFraction (oaf) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

This flag specifies whether the offset is a fraction or an absolute value. If a fraction, the offset can range between 0 and 1, where 1 is the maximum possible offset C: Default is false. Q: When queried, this flag returns an int.

roundness (r) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

This flag specifies the roundness of bevel. A roundness of 0 means that all new faces are coplanar. This value is only used if the autoFit value is off. C: Default is 0.5. Q: When queried, this flag returns a float.

segments (sg) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
This flag specifies the number of segments used for the bevelling. C: Default is 1. Q: When queried, this flag returns an int.
smoothingAngle (sa) float  
   
uvAssignment (ua) int  
   
worldSpace (ws) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 

This flags specifies the used reference. If on : the offset flag is taken in world reference. If off : the offset flag is taken in object reference (the default). C: Default is off. Q: When queried, this flag returns an int. Common flagsCommon flags

Derived from mel command maya.cmds.polyBevel

Example:

import pymel.core as pm

# Replace an edge by 1 face, the width of the new face is given by the offset value.
pm.polyCube( n='plg' )
pm.polyBevel( 'plg.e[7]', offset=0.2 )
pm.delete( 'plg' )

# Replace an edge by 4 faces, the new faces are rounding a smooth angle.
pm.polyCube( n='plg' )
pm.polyBevel( 'plg.e[7]', segments=4, offset=0.4 )
pm.delete( 'plg' )

# Replace an edge by 4 faces, the new faces are rounding an angle specified by the default value of roundness (i.e 0.5).
pm.polyCube( n='plg' )
pm.polyBevel( 'plg.e[7]', segments=4, autoFit=Flase )
pm.delete( 'plg' )

Previous topic

pymel.core.modeling.polyAverageVertex

Next topic

pymel.core.modeling.polyBlendColor

Core

Core Modules

Other Modules

This Page