Go to: Synopsis. Return value. Flags. Python examples.
moveVertexAlongDirection([direction=[float, float, float]], [magnitude=linear], [normalDirection=linear], [uDirection=linear], [uvNormalDirection=[linear, linear, linear]], [vDirection=linear])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
moveVertexAlongDirection is undoable, NOT queryable, and NOT editable.
The command moves the selected vertex ( control vertex ) in
the specified unit direction by the given magnitude. The vertex(ices)
may also be moved in the direction of unit normal ( -n flag ).
For NURBS surface vertices the direction of movement could also
be either in tangent along U or tangent along V. The flags -n,
-u, -v and -d are mutually exclusive, ie. the selected vertices
can be all moved in only -n or -u or -v or -d.
None
direction, magnitude, normalDirection, uDirection, uvNormalDirection, vDirection
| Long name (short name) |
Argument types |
Properties |
|
direction(d)
|
[float, float, float]
|
 
|
|
move the vertex along the direction as specified. The direction is
normalized.
|
|
magnitude(m)
|
linear
|
|
|
move by the specified magnitude in the direction vector.
|
|
normalDirection(n)
|
linear
|
|
|
move components in the direction of normal by the given magnitude at
the respective components. The normal is 'normalized'.
|
|
uDirection(u)
|
linear
|
|
|
move components in the direction of tangent along U at the
respective components where appropriate. The flag is ignored
for polygons, NURBS curves. The u direction is normalized.
|
|
uvNormalDirection(uvn)
|
[linear, linear, linear]
|
|
|
move in the triad space [u,v,n] at the respective components by the
specified displacements. The flag is ignored for polygons, NURBS curves.
|
|
vDirection(v)
|
linear
|
|
|
move components in the direction of tangent along V at the
respective components where appropriate. The flag is ignored
for polygons, NURBS curves.
|
|
|
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.moveVertexAlongDirection( "nurbsSurface1.cv[1][1]", "pPlane1.vtx[120]", d=[(1, 1, 1), (1, 0, 0)], m=[2.0, 1.0] )
# Move the control vertex on the surface, mesh in the normalized
# directions (1,1,1), (1,0,0) by magnitude 2.0, 1.0 respectively.
cmds.moveVertexAlongDirection( "nurbsSurface1.cv[3][1]", "nurbsSurface2.cv[0][0]", "pPlane1.vtx[10]", n=[1, -1.9, 3] )
# Move the control vertex on the NURBS surfaces, mesh along their
# respective unit normals by a magnitudes 1.0, -1.9 and 3.0 respectively.
cmds.moveVertexAlongDirection( "nurbsSurface1.cv[4][5]", "nurbsSurface2.cv[0][0]", u=[2.0, 1.0] )
# Move the control vertex on the NURBS surfaces in the normalized
# tangent along U by a magnitude 2.0 and 1.0 respectively.
cmds.moveVertexAlongDirection( "nurbsSurface1.cv[2][3]", v=-1.0 )
# Move the control vertex on the nurbsSurface in the normalized
# tangent along V by -1.0
cmds.moveVertexAlongDirection( "nurbsSurface1.cv[1][1]", uvn=(1, 2, -1) )
# Move the control vertex on the nurbsSurface in the space defined
# by triad [u,v,n] by 1,2,-1 respectively.
# If the initial vertex position is o(ox,oy,oz) and u,v and n are
# direction vectors then the new position p(px,py,pz) would be:
# p = o + 1*u + 2*v + (-1)*n ;