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

Synopsis

polyNormalPerVertex [-allLocked boolean] [-deformable boolean] [-freezeNormal boolean] [-normalX float] [-normalXYZ float float float] [-normalY float] [-normalZ float] [-relative] [-unFreezeNormal boolean]

polyNormalPerVertex is undoable, queryable, and editable.

Command associates normal(x, y, z) with vertices on polygonal objects. When used with the query flag, it returns the normal associated with the specified components. However, when queried, the command returns all normals (all vtx-face combinations) on the vertex, regardless of whether they ar shared or not.

Return value

booleanSuccess or Failure.

In query mode, return type is based on queried flag.

Keywords

poly, userNormals, polyNormals, setNormal, vertexNormal, vertex

Related

polyAverageNormal, polyNormal, polySetToFaceNormal, polySoftEdge

Flags

allLocked, deformable, freezeNormal, normalX, normalXYZ, normalY, normalZ, relative, unFreezeNormal
Long name (short name) Argument types Properties
-relative(-rel) createqueryedit
When used, the normal values specified are added relative to the current value.
-normalX(-x) float createqueryedit
Specifies the x value normal
-normalY(-y) float createqueryedit
Specifies the y value normal
-normalZ(-z) float createqueryedit
Specifies the z value normal
-normalXYZ(-xyz) float float float createqueryedit
Specifies the xyz values normal
-freezeNormal(-fn) boolean createqueryedit
Specifies that the normal values be frozen (locked) at the current value.
-unFreezeNormal(-ufn) boolean createqueryedit
Specifies that the normal values that were frozen at the current value be un-frozen (un-locked).
-allLocked(-al) boolean createqueryedit
Queries if all normals on the selected vertices are locked (frozen) or not
-deformable(-def) boolean createqueryedit
DEFAULT true OBSOLETE flag. This flag will be removed in the next release.

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.

MEL examples

// To set the xyz values of normals of selected vertices:
polyNormalPerVertex -xyz .2 .3 .4;
// To set just the "x" value of normal of selected vertices:
polyNormalPerVertex -x .37;
// To add to the current value of the "y" normal value of selected vertices:
polyNormalPerVertex -rel -y .13;
// To query the normal values on selected vertices - This returns all normals
// regardless of whether they are shared or not:
polyNormalPerVertex -q -xyz;
// To query if the normals on the selected vertices are locked or not
polyNormalPerVertex -q -freezeNormal;
// To query if all the normals on the selected vertices are locked or not
polyNormalPerVertex -q -allLocked;
// More examples
file -f -new;
polyCube;
select -r pCube1.vtxFace[2][1] ;
polyNormalPerVertex -q -freezeNormal;
// Result: 0 //
// Now, lock the normal of a VertexFace on the cube
select -r pCube1.vtxFace[2][1] ;
polyNormalPerVertex -xyz 0.7071 0.7071 0;
// Query if the normal is locked for this vertexFace
polyNormalPerVertex -q -freezeNormal;
// Result: 1 //
// Query if the normal is locked for all the normals on this vertex
// Should return 0, because there are some other normals on
// this vertex that are not locked.
select -r pCube1.vtx[2] ;
polyNormalPerVertex -q -allLocked;
// Result: 0 //