## ApplyOperator

### Introduced

v1.0

### Description

Applies an operator on a single object. ApplyOperator acts on one input object at a time (it only creates and connects one operator at a time). To apply the same operator to multiple objects at once, use ApplyOp instead. For a list of available operators, see OpPreset.
This command supports both group-level and port-level ConnectionSets. The syntax for group-level and port-level connection sets differs slightly in that group-level connection sets can accept objects and resolve the underlying port connections. For more information, see the ConnectionSet topic.
Note: ApplyOperator doesn't create output objects. It expects them to be supplied in the connection set or the input list.

### Scripting Syntax

    oReturn = ApplyOperator( PresetObj, [ConnectionSet], [ConnectType] );

### Return Value

Returns the Operator Name of the newly created operator.

### Parameters

Parameter | Type | Description
--- | --- | ---
PresetObj | String or a preset object (for example, an object obtained from SIGetPreset) | An Operator Preset.
ConnectionSet | ConnectionSet | Specifies the objects connected to an operator. See Operator Presets for details on the connection set required for this operator. 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.
ConnectType | siBranchFlag | Specifies the type of connection. Default Value: siUnspecified

### Examples

#### VBScript Example

    '
    ' Apply a twist to a single object
    '
    CreatePrim "Sphere", "MeshSurface"
    set twistop = ApplyOperator( "Twist", "Sphere")
    Application.LogMessage twistop
    SetValue twistop & ".angle", 30
    '========================================================
    'OUTPUT:
    'INFO : "sphere.polymsh.twistop"
    SetValue "sphere.polymsh.twistop.angle", 30

### See Also

ApplyOp ApplyGenOp ApplyTopoOp ApplyHairOp Operator