Go to: Synopsis. Return value. Flags. Python examples.
bevelPlus( curve [curve curve...] ,
[capSides=int], [constructionHistory=boolean],
[depth=linear], [extrudeDepth=linear], [innerStyle=int], [joinSurfaces=boolean], [name=string], [normalsOutwards=boolean],
[numberOfSides=int],
[outerStyle=int], [polyOutChordHeight=linear],
[polyOutChordHeightRatio=float],
[polyOutCount=int],
[polyOutCurveSamples=int],
[polyOutCurveType=int],
[polyOutExtrusionSamples=int],
[polyOutExtrusionType=int],
[polyOutMethod=int],
[polyOutUseChordHeight=boolean],
[polyOutUseChordHeightRatio=
boolean], [polygon=int],
[tolerance=linear], [width=linear])
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.
| string[] |
Object name(s) and node name |
In query mode, return type is based on queried flag.
capSides, constructionHistory, depth, extrudeDepth, innerStyle, joinSurfaces, name,
normalsOutwards, numberOfSides, outerStyle, polyOutChordHeight, polyOutChordHeightRatio,
polyOutCount, polyOutCurveSamples, polyOutCurveType, polyOutExtrusionSamples,
polyOutExtrusionType,
polyOutMethod, polyOutUseChordHeight, polyOutUseChordHeightRatio,
polygon, tolerance, width
| Long name (short name) |
Argument types |
Properties |
name(n) |
string |
 |
|
Name the resulting object |
|
constructionHistory(ch) |
boolean |
|
|
Turn the construction history on or off |
|
polygon(po) |
int |
|
|
Create a polyset (1) instead of nurbs surface (0) |
|
numberOfSides(ns) |
int |
  |
|
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 |
|
capSides(cap) |
int |
|
|
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 |
|
outerStyle(os) |
int |
|
|
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. |
|
innerStyle(innerStyle) |
int |
|
|
Similar to outerStyle, this style is applied to all but the
first (outer) curve specified. |
|
tolerance(tol) |
linear |
|
|
The tolerance for creating NURBS caps.
Default:0.01 |
|
width(w) |
linear |
|
|
The width for the bevel.
Default:0.5 |
|
depth(d) |
linear |
|
|
The depth for the bevel.
Default:0.5 |
|
extrudeDepth(ed) |
linear |
|
|
The extrude distance (depth) for bevel.
Default:1.0 |
|
joinSurfaces(js) |
boolean |
|
|
Attach bevelled surfaces into one surface for each input
curve.
Default:true |
|
normalsOutwards(no) |
boolean |
|
|
If enabled, the normals point outwards on the resulting NURBS
or poly surface. |
|
polyOutMethod(pom) |
int |
|
|
Method for the polygonal output: 0 - Face Count, 2 -
Sampling
Default:2 |
|
polyOutCount(poc) |
int |
|
|
The number of polygons to produce when the polygon is
requested. Only used if Method is face count (0).
Default:200 |
|
polyOutExtrusionType(pet) |
int |
|
|
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 |
|
polyOutExtrusionSamples(
pes) |
int |
|
|
Initial number of samples along the extrusion. Only used if
Method is Sampling.
Default:2 |
|
polyOutCurveType(pct) |
int |
|
|
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 |
|
polyOutCurveSamples(pcs) |
int |
|
|
Initial number of samples in the curve direction. Only used if
Method is Sampling.
Default:6 |
|
polyOutUseChordHeight(uch) |
boolean |
|
|
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 |
|
polyOutChordHeight(cht) |
linear |
|
|
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 |
|
polyOutUseChordHeightRatio(
ucr) |
boolean |
|
|
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 |
|
polyOutChordHeightRatio(
chr) |
float |
|
|
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 |
|
| 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
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 )