オブジェクトモデルメンバの呼び出し

オブジェクトモデルメソッドの呼び出し

C# でのオブジェクトモデルメソッドの使い方は非常に簡単ですが、いくつか注意すべき点があります。

既定の引数

C# では既定の引数をサポートしていません。このため、C# から OM メソッドを呼び出すときに、すべての引数を指定する必要があります。たとえば以下のようになります。

app.LogMessage(str, siSeverity.siInfo);

スクリプティングでは siInfo 値が既定ですが、C# では明示的に指定する必要があります。

出力引数

汎用的な C# オブジェクトクラス(Variant と等価)と out キーワード(これにより出力変数としてフラグされる)で宣言された変数を渡せば、メソッドから出力引数にアクセスできます。メソッドが実行された後、この例で示すように、オブジェクトを正しい Softimage クラスにキャストするだけです。

// Set up the scene
CXSIApplicationClass app = new CXSIApplicationClass();
object[] args = new object[2] { "", false };
app.ExecuteCommand("NewScene", args);
Model root = app.ActiveSceneRoot;
X3DObject cube = root.AddGeometry("Cube", "MeshSurface", "MyCube");

// Start with a Phong, then reconnect a Lambert using Parameter.ConnectFromFile
Material mat = cube.AddMaterial("Phong", false, "MyPhong");
Parameter surface = mat.Parameters["Surface"];
app.LogMessage("currently connected shader: " + surface.Source.FullName, siSeverity.siInfo);

// Declare output arguments as a generic object and use the 'out' keyword
Object oldone;
DataSource lambert = surface.ConnectFromFile("$SI_HOME\\Data\\DSPresets\\Shaders\\Material\\Lambert.Preset", out oldone);
app.LogMessage("currently connected shader: " + surface.Source.FullName, siSeverity.siInfo);

// To successfully retrieve output arguments, cast the generic object back to the correct class 
DataSource oldsrc = (DataSource)oldone;
app.LogMessage("displaced shader: " + oldsrc.FullName, siSeverity.siInfo);

// Output:
// INFO : currently connected shader: MyCube.Material.MyPhong
// INFO : currently connected shader: MyCube.Material.Lambert
// INFO : displaced shader: Sources.Materials.DefaultLib.Material.MyPhong

汎用的なメソッド

オブジェクトモデルの汎用的なメソッドは、C# の汎用的なメソッドに変換されます。

// GetAttribute returns a string Variant in the OM which maps to the generic Object class in C#
Object obj = in_ctxt.GetAttribute("Button");

// To access the string value, a type cast must be performed to String
String str = (String)obj;

// Everything in C# is an Object type, so if a method returns a long you still need to typecast
long n = (long)in_ctxt.GetAttribute("LongAttribute");

ジオメトリインタフェース

オブジェクトモデルのほとんどのインタフェースでは、インスタンスのすべてのメソッドにキャストなしで直接アクセスできます。ところが、ジオメトリコレクションインタフェース(PolygonFaceCollection、NurbsSampleCollection など)の場合、メソッドを呼び出す前にインタフェースを明示的にキャストする必要があります。

PolygonFaceCollection polygons = (PolygonFaceCollection)subcomp.ComponentCollection;
Array aNodeIndexArray = (Array)polygons.PolygonNodePolygonFaceIndexArray;

// Type cast a gain to access FacetCollection.IndexArray
FacetCollection polyFacets = (FacetCollection)polygons;
Array aPolyIndexArray = (Array)polyFacets.IndexArray;

オブジェクトモデルプロパティを呼び出す

C# でプロパティを呼び出すための構文の動作は、JScript を使用した場合の動作とよく似ていますが、型宣言だけが大きく違います。

//JScript
var params = oObject.Kinematics.Global.Parameters;

// C#
ParameterCollection params = oObject.Kinematics.Global.Parameters;

