v1.0
Updates the connections of an operator for a specific group
given a list of objects. The group of ports to update is specified
with GroupIndex and GroupInstanceIndex. The mapping of these
objects on the operator group ports is governed by the flag
AlreadyRefined. If this flag is true, the objects will be connected
on the ports directly; since this is a one-to-one mapping, the
number of objects should match the number of ports for this group.
If the flag is false, the command will automatically refine the
objects as required by the operator.
The list may contain empty objects: by default these empty objects
are skipped during the update, therefore the current connections
corresponding to the position of the object in the list are left
untouched. This behavior can be changed by setting the flag
ForceDisconnection to true. This flag instructs the command to
disconnect the current connected object only if the corresponding
port is set as optional.
UpdateConnectOnOp( Operator, GroupIndex, GroupInstanceIndex, InputObjs, AlreadyRefined, ForceDisconnect ); |
Parameter | Type | Description |
---|---|---|
Operator | Object | The operator |
GroupIndex | Integer | Id of the type of the group
Default Value: 0 |
GroupInstanceIndex | Integer | The id of the group instance
Default Value: 0 |
InputObjs | List | List of objects to connect |
AlreadyRefined | Boolean | Specifies whether the list of objects is already refined or not |
ForceDisconnect | Boolean | Specifies the behavior of the command when it encounters an empty connection. If it's TRUE and the port corresponding to the empty elem ref is optional, that port will be disconnected, in all other cases it won't do anything. |