オペレータとその他へのアクセス

オペレータは適用すると、削除するまで「オペレータスタック」と呼ばれるスタック上に置かれます(オペレータは一般にスタックのフリーズ操作で削除されます)。このスタックはオブジェクトの履歴も追跡するので、「コンストラクションヒストリ」とも呼ばれます。オブジェクトモデルは Primitive.ConstructionHistory プロパティを介して ConstructionHistory オブジェクトにアクセスします。これはオペレータにアクセスするためにコンストラクションヒストリを列挙するときに使用できます。詳細については、「オペレータスタック」を参照してください。

オペレータで実現できる内容

オペレータへのポインタを取得したら、以下のメソッドを使用してオペレータの入力ポート(オペレータのデータ変更を制御する値)と出力ポート(制御されているパラメータなど)にアクセスできます。

オブジェクトモデルの場合: Operator.InputPorts および Operator.OutputPorts
C++ API の場合: Operator::GetInputPorts および Operator::GetOutputPorts

ポートを元に、ポートが接続されているオブジェクトへのポインタを取得できます。これには Port.Target2(オブジェクトモデル)と Port::GetTarget(C++ API)を使用します。

ヒント:

UI に入力ポートと出力ポートを表示するには、SDK Explorer([表示](View)[スクリプト](Scripting))を開き、オペレータをクリックしてからメインのコンテンツペインの上にある[Object Details]リンクをクリックします。

オペレータは、現在書き込み先のオブジェクトに応じて[Scene Explorer]に表示されるので(つまり、オペレータが作成または修正しているオブジェクトのオペレータスタックに表示されるので)、[Scene Explorer]内の複数個所に同時に表示される場合があります。

オペレータスタック

SDK の場合、オペレータスタックはコンストラクションヒストリと呼ばれます。絶えず繰り返されるオブジェクへの変更をそれぞれ把握しているからです。つまり、オブジェクトをフリーズするまで、オブジェクトに適用した各オペレータを把握しているということです。オペレータスタックは以下の 4 つのコンストラクションモード領域に分類されます。

領域名	説明	フルネームから戻される名前
モデリング	デフォーメーションとトポロジの両オペレータを使用して、オブジェクトの基本的なシェイプとトポロジを定義します。	modelingmarker
シェイプモデリング	Cluster Shape Combiner ノードを格納します。また、シェイプアニメーションのシェイプキーを定義するためにデフォーメーションを適用できます。	shapemarker
アニメーション	モデリングのフリーズまたはシェイプの適用時に、アニメートされたデフォーメーションが削除されることを防ぎます。	animationmarker
2 次シェイプモデリング	エンベロープされたキャラクタ上の筋肉バルジなどのシェイプキーを作成するために使用します。	secondaryshapemarker

オペレータが適用されるとすぐにコンストラクションヒストリが構築されます。このコンストラクションヒストリには、上記の 4 つのマーカー以外に新しいオペレータも含まれます。コンストラクションヒストリ内のオペレータを列挙すると、これらの 4 つのマーカーはフルネームで報告されます(上の表の第 3 列目に記載している名前です)。したがって、希望のオペレータが実際に適用されているかどうかを確認するため、コンストラクションヒストリの各アイテムをテストすることが可能です。

オペレータスタック/コンストラクションヒストリの操作

シーンオブジェクトに適用したオペレータを調べるには、オブジェクトの ConstructionHistory の内容を参照する必要があります。ConstructionHistory は Primitive.ConstructionHistory プロパティを通じてアクセスできます(コンストラクションモード領域の操作方法のスクリプト例については「JScript の例: 特定のコンストラクション領域からのオペレータ選択」を参照)。

注:

現在、Primitive.ConstructionHistoryプロパティはオブジェクトモデルでのみ使用できます。ただし、CComAPIHandler を使用することにより、C++ API プラグインはプリミティブに接続されているオペレータにアクセスできます(例については、「C++ の例: CComAPIHandler を使ったコンストラクションヒストリへのアクセス」を参照)。

JScript の例: 特定のコンストラクション領域からのオペレータ選択

この例では、立方体を作成し、いくつかのオペレータを異なるコンストラクションモードで適用しています。その後に、オペレータスタックが読み取られています。そのため、アニメーションコンストラクションモード領域に分類されるオペレータのみが対象となっています。

