v6.0
F カーブキーを時間または相対量による値でオフセットします。
注:別の F カーブの KeyCollection の場合、このメソッドを使用すると'Invalid argument'(E_INVALIDARG)エラーが発生します。
F カーブがロックされている場合は、'Access Denied'(E_ACCESSDENIED)エラーが発生します。
FCurve.OffsetKeys( FCurveKeyCollection in_Keys, Object in_FrameOffset, Object in_ValueOffset ); |
FCurve.OffsetKeys( KeyCollection, [FrameOffset], [ValueOffset] ); |
パラメータ | タイプ | 説明 |
---|---|---|
KeyCollection | FCurveKeyCollection | オフセットのキー。 |
FrameOffset | Double |
F カーブの時間をオフセットする相対量。正または負の値を設定できます。 デフォルト値: 0 |
ValueOffset | Double |
F カーブの値をオフセットする相対量。正または負の値を設定できます。 デフォルト値: 0 |
// // This example illustrates how to shift fcurve keys in both time and value. // 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 ); Application.LogMessage( 'Before Offset:', siInfo ); for (var i = 0; i < oFCurve.Keys.Count; i++) { Application.LogMessage( 'Time: ' + oFCurve.Keys(i).Time + ', Value: ' + oFCurve.Keys(i).Value, siInfo ); } oFCurve.OffsetKeys( oFCurve.GetKeysBetween(2,4), 0.2, -5 ); Application.LogMessage( 'After Offset:', siInfo ); for (var i = 0; i < oFCurve.Keys.Count; i++) { Application.LogMessage( 'Time: ' + oFCurve.Keys(i).Time + ', Value: ' + oFCurve.Keys(i).Value, siInfo ); } // Produces the following output: // //INFO : Before Offset: //INFO : Time: 0, Value: 5 //INFO : Time: 1, Value: 6 //INFO : Time: 2, Value: 7 //INFO : Time: 3, Value: 8 //INFO : Time: 4, Value: 9 //INFO : Time: 5, Value: 10 //INFO : After Offset: //INFO : Time: 0, Value: 5 //INFO : Time: 1, Value: 6 //INFO : Time: 2.2, Value: 2 //INFO : Time: 3.2, Value: 3 //INFO : Time: 4.2, Value: 4 //INFO : Time: 5, Value: 10 |