Scripting: PasteUserNormals

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)