## SIApplyDeformByCage

### Introduced

v2.0

### Description

Applies a deformation by cage.

### Scripting Syntax

    oReturn = SIApplyDeformByCage( [ConnectionSet], [Interactive], [ConstructionMode] );

### Return Value

Returns an XSICollection that contains the CageAutoAssignOp and CageDeformOp operators created.

### Parameters

Parameter | Type | Description
--- | --- | ---
ConnectionSet | ConnectionSet | Specifies the objects connected to an operator. The first group of the ConnectionSet contains vertex based objects. The second group of the ConnectionSet contains geometric objects. See OpPreset for details on the connection set required for this operator. Default Value: Currently selected objects are used as the main group. Warning: An error occurs if the connection set is invalid. Please verify the connection set required for this operator to avoid breaking your scripts.
Interactive | Boolean | True to prompt user to pick objects. Default Value: False
ConstructionMode | siConstructionMode | Specifies in which construction mode to apply the operator. Default Value: Use the current construction mode

### Examples

#### VBScript Example

    'This example creates a cage deformer (cube) over a sphere and a torus.
    'Then, the cube is deformed by a taper, and the deformation is reflected
    'on the sphere and the torus because of the DeformByCage operator.
    NewScene
    dim obj, obj1, cage
    set obj = CreatePrim( "Sphere", "MeshSurface" )
    set obj1 = CreatePrim( "Torus", "MeshSurface" )
    set cage = CreatePrim( "Cube", "MeshSurface" )
    'Apply the DeformByCage, with no picking session
    SIApplyDeformByCage obj & "," & obj1 & ";" & cage, False
    'If we deform the cage, it will deform obj and obj1:
    ApplyOp "Taper", cage, 3, siPersistentOperation