## SceneItem.ApplyEnvelope

### Description

Applies a flexible envelope to the object(s) specified.
Note: You can apply envelopes to several different types of X3DObjects (for example, either nurbs or mesh 3D objects). However, the only type of Cluster that you can use apply an envelope to is the vertex (point) cluster type (siVertexCluster).

### C# Syntax

    Envelope SceneItem.ApplyEnvelope( Object in_pDeformers, siBranchFlag in_eDeformOnBranch, siBranchFlag in_eEnvelopeOnBranch );

### Scripting Syntax

    oReturn = SceneItem.ApplyEnvelope( Deformers, [DeformOnBranch], [EnvelopeOnBranch] );

### Return Value

Envelope

### Parameters

Parameter | Type | Description
--- | --- | ---
Deformers | SceneItemCollection, SceneItem object, or an Expression | Object(s) to be assigned as envelope deformers.
DeformOnBranch | siBranchFlag | Use all objects in deformers branch Default Value: siUnspecified
EnvelopeOnBranch | siBranchFlag | Apply envelope to all objects in the SceneItem's branch Default Value: siUnspecified

### Examples

#### VBScript Example

    'VBScript example

    set oRoot = Application.ActiveProject.ActiveScene.Root

    set oSkin = oRoot.AddGroup

    set oSkeleton = oRoot.AddModel

    set oRLeg = oRoot.AddGeometry( "Cylinder","MeshSurface")

    oSkin.AddMember oRLeg

    set oLLeg = oRoot.AddGeometry( "Cylinder","MeshSurface")

    oSkin.AddMember oLLeg

    set oChainRoot = oSkeleton.Add3DChain

    ' apply envelope to geometry branch using

    set oEnvelope = oSkin.ApplyEnvelope( oSkeleton, siBranch, siBranch )