Scripting: ResetSelectedEffectCurves

ResetSelectedEffectCurves

Introduced

v1.5

Description

Resets the effect curves for the selected object(s) in the selected action clips This will only be called (for now) from the effect contextual menu.

Note: The object where the action clip is defined must be selected before calling this command.

Scripting Syntax

ResetSelectedEffectCurves( Clip );

Parameters

Parameter	Type	Description
Clip	String	Selected Clips Default Value: Current selection

Examples

VBScript Example

'
' This example shows how to create an offset clip effect.
' First, an animation is created on the sphere, and 
' a CreateOffsetEffect is created on the action clip.
' Then, offset keys are added to the Fcurve of the clip effect.
' 
' At the end, ResetSelectedEffectCurves will be called to reset all infos
' on the effect of the current selected object, 
' but keeping the effect.
'
NewScene
CreatePrim "Sphere", "NurbsSurface", "MySphere"
SetValue "PlayControl.Out", 40
' Setting a key frame on XPos at frame 1
SaveKey "MySphere.kine.local.posx", 1, -9.0
' Setting a key frame on XPos at frame 10
SaveKey "MySphere.kine.local.posx", 10, 3.0
' Setting a key frame on XPos at frame 30
SaveKey "MySphere.kine.local.posx", 30,-3.0
' Setting a key frame on XPos at frame 40
SaveKey "MySphere.kine.local.posx", 40, 9.0
' Return to frame 1
SetValue "PlayControl.Current", 1
' Store fcurve into source Actions
StoreAction "MySphere", "MySphere.kine.local.posX", 2, "XPosAction" , True, 1, 40, True, False
' Add a track into the mixer, and add action clip to it.
AddTrack "Scene_Root", "Scene_Root", 0
AddClip "Scene_Root", "Sources.Animation.XPosAction", , "Mixer.Mixer_Anim_Track", 0
' Create an Offset Effect on XPosActionClip
CreateOffsetEffect "Mixer.Mixer_Anim_Track.XPosAction_Clip"
' Goto Frame 15 and set the XPos of the sphere to -3.75.
' When calling cmd SaveOffsetKeys, the system will save
' into the fcurve of offset clip effect the difference
' between the XPos value in the clip, and -3.75
SetValue "PlayControl.Current", 15
Translate "MySphere", -3.75, 0, 0, siAbsolute, siParent, siObj, siX
SaveOffsetKeys "Mixer.Mixer_Anim_Track.XPosAction_Clip",siAllParamsInClip , 15
' Create another offset key (key on the fcurve of the clip effect)
' at frame 30
SetValue "PlayControl.Current", 30
Translate "MySphere", 2, 0, 0, siAbsolute, siParent, siObj, siX
SaveOffsetKeys "Mixer.Mixer_Anim_Track.XPosAction_Clip", siAllParamsInClip, 30
SelectObj "MySphere"
' Now reset the offset effect curve created.
ResetSelectedEffectCurves "Mixer.Mixer_Anim_Track.XPosAction_Clip"
''''''''''''''''''''''''''''''''''''''''''''''''''''''
' To see the result, go to the animation mixer, 
' right-click the XPosAction_Clip, and select Animation Editor
''''''''''''''''''''''''''''''''''''''''''''''''''''''