v1.0
Applies an operator that limits the number of envelope deformers that can
affect a given vertex. For a given integer limit, the operator ensures the
limit is met by removing the deformers with the minimum number of weights.
The remaining weights are then normalized.
The limit respects locked weights, meaning that if the minimum weight is
actually a locked weight, it is not removed. Similarly, if the only remaining
weights after applying the limit are locked, normalization will not be performed.
oReturn = LimitEnvelopeDeformers( PropObj, [SubComp], Limit ); |
Returns the newly created LimitEnvelopeDeformersOp operator.
| Parameter | Type | Description |
|---|---|---|
| PropObj | String | Envelope weights property to be modified. |
| SubComp | String |
List of points/objects/clusters to be smoothed. Default Value: Current selection |
| Limit | Integer | The maximum number of deformers permitted to affect a given vertex contained in SubComp |
NewScene(null, null);
// Create a cylinder to be deformed
CreatePrim("Cylinder", "MeshSurface", null, null);
SetValue("cylinder.polymsh.geom.subdivu", 20, null);
SetValue("cylinder.polymsh.geom.subdivv", 20, null);
SetValue("cylinder.cylinder.height", 12.264, null);
Create2DSkeleton(0, -6, 0.6, 0, -5.25, 0.525, -5.7, 0, 0, 4, null, null);
// Create a chain of bones to deform the cylinder with
AppendBone("eff", -0.16, -2.5, 0.25, null);
AppendBone("eff", -0.12, 0.6, 0, null);
AppendBone("eff", -0.12, 3.4, -0.34, null);
AppendBone("eff", -0.12, 5.7, -0.57, null);
AppendBone("eff", -0.12, 6.5, -0.65, null);
// Deform the cylinder
SelectObj("cylinder", null, true);
ApplyFlexEnv("cylinder;root,bone,bone1,bone2,bone3,bone4,bone5,bone6,bone7,bone8,bone9,eff", null, 2);
SelectObj("eff", null, true);
Translate(null, -4.8, -8.4, 0.84, siRelative, siView, siObj, siXYZ, null, null, null, null, null, null, null, null, null, 0, null);
SelectObj("cylinder", null, true);
SetValue("cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights.autoenvassign.defnbskelobj", 4, null);
// Open the weight editor to look at how the bones are assigned
OpenView("Weight Editor", null);
LockEnvelopeWeights("cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights", Array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12), Array(4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4), null);
XSIUIToolkit.MsgBox("Note that in the Weight Editor each bone is affected by four deformers, and some of the weights of bone3 are locked. A limit of 2 deformers will now be applied.");
// Limit to two the number of deformers that apply to a given vertex
LimitEnvelopeDeformers("cylinder.polymsh.cls.EnvelopWeightCls.Envelope_Weights", null, 2);
XSIUIToolkit.MsgBox("Only two deformers are permitted to affect a given vertex, and the weights have been normalized. Note that the locked weights were not modified."); |