FCurveKeyCollection.AddItems

導入

v6.0

詳細

既存のコレクションに FCurveKeyCollection を追加します。キーがコレクションの他のキーと同じFCurveにある場合は、そのキーはコレクションに追加されます。既存のコレクションにすでに存在する入力コレクションのキーは、無視されます。

注:FCurveKeyCollection は常にパラメータ順にソートされるので、新しいキーはパラメータ値に応じて正しい位置に挿入されます。

C#構文

FCurveKeyCollection.AddItems( FCurveKeyCollection in_pVal );

スクリプト構文

FCurveKeyCollection.AddItems( Keys );

パラメータ

パラメータ タイプ 説明
Keys FCurveKeyCollection このコレクションに追加するキー

JScript の例

// 

// This example illustrates how to add keys to an existing FCurveKeyCollection.

// 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( 0.00, 5.00,

				1.00, 6.00,

				2.00, 7.00,

				3.00, 8.00,

				4.00, 9.00,

				5.00, 10.00 );

// Create an empty FCurve

oFCurve = oPosX.AddFCurve2( null, siStandardFCurve );

// Set the fcurve keys

oFCurve.SetKeys( aKeys );

// Get two key collections

var keys = oFCurve.GetKeysBetween( 4, 5 );

var keys2 = oFCurve.GetKeysBetween( 0, 1 );

// Merge the two collections

keys.AddItems( keys2 );

// Print out the contents of the collection

for (var i = 0; i < keys.Count; i++) 

{

	Application.LogMessage( 'Time: ' + keys(i).Time + ', Value: ' + keys(i).Value, siInfo );

}

// Produces the following output:

//

//INFO : Time: 0, Value: 5

//INFO : Time: 1, Value: 6

//INFO : Time: 4, Value: 9

//INFO : Time: 5, Value: 10

関連項目

FCurveKeyCollection.Add FCurveKeyCollection.Remove FCurveKeyCollection.RemoveAt