RemoveAnimation

カテゴリ

アニメーション

詳細

特定のパラメータからアニメーション(F カーブ、エクスプレッション、コンストレイント)を削除します。 このコマンドを使ってアニメーションを削除した後、どの種類のパラメータを指定するかも指定できます。

デフォルトでは、現在のフレームのパラメータ値が新しい値として設定されます。 しかし、Frame 引数が指定されている場合は、指定フレームのパラメータ値から値を取得し、新しい値として設定します。 注: コンストレイントの場合、指定されたパラメータからだけでなく、影響するすべてのパラメータからコンストレイントが削除されます。

スクリプト構文

RemoveAnimation( [InputObjs], [Time], [StaticFCurves], [BaseAnimation], [LayerAnimation], [SourceMask] );

パラメータ

パラメータ タイプ 詳細
InputObjs 文字列 アニメート可能なパラメータのリスト (例: cone*/kine.local.pos)。

デフォルト値:現在選択され、マーキングされているパラメータ

Time ダブル アニメーションが削除されると、このフレームのアニメートされた値がパラメータに割り当てられます。

デフォルト値: 現在のフレーム

StaticFCurves ブール True の場合はスタティック(コンスタント) F カーブのみを削除します。

デフォルト値: False

BaseAnimation ブール True の場合、このコマンドによってベース レイヤ上のアニメーションが削除されます。

デフォルト値: True

LayerAnimation ブール True の場合、このコマンドによってベース レイヤを除くすべてのレイヤ上のアニメーションが削除されます。

デフォルト値: True

SourceMask siSourceType 削除するアニメーション ソースのタイプ

デフォルト値: siAnySource

VBScript の例

'
' This example sets up some animation on an object on both
' the X and Y positions. Then it demonstrates two different 
' ways to remove the replace the animation while removing it:
' first by passing a specific frame; and then by using the
' (default) current frame.
'
NewScene , false
' Create the object on which to set an expression
set oDonut = CreatePrim( "Torus", "NurbsSurface" )
' Make sure the last frame will be set to 100
SetValue "PlayControl.Out", 100
' Set a key frame at frame 1, with XPos = -30
printInfo oDonut & ".kine.local.posx", Array( 1 ), "before"
SaveKey oDonut & ".kine.local.posx", 1, -30
printInfo oDonut & ".kine.local.posx", Array( 1 ), "after"
' Set another key frame at frame 100, with XPos = 30
printInfo oDonut & ".kine.local.posx", Array( 100 ), "before"
SaveKey oDonut & ".kine.local.posx", 100, 30
printInfo oDonut & ".kine.local.posx", Array( 100 ), "after"
' Temporarily disable cycle checking (this 
' expression creates a cycle on purpose)
bCyclePref = GetValue( "preferences.data_management.disable_cycle_checking" )
SetValue "preferences.data_management.disable_cycle_checking", True
' Animate the YPos parameter with an expression
SetExpr oDonut & ".kine.local.posy", _
                "5*sin(" & oDonut & ".kine.local.posx * 15)"
' Restore cycle checking to its previous value
SetValue "preferences.data_management.disable_cycle_checking", bCyclePref
' Remove the YPos expression and freeze Y at the value of 
' the animation expression at frame 53
printInfo oDonut & ".kine.local.posy", Array( 1,50,53,100 ), "before"
RemoveAnimation oDonut & ".kine.local.posy", 53
printInfo oDonut & ".kine.local.posy", Array( 1,50,53,100 ), "after"
' Set current frame to 50
SetValue "PlayControl.Current", 50
' Remove XPos fcurve and freeze X at the value of the 
' fcurve at the current frame (frame 50)
printInfo oDonut & ".kine.local.posx", Array( 1,50,53,100 ), "before"
RemoveAnimation oDonut & ".kine.local.posx" 
printInfo oDonut & ".kine.local.posx", Array( 1,50,53,100 ), "after"                
' This is a convenience function for printing out the info easily
function printInfo( in_parameter, in_frame, in_loc )
        LogMessage "-----"
        for each f in in_frame
                LogMessage in_parameter & " parameter at frame " & f & " " _
                                        & in_loc & " updating = " & GetValue( in_parameter, f )
        next
end function
' Output of above script:
' INFO : -----
' INFO : torus.kine.local.posx parameter at frame 1 before updating = 0
' INFO : -----
' INFO : torus.kine.local.posx parameter at frame 1 after updating = -30
' INFO : -----
' INFO : torus.kine.local.posx parameter at frame 100 before updating = -30
' INFO : -----
' INFO : torus.kine.local.posx parameter at frame 100 after updating = -30
' INFO : -----
' INFO : torus.kine.local.posy parameter at frame 1 before updating = -5
' INFO : torus.kine.local.posy parameter at frame 50 before updating = -0.593575239181519
' INFO : torus.kine.local.posy parameter at frame 53 before updating = 2.80044293403625
' INFO : torus.kine.local.posy parameter at frame 100 before updating = 5
' INFO : -----
' INFO : torus.kine.local.posy parameter at frame 1 after updating = 2.80044293403625
' INFO : torus.kine.local.posy parameter at frame 50 after updating = 2.80044293403625
' INFO : torus.kine.local.posy parameter at frame 53 after updating = 2.80044293403625
' INFO : torus.kine.local.posy parameter at frame 100 after updating = 2.80044293403625
' INFO : -----
' INFO : torus.kine.local.posx parameter at frame 1 before updating = -30
' INFO : torus.kine.local.posx parameter at frame 50 before updating = -0.45452999539318
' INFO : torus.kine.local.posx parameter at frame 53 before updating = 2.27079487869202
' INFO : torus.kine.local.posx parameter at frame 100 before updating = 30
' INFO : -----
' INFO : torus.kine.local.posx parameter at frame 1 after updating = -0.454529995393187
' INFO : torus.kine.local.posx parameter at frame 50 after updating = -0.454529995393187
' INFO : torus.kine.local.posx parameter at frame 53 after updating = -0.454529995393187
' INFO : torus.kine.local.posx parameter at frame 100 after updating = -0.454529995393187

関連項目

Parameter.Disconnect AddFCurve RemoveAllAnimation SaveKey RemoveKey NextKey PrevKey FirstKey LastKey