v4.0

カスタムオペレータに新しい PortGroup を作成し、戻します。

通常のカスタムオペレータには 1 つの PortGroup だけが必要ですが、ダイナミックオペレータでは、動的に接続される必要がある入力ポートや複数のインスタンスを伴う入力ポートに対して別の PortGroup を作成する必要があります。

注：オペレータでブランチグループがサポートされている場合は、フィルタが、許可されているコンポーネントとしてのグループと一致する必要もあります。一致しない場合は、Operator.Connect の呼び出し時にグループは拒否されます。

PortGroup CustomOperator.AddPortGroup( String Name, Int32 groupmin, Int32 groupmax, String filterid, String PickPrompt, Int32 Flags );

oReturn = CustomOperator.AddPortGroup( Name, [Min], [Max], [Filter], [PickPrompt], [Flags] );

新しく作成された PortGroup オブジェクトを戻します。

パラメータ	タイプ	説明
Name	String	ポートの名前。
Min	Long	有効な接続に必要な最小のオブジェクト デフォルト値： 1
Max	Long	有効な接続に必要な最小のオブジェクト デフォルト値： 1
Filter	String	オブジェクトをグループに接続できるかどうかを決定するために使用するフィルタ デフォルト値：""（フィルタは定義されません）
PickPrompt	String	オペレータに接続するオブジェクトを選択する選択セッション中にステータスバーに表示される文字列 デフォルト値：""（選択対象は定義されません）
Flags	Long	ポートグループフラグのマスク（実装されていません） デフォルト値：0（フラグは定義されません）

JScript の例

/*

	This example illustrates how to use the AddPortGroup method to define 

	a PortGroup. Use this method if you want to determine the number

	of objects that can be connected to the group or restrict the 

	types of objects connecting to the group by using a filter.

*/

NewScene( null, false );

var obj = CreatePrim( "Cube", "MeshSurface");

var sop = XSIFactory.CreateScriptedOp( "MyOperator", MyOperator_Update.toString(), "JScript" )

var group = sop.AddPortGroup( "MainGroup", 1, 1, siPolyMeshFilter, "please pick a polygon mesh" );

sop.AddIOPort( obj.ActivePrimitive, "", group.Index );

sop.Connect();

// The operator's update function

function MyOperator_Update( ctx, out, in1 ) 

{

	Application.LogMessage( "MyOperator_Update: " + out.Value );

	var aPos = in1.Value.Geometry.Points.PositionArray.toArray();

	out.Value.Geometry.Points.PositionArray = aPos;

}