v2.0
Applies a deformation by cage. Cage deformations allow you to use a
low-resolution geometry to drive the deformation of a high-resolution
object. They are similar to arbitrarily shaped lattices.
Each point on the deformed object is weighted to the points or polygons
on the cage, similarly to how an envelope's points are weighted to its
deformers. However, you cannot paint the weight assignments nor adjust
them manually. You can also have multiple cage deformations on the same
object, unlike envelopes.
This is the equivalent of using the ApplyOp command
with the CageDeform operator. For more information on operators and
their connection sets, see OpPreset.
oReturn = ApplyDeformByCage( [ConnectionSet], [ConstructionMode] ); |
Returns an XSICollection that contains the CageAutoAssignOp and CageDeformOp operators created.
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 the deformer (cage) objects. See OpPreset for details on the connection set required for this operator. Default Value:
Currently selected objects are used as the main group. |
ConstructionMode | siConstructionMode |
The mode indicating the purpose of the deformations. Default Value: Current construction mode. |
'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" ) ApplyDeformByCage obj & "," & obj1 & ";" & cage 'If we deform the cage, it will deform obj and obj1: ApplyOp "Taper", cage, 3, siPersistentOperation |