// Set up a scene with a cube and apply a variety of deform operators
// in a variety of construction modes
NewScene( null, false );
var obj = CreatePrim( "Cube", "MeshSurface" );
ApplyOp( "Bulge", "cube", 3, siPersistentOperation, null, 0 );
ApplyOp( "Bend", "cube", 3, siPersistentOperation, null, 0 );
SetValue( "Context.ConstructionMode", 2 );
ApplyOp( "Fold", "cube", 3, siPersistentOperation, null, 2 );
ApplyOp( "Shear", "cube", 3, siPersistentOperation, null, 2 );
SetValue( "Context.ConstructionMode", 3 );
ApplyOp( "Smooth", "cube", 3, siPersistentOperation, null, 3 );


// Get the cube's operator stack/construction history and browse it...
var opstack = new Enumerator( obj.ActivePrimitive.ConstructionHistory );
var getanimops = false;
for ( ; !opstack.atEnd(); opstack.moveNext() ) {
	var op = opstack.item();
	Application.LogMessage( "Current node: " + op.FullName );

	// Use RegularExpression matching to identify the markers in the stack
	var beginregion = false;
	if ( op.FullName.match(/marker/i) != null ) {
		beginregion = true;
	} else {
		beginregion = false;
	}
	
	// Grab only animation operators
	if ( !beginregion && getanimops ) {
		Application.LogMessage( "\tFound this animation operator: " + op.Name );
	}
	
	// Figures out when we're in the Animation region
	if ( beginregion ) {
		if ( op.FullName.match(/animationmarker/i) != null ) {
			getanimops = true;
		} else {
			getanimops = false;
		}
	}
}

//INFO : Current node: cube.polymsh.secondaryshapemarker
//INFO : Current node: cube.polymsh.smoothop
//INFO : Current node: cube.polymsh.animationmarker
//INFO : Current node: cube.polymsh.shearop
//INFO : 	Found this animation operator: Shear Op
//INFO : Current node: cube.polymsh.foldop
//INFO : 	Found this animation operator: Fold Op
//INFO : Current node: cube.polymsh.shapemarker
//INFO : Current node: cube.polymsh.modelingmarker
//INFO : Current node: cube.polymsh.bendop
//INFO : Current node: cube.polymsh.bulgeop
//INFO : Current node: cube.polymsh.geom

C++ の例: CComAPIHandler を使ったコンストラクションヒストリへのアクセス

この例では、コンストラクションヒストリにアクセスするために CComAPIHandler オブジェクトを使用して、Primitive に接続されたオペレータの CRefArray を作成する方法を示します。

// Given an X3DObject (e.g. a mesh or nurbs), fills in an array with all the operators connected to its
// primitive.	This function is suitable for re-use in any plug-in that wants to access construction history
void GetOperators( X3DObject in_ops, CRefArray & out_ops )
{
	Primitive primitive = in_ops.GetActivePrimitive() ;
	CComAPIHandler comPrimitive( primitive.GetRef() ) ;

	CComAPIHandler constructionHistory = comPrimitive.GetProperty( L"ConstructionHistory" ) ;
	
	// Currently there isn't a "Count" or "Item" property on the ConstructionHistory 
	// scripting object, so we use Filter to find all operators
	CValue valOperatorCollection	;
	CValueArray args(3)	;
	args[1] = CValue( L"Operators" ) ;	// We want all operators (siOperatorFamily)
	constructionHistory.Call( L"Filter", valOperatorCollection, args ) ;
	

	// Now convert from a OperatorCollection object to a C++ CRefArray
	CComAPIHandler comOpColl = valOperatorCollection ;
	CValue cnt = comOpColl.GetProperty( L"Count" ) ;
	
	CRefArray ops( (LONG)cnt ) ;
	
	for ( LONG i=0 ; i<(LONG)cnt; i++ )
	{
		CValue outOp;
		CValueArray itemsArgs;
		itemsArgs.Add( i );
		comOpColl.Invoke(L"Item", CComAPIHandler::PropertyGet, outOp, itemsArgs);
	
		ops[i] = outOp ;
	}
	
	out_ops = ops ;
}