Introduced
1.0
Description
Returns the connection set group specifying an operator's input objects. When used with ApplyOp and ApplyOperator, it allows picking objects to apply an operator to if no input objects are supplied by the caller, or if secondary objects are required.
Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference. Normally you can get the output arguments via either XSIApplication.ExecuteCommand method (C#) or the ISIVTCollection (scripting languages), but this command already returns a value.
The only available workaround in this case is to create a VBScript custom command which returns both the output arguments and the return value in one array. For details, see What Happens when the Function Already Returns a Value?.
Scripting Syntax
GetConnectionSet( PresetObj, [ConnectionSet], [CnxGroupType], [ConnectType], [Interactive], [CreateOutputObjs], [OutputObjs] )
Parameters
|
Parameter |
Type |
Description |
|
PresetObj |
String or a preset object (for example, an object obtained from SIGetPreset) |
An Operator Presets. |
|
ConnectionSet [in/out] |
Specifies the objects connected to an operator. See Operator Presets for details on the connection set required for this operator. Note: Because this is an in/out parameter, any string (variable or value) you pass into this parameter is automatically converted to a ConnectionSet object. Default Value: Current selection. Warning: An error occurs if the connection set is invalid. Please verify the connection set required for this operator to avoid breaking your scripts. |
|
|
CnxGroupType |
Type of output connection set required. Default Value: siGroupLevel |
|
|
ConnectType |
Specifies the type of connection (node or branch). Default Value: siUnspecified |
|
|
Interactive |
True to prompt user to pick objects, if ConnectionSet wasn't specified, or if there is nothing selected. Default Value: False |
|
|
CreateOutputObjs |
True to create output primitive objects required by the operator. Default Value: False |
|
|
OutputObjs [out] |
Returns the primitives created by the operator. For example, Loft creates a primitive surface. |
Return Value
Returns an XSICollection that contains a list of the connection sets created.
See Also
Examples
• See GetConnectionSet.1.vbs
Autodesk Softimage 2011