SIAddEntryToOverride

Introduced

v1.0

Categories

property

Description

Adds an entry to an Override property. The type of entry is automatically deducted for each InputObjs. The last parameter is used to resolve conflicts between shader and parameter when both apply to the InputObj. A dialog will pop up in interactive mode to resolve the last parameter when a conflict is detected. In batch, we default to a shader entry.

Scripting Syntax

SIAddEntryToOverride( InputObj, InputObjs, [Type] );

Parameters

Parameter Type Description
InputObj String Override property to add an entry to
InputObjs String List of properties and parameters to add to the Override
Type Integer How to react when a conflict is detected between Shader and Parameter entries

Possible Values:

Description:

-1 Ask user
0 Add Shader entry
2 Add Parameter entry

Examples

VBScript Example

' The following uses SIAddEntryToOverride to add an entry
' to an override property.
NewScene
CreatePrim "Cone", "MeshSurface"
MakeLocal "cone.display", siDefaultPropagation
AddProp "Override"
DeselectAll
SetValue "cone.display.wirecol", 527
logMessage "the cone is drawn in pink"
SIAddEntryToOverride "cone.Override", "cone.display.wirecol"
SetValue "cone.Override.wirecol", 553
logMessage "wirecol has been added to the override"
logMessage "so the cone is now drawn in purple"

See Also

AddProp