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