SIApplyDeformByCage

Introduced

2.0

Description

Applies a deformation by cage.

Scripting Syntax

SIApplyDeformByCage( [ConnectionSet], [Interactive], [ConstructionMode] )

Parameters

Parameter

Type

Description

ConnectionSet [in/out]

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 Operator Presets 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

Return Value

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

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


Autodesk Softimage v7.5