Override.AddParameterEntry

Introduced

v7.0

Description

Adds a new entry to override the input parameter and returns the new overriding parameter.

Note: Adding an entry to the override doesn't activate the override parameter automatically, you must first set its value with the SetValue command. Parameter.Value will not activate the override parameter.

Note: This method could return an invalid object in python, use Override.AddParameterEntry2 instead.

C# Syntax

Parameter Override.AddParameterEntry( Parameter in_pObj );

Scripting Syntax

oReturn = Override.AddParameterEntry( Parameter );

Return Value

Parameter

Parameters

Parameter Type Description
Parameter Parameter The parameter to override.

Examples

Python Example

#
# This example demonstrates how to add entries to an override property
#
from win32com.client import constants as c
app = Application
log = app.LogMessage
app.NewScene(None, 0);
pointLight = app.GetPrimLight("Point.Preset", "Point")
# Create/fill the override 
override = pointLight.AddProperty("Override", 0, "PointOverride" );
posx = pointLight.Kinematics.Local.posx
posxOverride = override.AddParameterEntry( posx )
app.SetValue( posxOverride.FullName, -4.0 )
softLightColor = pointLight.Shaders("soft_light").Color
softLightColor.Red = 0.5
softLightColor.Blue = 0.5
softLightColorOverride = override.AddParameterEntry( softLightColor )
app.SIApplyShaderToCnxPoint( "Shaders\\Texture\\Color_Channels\\RGBA_combine.Preset", softLightColorOverride )
log("* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ** ")
log("posxOverride : " + posxOverride.FullName );
log("posxOverride value: " + str(posxOverride.Value) )
log("posxOverride original value: " + str(posxOverride.OriginalValue) )
log("* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ** ")
log("softLightColorOverride : " + softLightColorOverride.FullName );
log("softLightColorOverride value: " + str(softLightColorOverride.Value) )
log("softLightColorOverride source: " + str(softLightColorOverride.Source) )
log("softLightColorOverride original value: " + str(softLightColorOverride.OriginalValue) )
# Output
# INFO : * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ** 
# INFO : posxOverride : Point.PointOverride.posx
# INFO : posxOverride value: -4.0
# INFO : posxOverride original value: 0.0
# INFO : * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ** 
# INFO : softLightColorOverride : Point.PointOverride.light-soft_light-color
# INFO : softLightColorOverride value: light-soft_light-color
# INFO : softLightColorOverride source: Point.PointOverride.RGBA_combine
# INFO : softLightColorOverride original value: <win32com.gen_py.Softimage Object Model Library v1.5.Color instance at 0x480184680>

See Also

Override.RemoveParameterEntry