pymel.core.modeling.bevelPlus

bevelPlus(*args, **kwargs)

The bevelPlus command creates a new bevel surface for the specified curves using a given style curve. The first curve should be the outsidecurve, and the (optional) rest of them should be inside of the first one. For predictable results, the curves should be planar and all in the same plane.

Flags:

Long Name / Short Name Argument Types Properties
bevelInside / bin bool  
   
caching / cch bool  
   
capSides / cap int ../../../_images/create.gif ../../../_images/query.gif
  How to cap the bevel. 1 - no caps2 - cap at start only3 - cap at end only4 - cap at start and endDefault:4
constructionHistory / ch bool ../../../_images/create.gif
  Turn the construction history on or off.
depth / d float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The depth for the bevel. Default:0.5
extrudeDepth / ed float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The extrude distance (depth) for bevel. Default:1.0
frozen / fzn bool  
   
innerStyle / innerStyle int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Similar to outerStyle, this style is applied to all but the first (outer) curve specified.
joinSurfaces / js bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Attach bevelled surfaces into one surface for each input curve. Default:true
name / n unicode ../../../_images/create.gif
  Name the resulting object.
nodeState / nds int  
   
normalsOutwards / no bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  If enabled, the normals point outwards on the resulting NURBS or poly surface.
numberOfSides / ns int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  How to apply the bevel. 1 - no bevels2 - bevel at start only3 - bevel at end only4 - bevel at start and endDefault:4
outerStyle / os int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Choose a style to use for the bevel of the first (outer) curve. There are 15 predefined styles (values 0 to 14 can be used to select them). For those experienced with MEL, you can, after the fact, specify a custom curve and use it for the style curve. See the documentation for styleCurve node to see what requirements a style curve must satisfy.
polyOutChordHeight / cht float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Chord height is the absolute distance in object space which the center of a polygon edge can deviate from the actual center of the surface span. Only used if Method is Sampling and if polyOutseChordHeight is true. Default:0.1
polyOutChordHeightRatio / chr float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Chord height ratio is the ratio of the chord length of a surface span to the chord height. (This is a length to height ratio). 0 is a very loose fit. 1 is a very tight fit. This applies to the polygonal output type only. (See also description of chord height.) Used if Method is Sampling and polyOutUseChordHeightRatio is true. Default:0.1
polyOutCount / poc int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The number of polygons to produce when the polygon is requested. Only used if Method is face count (0). Default:200
polyOutCurveSamples / pcs int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Initial number of samples in the curve direction. Only used if Method is Sampling. Default:6
polyOutCurveType / pct int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Initial tessellation criteria along the curve. Only used if Method is Sampling. 2 - Complete Curve. This type places a specific number of sample points along the curve, equally spaced in parameter space.3 - Curve Span. This type places a specific number of sample points across each curve span, equally spaced in parameter space.Default:3
polyOutExtrusionSamples / pes int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Initial number of samples along the extrusion. Only used if Method is Sampling. Default:2
polyOutExtrusionType / pet int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Initial type tessellation criteria along the extrude direction. Used only if Method is Sampling. 2 - Complete Extrusion. This type places a specific number of lines across the surface, equally spaced in parameter space.3 - Extrusion Section. This type places a specific number of lines across each surface span, equally spaced in parameter space.Default:3
polyOutMethod / pom int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  Method for the polygonal output: 0 - Face Count, 2 - Sampling Default:2
polyOutUseChordHeight / uch bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  True means use chord height. This is a secondary criteria that refines the tessellation produced using the sampling value. Only used if Method is Sampling. Default:false
polyOutUseChordHeightRatio / ucr bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  True means use chord height ratio. This is a secondary criteria that refines the tessellation produced using the sampling value. Only used if Method is Sampling. Default:true
polygon / po int ../../../_images/create.gif
  Create a polyset (1) instead of nurbs surface (0).
range / rn bool  
   
tolerance / tol float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The tolerance for creating NURBS caps. Default:0.01
width / w float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
  The width for the bevel. Default:0.5 Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.bevelPlus

Example:

import pymel.core as pm

pm.circle()
# Result: [nt.Transform(u'nurbsCircle1'), nt.MakeNurbCircle(u'makeNurbCircle1')] #
pm.scale( 10, 10, 10, r=True )
pm.circle()
# Result: [nt.Transform(u'nurbsCircle2'), nt.MakeNurbCircle(u'makeNurbCircle2')] #
pm.scale( 5, 5, 5, r=True )
pm.bevelPlus( 'nurbsCircle1', 'nurbsCircle2', po=1, cap=4, outerStyle=2, innerStyle=4 )
# Result: [nt.Transform(u'bevelPolygon1'), nt.BevelPlus(u'bevelPlus1')] #