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

Synopsis

polySetToFaceNormal([setUserNormal=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

polySetToFaceNormal is undoable, NOT queryable, and NOT editable.

This command takes selected polygonal vertices or vertex-faces and changes their normals. If the option userNormal is used, the new normal values will be the face normals arround the vertices/vertex-faces. Otherwise the new normal values will be default values according to the internal calculation.

Return value

stringof the node name

Keywords

poly, userNormal, polyNormals, setToFaceNormal, setNormal, vertexNormal

Related

polyAverageNormal, polyNormal, polyNormalPerVertex, polySoftEdge

Flags

setUserNormal
Long name (short name) Argument types Properties
setUserNormal(su) boolean create
when this flag is presented, user normals will be created on each vertex face and the values will be the face normal value. Otherwise the normal values will be the internal computing results. Default is false.

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.

Python examples

import maya.cmds as cmds

# Create user normals and set them to the face normals
cmds.polySetToFaceNormal( setUserNormal=True )
# Set the normals to the default normal values (internally computed)
cmds.polySetToFaceNormal()