Go to: Synopsis. Return value. Flags. Python examples.
blend2(
curve curve [curve...]
, [autoAnchor=boolean], [autoNormal=boolean], [caching=boolean], [constructionHistory=boolean], [flipLeftNormal=boolean], [flipRightNormal=boolean], [leftAnchor=float], [leftEnd=float], [leftStart=float], [multipleKnots=boolean], [name=string], [nodeState=int], [object=boolean], [polygon=int], [positionTolerance=float], [reverseLeft=boolean], [reverseRight=boolean], [rightAnchor=float], [rightEnd=float], [rightStart=float], [tangentTolerance=float])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
blend2 is undoable, queryable, and editable.
This command creates a surface by blending between given curves.
This is an enhancement (more user control) compared to blend
which is now obsolete.
| string[] | Object name and node name |
In query mode, return type is based on queried flag.
autoAnchor, autoNormal, caching, constructionHistory, flipLeftNormal, flipRightNormal, leftAnchor, leftEnd, leftStart, multipleKnots, name, nodeState, object, polygon, positionTolerance, reverseLeft, reverseRight, rightAnchor, rightEnd, rightStart, tangentTolerance
| Long name (short name) |
Argument types |
Properties |
multipleKnots(mk)
|
boolean
|
  
|
|
If true, use the new blend which produces fully multiple interior knots
Default: true
|
|
positionTolerance(pt)
|
float
|
|
|
The positional C(0) tolerance of the blend surface to the adjacent surfaces.
Default: 0.1
|
|
tangentTolerance(tt)
|
float
|
|
|
The tangent G(1) continuity tolerance of the blend surface to the adjacent surfaces.
Default: 0.1
|
|
autoNormal(an)
|
boolean
|
|
|
If true, the direction of each starting tangent is computed based on given geometry.
Default: true
|
|
flipLeftNormal(fln)
|
boolean
|
|
|
If true, flip the starting tangent off the left boundary.
Default: false
|
|
flipRightNormal(frn)
|
boolean
|
|
|
If true, flip the starting tangent off the right boundary.
Default: false
|
|
autoAnchor(aa)
|
boolean
|
|
|
If true and both paths are closed, automatically determine the value on the right rail so that they match
Default: true
|
|
leftAnchor(la)
|
float
|
|
|
The reference parameter on the left boundary where the blend surface starts in the case of the closed rail.
Default: 0.0
|
|
leftStart(ls)
|
float
|
|
|
The reference parameter on the left boundary where the blend surface starts.
Default: 0.0
|
|
leftEnd(le)
|
float
|
|
|
The reference parameter on the left boundary where the blend surface ends.
Default: 1.0
|
|
reverseLeft(rvl)
|
boolean
|
|
|
If true, reverse the direction off the left boundary. autoDirection must be false for this value to be considered.
Default: false
|
|
rightAnchor(ra)
|
float
|
|
|
The reference parameter on the right boundary where the blend surface starts in the case of the closed rail.
Default: 0.0
|
|
rightStart(rs)
|
float
|
|
|
The reference parameter on the right boundary where the blend surface starts.
Default: 0.0
|
|
rightEnd(re)
|
float
|
|
|
The reference parameter on the right boundary where the blend surface ends.
Default: 1.0
|
|
reverseRight(rvr)
|
boolean
|
|
|
If true, reverse the direction of the right boundary. autoDirection must be false for this value to be considered.
Default: false
|
|
| Advanced flags |
caching(cch)
|
boolean
|
|
|
Modifies the node caching mode. See the node documentation for more information.
Note: For advanced users only.
|
|
nodeState(nds)
|
int
|
|
|
Modifies the node state. See the node documentation for more information.
Note: For advanced users only.
|
|
| Common flags |
name(n)
|
string
|
|
|
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.
|
|
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node
|
|
polygon(po)
|
int
|
|
|
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)
|
|
|
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
# Do blend with auto normal and with no history:
cmds.blend2( an=True, ch=False )
# Do blend without auto normal
cmds.blend2( an=False, fln=True, frn=True )