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 |
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. |
|
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. |
|
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. |
|
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. |
|
| 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 ;