CustomOperator.AddPortGroup
 
 
 

CustomOperator.AddPortGroup

Introduced

v4.0

Description

Creates and returns a new PortGroup for the custom operator.

Normal custom operators only need a single PortGroup, but dynamic operators should create a separate PortGroup for any input ports that need to be connected dynamically or with multiple instances.

Note: If the operator has branch group support, then the filter must also match the group as an allowed component. Otherwise, groups will be rejected when Operator.Connect is called.

C# Syntax

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

Scripting Syntax

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

Return Value

Returns the newly created PortGroup object.

Parameters

Parameter Type Description
Name String Name of the port
Min Long Minimum objects required for a valid connection.

Default Value: 1

Max Long Minimum objects required for a valid connection.

Default Value: 1

Filter String Filter to be used to determine whether object can be connected to group.

Default Value: "" (filter not defined)

PickPrompt String The string displayed in the status bar during a picking session for picking objects to be connected to the operator.

Default Value: "" (pick prompt not defined)

Flags Long Mask of port group flags (Not Implemented).

Default Value: 0 (flags not defined)

Examples

JScript Example

/*
        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;
}