PasteUserNormals

Introduced

v8.0 (2010)

Description

Pastes the normal value previously copied using the CopyUserNormals command.

Note: if explicit normal values are passed to the command then these values will be used for the paste operation instead of the previously copied values.

Scripting Syntax

PasteUserNormals( [InputObjs], [BleedSelection], [X], [Y], [Z], [Local], [Normalize] );

Parameters

Parameter Type Description
InputObjs String List of components.

Default Value: Currently selected components

BleedSelection Boolean True to extend edge/polygon selections to include neighboring vertices.

Default Value: If not specified, the Tweak User Normal tool setting will be used

X Float X value for paste.

Default Value: Use previously copied value

Y Float Y value for paste.

Default Value: Use previously copied value

Z Float Z value for paste.

Default Value: Use previously copied value

Local Boolean True to treat input normal as a local-space normal.

Default Value: false

Normalize Boolean True to normalize during paste.

Default Value: true

Examples

Python Example

# Create a cube and set all the normals to a custom value

app = Application

app.CreatePrim("Cube", "MeshSurface")

app.PasteUserNormals(None, 0, 1, 1, 1)

See Also

CreateUserNormals ResetUserNormals RemoveUserNormals AverageUserNormals SetVertexUserNormals SetPolygonUserNormals InvertUserNormals NormalizeUserNormals CopyUserNormals SetUserNormalValues