ApplyFlexEnv

Introduced

1.0

Description

Applies an Envelope.

Scripting Syntax

ApplyFlexEnv( [ConnectionSet], [AssignNewDeformers], [ConstructionMode] )

Parameters

Parameter

Type

Description

ConnectionSet [in/out]

ConnectionSet

Specifies the envelope and the bone. 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.

 

AssignNewDeformers [in/out]

Boolean

True to automatically assign deformer objects when they are added to existing Envelopes.

Default Value: False

ConstructionMode [in/out]

siConstructionMode

Specifies in which construction mode to apply the envelope.

Default Value: Use the current construction mode

Return Value

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).

Examples

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

See Also

SIApplyFlexEnv



Autodesk Softimage v7.5