ヒントとテクニック

SICO のランタイム

オペレータにスクリプト コードを埋め込むのではなく、自己インストール プラグインをセットアップしてオペレータを定義した方が効率的です。 以下に、基本的な手順を示します。

1. オペレータを作成するコードがまだ自己インストール プラグインにない場合は、Update コールバックと他のコードを直接新しい自己インストール プラグインに配置し、PluginRegistrar.RegisterOperator または PluginRegistrar::RegisterOperator の呼び出しを追加します。

   同じプラグインにオペレータを作成するコマンドとオペレータ自体を含めることができますが、これらを個別のプラグインに分割することもできます。コマンドは実際には必須ではありません。

2. ランタイム オペレータに挿入されるグローバル変数について再検討します。

   • これらの変数がインスタンスごとのキャッシュである場合は、コンテキスト オブジェクトのユーザ データに埋め込む必要があります。 Init コールバックにユーザ データを格納し、それを Term コールバックに解放することができます。

   • これらの変数がオペレータのすべてのインスタンスでグローバルである場合は、プラグインのグローバル変数になります。

3. Update メソッド シグネチャからすべての出力ポート引数と入力ポート引数を削除し、Update コールバックのメイン部分を書き直して、OperatorContext または OperatorContext オブジェクトからこれらを抽出します。入力ポートと出力ポートの実際の値を取得する方法はわずかに異なりますが、これらの構文的な問題が解決されたら、オペレータの実際のアルゴリズムは引き続き機能するはずです。

// ...Creation Code...
	var code = GeometryDeform_Update.toString();
	g_sop = XSIFactory.CreateScriptedOp( "GeometryDeform", code, "JScript" );

	var p1 = g_sop.AddIOPort( g_prim, "", 0, -1, siBranchGroupPort  );			
	var p2 = g_sop.AddInputPort( g_obj.posy, "", 0, -1, siBranchGroupPort  );			

	g_sop.Connect(g_obj);

// Notice that the port connections are passed in as arguments to Update
function GeometryDeform_Update( ctx, Out, Inpolymsh, Inposy )
{
	Application.LogMessage( "GeometryDeform_Update: " + Out.TargetPath + ":" + Inposy.TargetPath );
	
	var arr = Inpolymsh.Value.Geometry.Points.PositionArray.toArray();

	for ( var i=0; i<arr.length; i=i+3 )
	{
	  var x = arr[0+i];
	  var z = arr[2+i];
	  var y = 0;
 
	  var x0 = x;
	  var z0 = z + 1;
	  var l = Math.sqrt(x0 * x0 + z0 * z0)
	  var dif = l - Inposy.Value // In2 can be any value, e.g. posx
	  dif = dif * dif;
	  dif = Math.sqrt(dif);
	 
	  if ( dif < 1 ) {
		y = y + (1 - dif);
	  }
 
	  arr[1+i] = y;
	}
	Out.Value.Geometry.Points.PositionArray = arr;
}

//... from Creation Code (where prim is primitive of a sphere mesh)...
	var op = XSIFactory.CreateObject( "CppGeometryDeform" ) ;

	op.AddIOPort( prim, "", 0, -1, siBranchGroupPort ) ;
	op.AddInputPort( obj.posy, "", 0, -1, siBranchGroupPort ) ;

	op.Connect( ) ;
...

// Notice that only the context object is an argument to Update
function CppGeometryDeform_Update( in_ctxt )
{

	// The OperatorContext gives you access to the input ports
	var prim = ctxt.GetInputValue( 0 /* input primitive of IO port*/ ) ;
	var posyVal = ctxt.GetInputValue( 1 /* posy param */) ;

	var inGeom = prim.Geometry ;
	var arr = inGeom.Points.PositionArray.toArray() ;

	for ( var i=0; i<arr.length; i=i+3 )

	{
	  var x = arr[0+i];
	  var z = arr[2+i];
	  var y = 0;
 
	  var x0 = x;
	  var z0 = z + 1;
	  var l = Math.sqrt(x0 * x0 + z0 * z0)
	  var dif = l - Inposy.Value // In2 can be any value, e.g. posx
	  dif = dif * dif;
	  dif = Math.sqrt(dif);
	 
	  if ( dif < 1 ) {
		y = y + (1 - dif);
	  }
 
	  arr[1+i] = y;
	}

	// The OperatorContext gives you access to the output ports
	var outPrim = ctxt.OutputTarget ;
	outPrim.Geometry.Points.PositionArray( arr ) ;

	return CStatus::OK ;
}

//... from Creation Code (where prim is primitive of a sphere mesh)...
	CustomOperator op = Application().GetFactory().CreateObject( L"CppGeometryDeform" ) ;

	op.AddIOPort( prim, L"", 0, -1, siBranchGroupPort ) ;
	op.AddInputPort( obj.GetParameters().GetItem( L"posy" ), L"", 0, -1, siBranchGroupPort ) ;

	op.Connect( ) ;
...

