Mute (FCurve)

Introduced

6.0

Description

Sets or returns the fcurve's muted state as a Boolean (true if the fcurve is muted). When an fcurve is muted it will not be evaluated during playback and the corresponding parameter will not be updated. By default this property is false.

C# Syntax

    // get accessor
    Boolean rtn = FCurve.Mute;

    // set accessor
    FCurve.Mute = Boolean;

Examples

JScript Example

    //
    // This example illustrates how to create an fcurve and mute it.
    // That means that the FCurve will not evaluate when the time changes.
    //

    // Create a new scene
    NewScene(null, false);

    // Create a null
    oNull = Application.GetPrim("Null");

    // Get the posx parameter of the null
    oPosX = oNull.posx

    // Create array of time-value pairs
    aKeys = new Array( 30.00, -5.00, 50.00, 5.00 );

    // Create an empty FCurve
    oFCurve = oPosX.AddFCurve2( null, siStandardFCurve );

    // Set the fcurve keys
    oFCurve.SetKeys( aKeys );

    // Get the current Mute value
    bMute = oFCurve.Mute
    Application.LogMessage( 'oFCurve.Mute before = ' + bMute , siInfo )

    // Set the fc Mute to true
    oFCurve.Mute = true
    bMute = oFCurve.Mute
    Application.LogMessage( 'oFCurve.Mute after = ' + bMute, siInfo )

    // Validate that the parameter value does not change when evaluated at different times
    Application.LogMessage( 'X Position at frame 0 : ' + oPosX.Value(0.0) );
    Application.LogMessage( 'X Position at frame 100 : ' + oPosX.Value(100.0) );

    // Produces the following output:
    //
    //INFO : oFCurve.Mute before = true
    //INFO : oFCurve.Mute after = false
    //INFO : X Position at frame 0 : 0
    //INFO : X Position at frame 100 : 0

    // Because the FCurve was muted, the parameter does not update

Autodesk Softimage v7.5