Sets the source (DataSource) of the AnimationSourceItem as a StaticSource. There are two ways you can
use this method:
(1) Specify a new StaticSource
source (eg., after creating a new AnimationSourceItem with ActionSource.AddSourceItem()
).
(2) Replace an existing DataSource with a StaticSource source.
StaticSource AnimationSourceItem.SetAsStatic( Object in_vValue ); |
oReturn = AnimationSourceItem.SetAsStatic( [Value] ); |
Parameter | Type | Description |
---|---|---|
Value | Variant | The value of the static value (has to be a double) |
/* This example llustrates some of the different ways you can work with the value of an AnimationSourceItem's StaticSource, from creating using AddSourceItem and SetAsStaticValue to editing an existing static value using the GetSournce/PutSource combo. */ app = Application; NewScene( null, false ); var root = ActiveSceneRoot; // New static ActionSource MakeStaticActionSource(); var n = root.FindChild( "", siNullPrimType ); // Get the ActionSource from the model & instantiate it as a clip var src = root.Sources(0); AddClip( root, src ); // Find the clip var mxr = root.Mixer; var clp = mxr.Clips(0); app.LogMessage( "BEFORE source modifications:" ); PrintClipInfo( clp ); // Get the AnimationSourceItem var srcitems = src.SourceItems; var oldSrcItem = srcitems(0); // Use AnimationSourceItem.GetSource to get the StaticSource and then change its value var sv = oldSrcItem.Source; sv.Value = 2.5; // Print the values on the action source after modifications to the source app.LogMessage( "AFTER source modifications:" ); PrintClipInfo( clp ); // Expected results: //INFO : BEFORE source modifications: //INFO : Reporting on Mixer.Mixer_Anim_Track.Action_Clip clip: //INFO : - Source used = Sources.Scene_Root.Action //INFO : --- SrcItem #0 target = MyAnimatedNull.kine.local.posx and its datasource is a StaticSource //INFO : (evaluates to 0) //INFO : --- SrcItem #1 target = MyAnimatedNull.kine.local.posy and its datasource is a StaticSource //INFO : (evaluates to 1) //INFO : --- SrcItem #2 target = MyAnimatedNull.kine.local.posz and its datasource is a StaticSource //INFO : (evaluates to 2) //INFO : //INFO : AFTER source modifications: //INFO : Reporting on Mixer.Mixer_Anim_Track.Action_Clip clip: //INFO : - Source used = Sources.Scene_Root.Action //INFO : --- SrcItem #0 target = MyAnimatedNull.kine.local.posx and its datasource is a StaticSource //INFO : (evaluates to 2.5) //INFO : --- SrcItem #1 target = MyAnimatedNull.kine.local.posy and its datasource is a StaticSource //INFO : (evaluates to 1) //INFO : --- SrcItem #2 target = MyAnimatedNull.kine.local.posz and its datasource is a StaticSource //INFO : (evaluates to 2) //INFO : // Convenience funtion to print out information about the clip's source function PrintClipInfo( in_clip ) { var app = Application ; // Clip app.LogMessage( "Reporting on " + in_clip + " clip:" ); // Clip's source PrintSourceInfo( in_clip.Source ); } // Convenience function to print out information about the source function PrintSourceInfo( in_src ) { var app = Application ; // Source app.LogMessage( " - Source used = " + in_src ); // Source's items var itemsRef = in_src.SourceItems; for ( var i=0; i<itemsRef.Count; i++ ) { var animsrcitm = itemsRef(i); app.LogMessage( " --- SrcItem #" + i + " target = " + animsrcitm.Target + " and its datasource is a " + ClassName(animsrcitm.Source) ); // Underlying data source is an FCurve if ( animsrcitm.Source.isclassof(siFCurveID) ) { var fc = animsrcitm.Source; app.LogMessage( " (evaluates to " + fc.Eval(30.0) + " at frame 30)" ); } // Underlying data source is a StaticSource if ( animsrcitm.Source.isclassof(siStaticSourceID) ) { var sv = animsrcitm.Source; app.LogMessage( " (evaluates to " + sv.Value + ")" ); } } // Extra blank line app.LogMessage( "" ); } // Create a simple actionsource based on static values function MakeStaticActionSource() { var app = Application; var root = app.ActiveSceneRoot; var n = root.AddNull( "MyAnimatedNull" ); // Get the relative names for the parameter targets var rposx = GetRelativeNameForTarget( n.posx ); var rposy = GetRelativeNameForTarget( n.posy ); var rposz = GetRelativeNameForTarget( n.posz ); // Create an empty action source var src = root.AddActionSource(); // Populate it with a static value using ActionSource.AddSourceItem (default=0.0) src.AddSourceItem( rposx ); // Populate it with a specified static value using ActionSource.AddSourceItem src.AddSourceItem( rposy, 1.0, true ); // Populate it with the default static value, then set a real value later with AnimationSourceItem.SetAsStatic var animsrcitem = src.AddSourceItem( rposz ); animsrcitem.SetAsStatic( 2.0 ); } function GetRelativeNameForTarget( in_param ) { var mdlname = in_param.Model.FullName; if ( mdlname == "Scene_Root" ) { return in_param.FullName; } else { var tmp = in_param.FullName; var re = new RegExp( mdlname + ".", "i" ); return tmp.replace( re, "" ); } } |