'

'	This example illustrates how you can control the normalization process

'	when setting envelope weights by using weight locking. Normalization

'	automatically enforces that the sum of the weights for a given point

'	is always maintained to 100% when modifying weights numerically,

'	by painting or through any of the other weight editing commands.

'

' We start with a simple cylinder enveloped to a 6 bone chain

NewScene , false

set oCyl = CreatePrim( "Cylinder", "MeshSurface" )

SetValue "cylinder.cylinder.height", 10

SetValue "cylinder.polymsh.geom.subdivv", 20

SetValue "cylinder.polymsh.geom.subdivu", 16

Create2DSkeleton 1.97818728045807E-02, 5.04656031338284, 0, 0.81105678498785, 3.66123003127775, 0, 0, 0, 0, 4

AppendBone "eff", 0.890184276206176, 1.91967196234563, 0

AppendBone "eff", 0.969311767424504, 0.257275623819517, 0

AppendBone "eff", 1.00887551303367, -1.76134850153362, 0

AppendBone "eff", 0.969311767424504, -3.18625964884171, 0

AppendBone "eff", 1.97818728045807E-02, -4.96739858297683, 0

SelectObj "cylinder", , True

ApplyFlexEnv "cylinder;bone,bone1,bone2,bone3,bone4,bone5,eff", False, 0

' Say that for a given set of points you want to set the

' envelope weight assignment so that the points are weighted

' 50% to "bone1", 25% to "bone" and 25% to "bone2"

' You can first set the weight for these points to 50% to "bone1"

SIModifyFlexEnvWght "cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights", "bone1", _

	"cylinder.pnt[18,19,41,42,64,65,87,88,110,111,133,134,156,157,179,180,202,203,225,226,248,249,271,272,294,295,317,318,340,341,363,364]", 0, 50

' Get the list of deformers to use as input to the LockEnvelopeDeformerWeights command

set oDefs = CreateObject( "XSI.Collection" )

oDefs.SetAsText "bone1" 

' Tip - Alternatively, you could use "oDefs.Add oCyl.Envelopes(0).Deformers(0)" to populate the Deformers collection

' Now to avoid that normalization affects the new 50%

' assignment, we can lock the weights for deformer "bone1" as follows:

LockEnvelopeDeformerWeights "cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights", oDefs, True

' Now we can assign the two other bones to 25% without having normaliztion

' affect the "bone1" values.

SIModifyFlexEnvWght "cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights", "bone", _ 

	"cylinder.pnt[18,19,41,42,64,65,87,88,110,111,133,134,156,157,179,180,202,203,225,226,248,249,271,272,294,295,317,318,340,341,363,364]", 0, 25

SIModifyFlexEnvWght "cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights", "bone2", _ 

	"cylinder.pnt[18,19,41,42,64,65,87,88,110,111,133,134,156,157,179,180,202,203,225,226,248,249,271,272,294,295,317,318,340,341,363,364]", 0, 25

' Now once we're done we can unlock the weights for that

' deformer in the same way:

LockEnvelopeDeformerWeights "cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights", oDefs, False

' We could have also simply cleared all weight locks as follows:

ClearEnvelopeWeightLocks "cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights"

' Now weights don't need to be locked on a per deformer basis.

' One could have locked individual point/deformer weight pairs as follows:

LockEnvelopeWeights "cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights", Array(41, 42, 64, 65), Array(1, 1, 2, 2), True

' This last command locks the weight for points 41 and 42 for deformer 1 (the

' second deformer since indices start at zero) and points 64 and 65 for deformer 2.