// Notice that only the context object is an argument to Update
XSIPLUGINCALLBACK CStatus CppGeometryDeform_Update( CRef& in_ctxt )
{

	OperatorContext ctxt( in_ctxt ) ;

	// The OperatorContext gives you access to the input ports
	Primitive prim = ctxt.GetInputValue( 0 /* input primitive of IO port*/ ) ;
	double posyVal = ctxt.GetInputValue( 1 /* posy param */) ;

	Geometry inGeom = prim.GetGeometry() ;
	CVector3Array posArray = inGeom.GetPoints().GetPositionArray();

	for ( LONG i=0 ; i<posArray.GetCount(); i++ )
	{
			CVector3& pos = posArray[i] ;
			pos.PutY( 0.0 ) ;

			CVector3 pos0( pos.GetX(), 0.0, pos.GetZ() + 1.0 )  ;
		
			double l = pos0.GetLength() ;

			double dif = l - posyVal ;
				
			if ( dif < 0 )
				dif = -dif ;

			if ( dif < 1 )
				pos.PutY( 1 - dif ) ;				
	}

	// The OperatorContext gives you access to the output ports
	Primitive outPrim = ctxt.GetOutputTarget() ;
	outPrim.GetGeometry().GetPoints().PutPositionArray( posArray ) ;

	return CStatus::OK ;
}

SPDL/プリセットからSICOへ

レガシー(プリセットベースの)オペレータを、新しい自己インストール カスタム オペレータ API を使用するように変更することは、基本的に、SPDL ベースのパラメータをカスタム プロパティ API を使用できるように変換し、既存のエントリ ポイントを更新して新しいシグネチャに一致させ、いくつかの新しいコールバックを実装して PluginRegistrar または PluginRegistrar でオペレータを登録することです。

1. C++ APIを使用してオペレータを実装する場合は、プロジェクトファイル（.vcproj、.sln）を変更してdllを\Application\Pluginsに出力します（\Application\bin\には出力しません）。

2. オペレータを登録する XSILoadPlugin エントリ ポイントを追加します。

3. SPDL のパラメータ定義を確認し、DefineLayout コールバックに同等のパラメータを作成します。

4. SPDL のポート接続情報を使用して、オペレータを適用するためのコードの出力と入力のリストを作成します。

   • 接続が基本的なもので、複数インスタンス グループやオプションのポートをまったく使用していない場合、オペレータを自動的に適用できます。

   • 接続がオプションまたはダイナミックである場合は、オペレータを手動で適用する必要があります。

   ヒント:

   SPDL には解読が難しい GUID が含まれているため、SPDL ベースのオペレータを含むシーンをロードし、SDK Explorer を使用してそのシーンに接続する実際のオブジェクをインスペクトすると便利です。

5. ただし、オペレータを適用することにした場合、ApplyOp の各呼び出しを検索し、それをマニュアルまたは自動のアプリケーション コードで置き換える必要があります。以下のいずれかの操作を実行できます。

   • AddCustomOp を使用するメニュー コールバックを追加して、Splatter の例の説明に従ってオペレータを作成します。

   • オペレータを適用するカスタム コマンドを追加し、ApplyOp のすべての呼び出しを変更して、新しいコマンドを使用します。「頂点カラー ミキサの例」の説明に従って、オペレータとして同じプラグインに実装できます。

6. 新しいシグネチャ、新しいコンテキスト オブジェクト、および新しい API を使用する Update 関数を変更して、入力と出力を取得します(実際のアルゴリズムは変更できません)。

   • 古い Update コールバックでは、すべてのポート接続を引数として渡すように要求されました。 新しい Update コールバックでは、1 つの引数、つまりコンテキストのみがサポートされています。ここから、ポート接続とカスタム パラメータ(変数)を取得できます。

   • 古い Update コールバックでは、UpdateContext または UpdateContext オブジェクトにアクセスできました。新しい Update コールバックでは、OperatorContext または OperatorContext オブジェクトにアクセスできます。これにより、オペレータのポートおよびカスタム パラメータに簡単にアクセスできるようになりました。

   • OperatorContext または OperatorContext のソースを介して(Context.Source または Context::GetSource を介して)、今までどおり CustomOperator または CustomOperator にアクセスすることができます。ただし、OperatorContext または OperatorContext オブジェクトを使用すれば、より速く効率的にデータにアクセスできます。たとえば、OperatorContext.GetInputValue または OperatorContext::GetInputValue は、指定された入力ポートに接続されているデータを返します。OperatorContext.OutputPort または OperatorContext::GetOutputPort、および OperatorContext.OutputTarget または OperatorContext::GetOutputTarget を使用すれば、オペレータの出力ポートに書き込むことができます。

7. オペレータをテストします。

8. 必要に応じて、シーン ファイルに保存されているオペレータを新しいオペレータで置き換えます。

9. レガシー シーン ファイルが依存し続けない限り、オペレータの SPDL バージョンに関連付けられているプリセット、SPDL、および DLL を削除します。 両方のバージョンが共存しても、問題はありません。