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