v1.0

Applies an Envelope.

oReturn = ApplyFlexEnv( [ConnectionSet], [AssignNewDeformers], [ConstructionMode] );

An XSICollection containing the new envelope operator.

Warning: If the object already has an envelope operator, this command returns an empty collection. You can avoid this error by always testing the XSICollection.Count of the returned collection or by freezing the object's stack (removes any existing envelope operators).

Parameter	Type	Description
ConnectionSet	ConnectionSet	Specifies the envelope and the bone. 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.
AssignNewDeformers	Boolean	True to automatically assign deformer objects when they are added to existing Envelopes. Default Value: False
ConstructionMode	siConstructionMode	Specifies in which construction mode to apply the envelope. Default Value: Use the current construction mode

VBScript Example

' Build a simple Envelope with no picking required.

CreatePrim "Sphere", "MeshSurface"

Create2DSkeleton -0.019, 3.703, 0.000, -0.795, 0.000, 0.000, 0.000, 0.000, 1.000, 1

AppendBone , 0.000, -3.509, 0.000

SelectObj "sphere", , True

ApplyFlexEnv "sphere;bone,bone1,eff", False

' Add a new chain to the Envelope created above, and assign it automatically.

Create2DSkeleton 1.996, 3.238, 0.000, 3.275, 0.097, 0.000, 0.000, 0.000, 1.000, 1

AppendBone , 1.589, -3.257, 0.000

SelectObj "sphere", , True

ApplyFlexEnv "sphere;bone2,bone3,eff1", True

SIApplyFlexEnv