Go to: Synopsis. Flags. Return value. Related. MEL examples.

Synopsis

polyBevel [-angleTolerance double] [-autoFit boolean] [-constructionHistory boolean] [-name string] [-offset linear] [-offsetAsFraction boolean] [-roundness float] [-segments int] [-worldSpace boolean]

polyBevel is undoable, queryable, and editable.

Bevel edges.

Flags

angleTolerance, autoFit, constructionHistory, name, offset, offsetAsFraction, roundness, segments, worldSpace
Long name (short name) [argument types] Properties
-offset(-o) linear createqueryedit
This flag specifies the offset distance for the bevelling.
C: Default is 0.2.
Q: When queried, this flag returns a float.

In query mode, this flag needs a value.
-offsetAsFraction(-oaf) boolean createqueryedit
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.

In query mode, this flag needs a value.
-angleTolerance(-at) double createqueryedit
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.

In query mode, this flag needs a value.
-roundness(-r) float createqueryedit
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.

In query mode, this flag needs a value.
-segments(-sg) int createqueryedit
This flag specifies the number of segments used for the bevelling.
C: Default is 1.
Q: When queried, this flag returns an int.

In query mode, this flag needs a value.
-autoFit(-af) boolean createqueryedit
Computes a smooth roundness, new faces round off a smooth angle.
C: Default is on.
Q: When queried, this flag returns an int.

In query mode, this flag needs a value.
-worldSpace(-ws) boolean createqueryedit
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 flags

In query mode, this flag needs a value.
-name(-n) string create
Name the resulting object.
-constructionHistory(-ch) boolean createquery
Turn the construction history on or off (where applicable).
Q: When queried, this flag returns an int

In query mode, this flag needs a value.
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 be used more than once in a command

Return value


string The node name.

Related

polyAppend, polyAppendVertex, polyChipOff, polyCreateFacet, polyExtrudeEdge, polyExtrudeFacet, polySmooth, polySplit, polySplitVertex, polySubdivideEdge, polySubdivideFacet, polyTriangulate

MEL examples

// Replace an edge by 1 face, the width of the new face is given by the offset value.
polyCube -n plg;
polyBevel -offset 0.2 plg.e[7];
delete plg;

// Replace an edge by 4 faces, the new faces are rounding a smooth angle.
polyCube -n plg;
polyBevel -segments 4 -offset 0.4 plg.e[7];
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).
polyCube -n plg;
polyBevel -segments 4 -autoFit off plg.e[7];
delete plg;