Go to: Synopsis. Return value. Flags. Python examples.

Synopsis

bevelPlus( curve [curve curve...] , [bevelInside=boolean], [capSides=int], [constructionHistory=boolean], [innerStyle=int], [joinSurfaces=boolean], [name=string], [normalsOutwards=boolean], [numberOfSides=int], [outerStyle=int], [polygon=int], [range=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

bevelPlus is undoable, queryable, and editable.

The bevelPlus command creates a new bevel surface for the specified curves using a given style curve. The first curve should be the "outside" curve, 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.

Return value

string[]Object name(s) and node name

In query mode, return type is based on queried flag.

Flags

bevelInside, capSides, constructionHistory, innerStyle, joinSurfaces, name, normalsOutwards, numberOfSides, outerStyle, polygon, range
Long name (short name) Argument types Properties
Common flags
bevelInside(bin) boolean createqueryedit
If true, ensure surface always remains within the original profile curve
Default: false
capSides(cap) int createquery
How to cap the bevel.
  • 1 - no caps
  • 2 - cap at start only
  • 3 - cap at end only
  • 4 - cap at start and end

Default:4
constructionHistory(ch) boolean create
Turn the construction history on or off.
innerStyle(innerStyle) int createqueryedit
Similar to outerStyle, this style is applied to all but the first (outer) curve specified.
joinSurfaces(js) boolean createqueryedit
Attach bevelled surfaces into one surface for each input curve.
Default:true
name(n) string create
Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created.
normalsOutwards(no) boolean createqueryedit
If enabled, the normals point outwards on the resulting NURBS or poly surface.
numberOfSides(ns) int createqueryedit
How to apply the bevel.
  • 1 - no bevels
  • 2 - bevel at start only
  • 3 - bevel at end only
  • 4 - bevel at start and end

Default: 4
outerStyle(os) int createqueryedit
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.
polygon(po) int create
The value of this argument controls the type of the object created by this operation
  • 0: nurbs surface
  • 1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)
  • 2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)
  • 3: Bezier surface
  • 4: subdivision surface solid (use nurbsToSubdivPref to set the parameters for the conversion)
range(rn) boolean create
Force a curve range on complete input curve.
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.

Python examples

import maya.cmds as cmds

cmds.circle()
cmds.scale( 10, 10, 10, r=True )
cmds.circle()
cmds.scale( 5, 5, 5, r=True )
cmds.bevelPlus( 'nurbsCircle1', 'nurbsCircle2', po=1, cap=4, outerStyle=2, innerStyle=4 )