/*

	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( null, false );

var 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", null, 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

var oDefs = new ActiveXObject( "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 normalization

// 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", new Array(41,42,64,65), new 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.