AddCustomOp

Introduced

5.1

Description

Creates an instance of a Self-Installed Custom Operator and connects it to the specified inputs and outputs.

This command is a convenient way to instantiate most self-installed custom operators, because it combines the functionality of calls to CustomOperator.AddInputPort, CustomOperator.AddOutputPort, CustomOperator.AddIOPort, and Operator.Connect in a single command.

The objects in the input and output lists must be the specific data that that the operator will read or write. For example it is illegal to specify an X3DObject as the input or output, but objects of type Cluster, Property, Parameter, Primitive or KinematicState can all be valid connections.

This command is only suitable for creating operators that are defined inside a self-installed plug-in. To instantiate a Preset-based operator use ApplyOp. To instantiate a runtime operator use AddScriptedOp.

This command creates all the connections by adding Ports to a single PortGroup and assumes that all the objects to be connected to the operator already exist in the scene.

Note: To define a more dynamic operator that uses more than one PortGroup, it is necessary to use the more advanced methods on the CustomOperator object rather than this command.

Scripting Syntax

    AddCustomOp( Type, OutputObjs, [InputObjs], [Name], [ConstructionMode] )

Parameters

Parameter | Type | Description
Type | String | Name of the Self-Installed PluginItem that implements the Operator. This command will fail if the plug-in is not installed.
OutputObjs | List | The output connections for the operator. If nothing is specified the current Selection is used. Most operators only connect to a single Output object.
InputObjs | List | The input connections for the operator. If nothing is specified then the operator will have no inputs. Default Value: "" (empty list)
Name | String | The name of the new operator. Default Value: If not specified the Type argument will be used to name the operator.
ConstructionMode | siConstructionMode | Specifies under which construction mode the operator will be applied. This only applies to output connections made to Geometry objects, the mode will be ignored for all other types of connections. Default Value: Use the current construction mode

Return Value

The newly created CustomOperator.

Examples

1. JScript Example

    /*
       Create an operator called "DemoOp". The type of the operator is "EmptyOp", which
       is a very basic operator that does nothing.

       This operator reads from a Local transform of a Null and the Geometry of a Sphere
       and outputs to the Global transform of another Null
    */
    NewScene( null, false );
    var oOutput = ActiveSceneRoot.AddNull( "Out" ).Kinematics.Global ;

    var oInput1 = ActiveSceneRoot.AddNull( "In1" ).Kinematics.Local ;
    var oInput2 = ActiveSceneRoot.AddGeometry( "Sphere", "MeshSurface", "In2" ).ActivePrimitive ;

    var oOp = AddCustomOp(
                  "EmptyOp",
                  oOutput,
                  [oInput1,oInput2],
                  "DemoOp"
              ) ;

2. JScript Example

    /*
       Create an operator called DemoParamOp that outputs to the PosX parameter of
       the global transform of a null.

       This operator is of type "EmptyOp" and it has no inputs so its only effect
       is to force the value of the parameter to remain at 0.0
    */
    NewScene( null, false );

    var oOutput = ActiveSceneRoot.AddNull( "Out" ).Kinematics.Global.Parameters( "posx" ) ;

    var oOp = AddCustomOp(
                  "EmptyOp",
                  oOutput,
                  null,
                  "DemoParamOp"
              ) ;

3. JScript Example

    /*
       Create an operator called DemoManyInputs that reads from the visibility
       property of ten nulls and outputs to the geometry of a Grid. Because it
       uses the EmptyOp operator, it does nothing.
    */

    var oInputs = new ActiveXObject( "XSI.Collection" ) ;

    for ( var i = 0 ; i < 10 ; i++ )
    {
       var oNull = ActiveSceneRoot.AddNull( "Input" + i ) ;

       oInputs.Add( oNull.Properties( "Visibility" ) ) ;
    }

    var oGrid = ActiveSceneRoot.AddGeometry( "grid", "MeshSurface", "Output" ) ;

    SelectObj( oGrid.ActivePrimitive ) ;

    AddCustomOp(
           "EmptyOp",
           null,     // Softimage will use the selection
           oInputs,
           "DemoManyInputs"  ) ;

See Also

Parameter.AddCustomOp | ProjectItem.AddCustomOp | AddScriptedOp | ApplyOp
CustomOperator | PluginRegistrar.RegisterOperator | XSIFactory.CreateObject |

Autodesk Softimage v7.5