ApplyEnvelope (SceneItem)

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

Scripting Syntax

    SceneItem.ApplyEnvelope( Deformers, [DeformOnBranch], [EnvelopeOnBranch] )

C# Syntax

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

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

Return Value

Envelope

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 )

Autodesk Softimage v7.5