コンストレイント

JScript の例: Constraint オブジェクトへのアクセス

// "obj" is a pointer to a constrained object
var cnslist = obj.Kinematics.Constraints;

// Enumerate over the ConstraintCollection
for ( var i=0; i<cnslist.Count; i++ ) {
	var cns = cnslist(0);
	var myself = cns.Constrained; // this should point to the original 'obj'
	var stuckonyou = cns.Constraining; // everyone constraining 'obj'
	var upvect = cns.UpVectorReference; // object used as my upvector reference

	Application.LogMessage( "Constraint type: " + cns.Type );
	Application.LogMessage( "Constrained object: " + myself );
	Application.LogMessage( "# of Constraining objects: " + stuckonyou.Count );
	Application.LogMessage( "UpVectorRef: " + upvect );
}

// So if you had a sphere pose-constrained by a null (with no up-vector 
// reference), you would get something like this:
//INFO : Constraint type: posecns
//INFO : Constrained object: sphere
//INFO : # of Constraining objects: 1
//INFO : UpVectorRef: null

C++ API の例: Constraint オブジェクトへのアクセス

// "obj" is a pointer to a constrained object
Kinematics kine = obj.GetKinematics();
CRefArray cnslist = kine.GetConstraints();

// Enumerate over the CRefArray of Constraints
for ( LONG i=0; i<cnslist.GetCount(); ++i ) {
	CRef ref = cnslist.GetItem(i);
	if ( ref.IsA(siConstraintID) ) {
		Constraint cns(ref);
		X3DObject myself = cns.GetConstrained(); // this should point to the original 'obj'
		CRefArray stuckonyou = cns.GetConstraining(); // everyone constraining 'obj'
		X3DObject upvect = cns.GetUpVectorReference(); // object used as my upvector reference

		app.LogMessage( L"Constraint type: " + cns.GetType() );
		app.LogMessage( L"Constrained object: " + myself.GetName() );
		app.LogMessage( L" # of Constraining objects: " + stuckonyou.GetCount() );
		app.LogMessage( L"UpVectorRef: " + upvect.GetName() );
	}
}

// So if you had a sphere pose-constrained by a null (with no up-vector 
// reference), you would get something like this:
//INFO : Constraint type: posecns
//INFO : Constrained object: sphere
//INFO : # of Constraining objects: 
//INFO : UpVectorRef:

また、コンストレイントに基づくクリップとソースからアニメーション情報を取得することも可能です。 詳細については「コンストレイントとミキサ」を参照してください。

コンストレイント操作の順序

コンストレイント スタックは、被コンストレイント オブジェクトのキネマティクス プロパティの下にネストされたコンストレイントのコレクションです。 UI に表示される順序は一般のオペレータ スタックを反映しています。つまり、最後に適用したコンストレイントがスタックの最上部に表示されます。 SDK を使ってコンストレイントのコレクションにアクセスすると、適用時と同じ順序でコンストレイントを取得します。

複数のコンストレイントをブレンドする

オブジェクトに複数のコンストレイントが適用されており、コンストレイントの比重をブレンドする場合は、Constraint オブジェクトから blendweight パラメータにアクセスします。

// "cns" is a pointer to a constraint
cns.blendweight.Value = .25;// shortcut notation
cns.Parameters("blendweight").Value = .25;// full notation

// "cns" is a pointer to a constraint
cns.PutParameterValue(L"blendweight", 0.75);// use convenience method

CParameterRefArray paramlist = cns.GetParameters();// full notation
Parameter param = paramlist.GetItem(L"blendweight");
param.PutValue(0.75);

アクションとしてコンストレイントを保存する

SDK でアクション ソースを作成する唯一の方法は、StoreAction コマンドを使用することです。StoreAction コマンドはあらゆる種類のアクションを保存するので、そのパラメータを確実に正しく設定する必要があります。 以下に従うべきガイドラインをいくつか示します。

• InputObjs パラメータでは、コンストレイント自体ではなく、影響を受けるパラメータを指定します。 その際、コンストレイントは常にグローバル空間で定義されるので、影響を受けるパラメータは常にグローバル変換のパラメータであることに注意してください。

  もう 1 つ覚えておくべき重要な点は、影響を受けたパラメータを相対名で指定する必要があることです。指定しないと、後でミキサーのクリップとしてこのソースをインスタンス化する場合に、接続に問題が起こることがあります。

• Mode パラメータでは、以下のいずれかの値を指定します。

  • 4 は、コンストレイントのみに基づいてソースを作成する場合。

  • 5 は、F カーブ、式、およびコンストレイントに基づいてソースを作成する場合。

  • 6 は、F カーブ、式、およびコンストレイントに基づき、さらにアニメートされていないパラメータの現在値にも基づいてソースを作成する場合。

• RemoveAnim パラメータでは、TRUE(既定)を指定すると、コンストレイントがアニメートされたパラメータから削除されます。

• AddClip パラメータでは、FALSE(既定)を指定すると、後で AddClip コマンドを実行してミキサにこのソースのインスタンスを作成することができます。

コンストレイントベースのソースとクリップにアクセスする

コンストレイントに基づくアクションソースとクリップは、他のアクション ソースやミキサ クリップと同じようにアクセスできます(詳細は「ソースとクリップ」を参照)。 ただし、コンストレイントベースのソースは完全なコンストレイントを保存しないので、ベースとなるコンストレイント オブジェクトには以下のいずれの方法でもアクセスできません。

• AnimationSourceItem.Source または AnimationSourceItem::GetSource

• MappedItem.Source2 または MappedItem::GetAnimationSource

ソース内のサイクルについて

コンストレイントでサイクルを作成するときは、常に注意が必要です(詳細は「アニメーション(ユーザ)ガイド」を参照)。しかし、ミキサ内のコンストレイントベースのアニメーションで作業する場合は、潜在的なサイクルを見失いやすいので、特に 1 つのオブジェクトから別のオブジェクトにソースをコピーしているときには注意が必要です。

CycleChecking コマンドはこのようなサイクルの検出に役立ちますが、サイクルに対処する機能はありません。唯一の解決策は、シーン内のサイクルを生み出す箇所を修正することで、循環的な依存を取り去ることです。

コンストレイントがオペレータおよび式とコミュニケーションする方法

オペレータと式は、同じオブジェクトのコンストレイントより常に先に評価されます。 オペレータが、コンストレイントで制御されるパラメータからデータを読み取っている場合、オペレータによって引き出されたデータは不適切な場合があります。 この問題の対処法は、null にコンストレイントを適用し、代わりにそこからデータを読み取ることです。