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 )