AddParameterEntry (Override)

Introduced

7.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.

Scripting Syntax

Override.AddParameterEntry( Parameter )

C# Syntax

Parameter Override.AddParameterEntry( Parameter in_pObj );

Parameters

Parameter

Type

Description

Parameter

Parameter

The parameter to override.

Return Value

Parameter

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



Autodesk Softimage v7.5