GetFCurveInfo

パラメータのファンクションカーブ情報を取得します。

注: このコマンドは、出力引数を使用します。C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。このため、状況に応じた適切な回避策を実行する必要があります。

スクリプト言語の場合、このコマンドは出力引数を取得するために使用できる ISIVTCollection を戻します。

C# の場合は、XSIApplication.ExecuteCommand メソッドを使用してこのコマンドを呼び出すことができます。ExecuteCommand は、出力引数を C# の System.Object (出力引数の Array を含む)にパック化します(詳細については、「C# からのコマンドの呼び出し」を参照)。

スクリプト構文

パラメータ

パラメータタイプ説明

InputObj 文字列ファンクションカーブのアニメーションソース

CurveKind Integer ファンクションカーブの種類を戻します。

指定可能な値：

説明：

0 不明

10 ブール

15 整数

20 標準

30 ローデータ

ValueWhenNoKey Double キーがない場合は、ファンクションカーブの値を戻します。

NbKeys Integer キーの数を戻します。

ExtrapolationKind Integer ファンクションカーブのエクストラポレーションタイプを戻します。

指定可能な値：

説明：

1 コンスタント

2 リニア

3 周期

DefaultSegKind Integer デフォルトセグメントの種類を戻します。標準のファンクションカーブに適用されます。

指定可能な値：

説明：

0 デフォルト

1 コンスタント

2 リニア

3 キュービック

LowClamp Double クランピング値の下限を戻します。

HighClamp Double クランピング値の上限を戻します。

例

1. VBScript の例

dim source, fcurve

dim crvtype, nokeyval, nbKeys, extrap, seq, lowclamp, highclamp

GetPrim "Null"

' Save some keys on the X position of the Null object

SaveKey "Null.kine.local.posx", 1, -5.0

SaveKey "Null.kine.local.posx", 25, 7.0

SaveKey "Null.kine.local.posx", 50, 2.0

' Get the FCurve animation source

set source = GetSource( "Null.kine.local.posx", siFCurveSource )

for each fcurve in source

	GetFCurveInfo fcurve, crvtype, nokeyval, nbKeys, extrap, seq, lowclamp, highclamp

	Application.LogMessage "Number of keys	: " & nbKeys

	Application.LogMessage "Value when no keys	: " & nokeyval

	Application.LogMessage "Type of fcurve	: " & crvtype

	Application.LogMessage "Extrapolation type	: " & extrap

	Application.LogMessage "Default segment type: " & seq

	Application.LogMessage "Lower clamp bound	: " & lowclamp

	Application.LogMessage "Upper clamp bound	: " & highclamp

next

2. JScript の例

// This example illustrates how to get access to the output

// arguments returned by the GetFCurveInfo command.

// Commands that don't explicitly define a return value but have output

// arguments in fact have an implicit return value which contains collection 

// object ( IVTCollection ). The .value is a method on this object.

// Create scene

NewScene("",false);

GetPrim("Null", null, null);

SetValue("null.Name", "null", null);

CreatePrim("Arc", "NurbsCurve", null, null);

SelectObj("null", null, true);

ApplyCns("Path", "null", "arc", null);

SaveKey("null.kine.pathcns.perc", 1, 0, null);

LastFrame();

SetValue("null.kine.pathcns.perc", 100, null);

SaveKey("null.kine.pathcns.perc", 100, 100, null);

// Get the fcurve from a string path

var col = GetSource("null.kine.pathcns.perc");

var src = col(0); 

// Get the fcurve info

var vtcol = GetFCurveInfo( src );

// Dump the fcurve info

Application.LogMessage( "CurveKind = " + vtcol.value("CurveKind") );

Application.LogMessage( "ValueWhenNoKey= " + vtcol.value("ValueWhenNoKey") ); 

Application.LogMessage( "NbKeys= " + vtcol.value("NbKeys") ); 

Application.LogMessage( "ExtrapolationKind= " + vtcol.value("ExtrapolationKind") ); 

Application.LogMessage( "DefaultSegKind= " + vtcol.value("DefaultSegKind") ); 

Application.LogMessage( "LowClamp= " + vtcol.value("LowClamp") ); 

Application.LogMessage( "HighClamp= " + vtcol.value("HighClamp") );

GetFCurveInfo

詳細

スクリプト構文

パラメータ

例

1. VBScript の例

2. JScript の例

関連項目