ところが、コレクションや、get- または set- アクセッサを使用しなければならない場合の特別な回避策の扱いに関して、構文的な違いもいくつかあります。

ヒント:

各オブジェクトモデルメンバーは、ユーザがコードの確認に使用できる C# の構文セクションを表示します。さらに、Visual C# ObjectBrowser および Visual Studio .NET のオートコンプリート機能は優れたツールであり、このセクションで扱う問題のいくつかに関する理解を深めるために役立ちます。

コレクションアイテムへのアクセス

コレクションアイテムにアクセスするには、[]構文を使用します。

Parameter posy = oObject.Kinematics.Global.Parameters["posy"];
Parameter posx = oObject.Kinematics.Global.Parameters[0];

コレクションを反復する場合、最も簡単で信頼性の高いアプローチは、C# の foreach ループを使用することです。

ParameterCollection params = oObject.Kinematics.Global.Parameters;
foreach (Parameter p in params) 
{
	app.LogMessage( p.Name + " is a " + p.ValueType.ToString() );
}

プロパティの実装の相違点

オブジェクトモデルで定義される一部のプロパティは、取得と設定に関してさまざまなデータタイプやクラスを使用します。たとえば、XSIApplication.ActiveProject プロパティは、設定に関して String を取り、取得中に Project オブジェクトを返します。

// Won't compile
Project p = xsi.ActiveProject; 

// Last line causes a compiler error
Preferences pref = xsi.Preferences;
ProjectItemCollection proj_itms = pref.Categories;

場合によっては、問題点を解決する代替のメソッドまたはプロパティが存在します。たとえば、XSIApplication.ActiveProject2 は代替のプロパティで Property オブジェクトを返したり設定したりします。

// Alternate version of above snippet:
Project p = xsi.ActiveProject2;

代替のメソッドやプロパティがない場合は、get_ や set_ をプロパティの前に付ける特別な構文を使用して、これをメソッドのように扱うことができます。

// Special syntax as a workaround 
ProjectItemCollection proj_itms = pref.get_Categories;
pref.set_Categories( proj_itms );

この特別な構文を使用する場合、実際にはget-およびset-アクセッサメソッドを使用していることになります。これらのメソッドは、Visual C# ObjectBrowser でオブジェクトのメソッドを検索すると見つかります。

ヒント:

「コマンドおよびスクリプトリファレンス」の各プロパティのページには、get および set アクセッサの基本的な C# 構文の文字列を説明する「C# 構文」のセクションが特別に用意されています。データまたはクラスタイプが指定されているので、個々のアクセッサの使い方を理解することができます。たとえば、以下に示すのは Preferences.Categories ページのセクションです。

// get accessor
Object Preferences.get_Categories();

// set accessor
Preferences.set_Categories( [String pArrayVal] );

この構文を「C# 構文」のセクション(GridData.ColumnCount ページ内)と比較すると、ここでは Int32 値を設定して戻します。

// get accessor
Int32 GridData.ColumnCount();

// set accessor
GridData.ColumnCount( [Int32 out_Columns] );

入力引数のプロパティ

一部のオブジェクトモデルプロパティは 1 つまたは複数の入力引数を取ります。たとえば、 Primitive.Geometry(特定のフレームでジオメトリを取得可能)や FCurveKey.Constraint(指定したコンストレイントが FCurveKey でアクティブかどうかをテスト)などがあります。これらのプロパティの多くには、対応する C# に適したメソッドがあります。リファレンスドキュメントで、プロパティ名の前に「Get」を付け、後に「2」を付けて検索すると、これらが見つかります(たとえば、Primitive.GetGeometry2 や FCurveKey.GetConstraint2 など)。

対応する C# に適したメソッドがない場合は、代わりに get- または set- アクセッサを使用できます。

// Get the geometry at the current frame
Geometry geo = obj.ActivePrimitive.get_Geometry((int)-1);

以下に、入力引数を取るオブジェクトモデルプロパティを示します。