$weightlist: Difference between revisions
Jump to navigation
Jump to search
Note:No, this has nothing to do with physical weight or mass.
Note:Values above 1 are accepted unlike what one might expect. These will multiply the motion of the animation.
Tip:You can have up to 128 $weightlists commands
Tip:You can declare a default weight list with $defaultweightlist and this doesn't count on the 128 limit
Warning:Opening bracket must be on the same line as $weightlist
Note:posweight cannot be used when weight is already zero
Note:It doesn't really matter if posweight is double quoted
m (typo of $weightlist) |
No edit summary |
||
(8 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
{{this is a|QC command|name=$weightlist}} It defines the influence to which each bone in a model is affected by a [[$sequence]] or [[$animation]]. For example, you could set the weight of the leg bones to 0 to only animate the top half of the skeleton. | |||
A <code>$weightlist</code> can be reused as many times as is needed. It must come above anything that uses it in the QC. | A <code>$weightlist</code> can be reused as many times as is needed. It must come above anything that uses it in the QC. | ||
{{note|''No, this has nothing to do with physical weight or mass.''}} | |||
{{note|Values above 1 are accepted unlike what one might expect. These will multiply the motion of the animation.}} | |||
{{tip|You can have up to 128 $weightlists [[QC_Commands|commands]]}} | |||
{{tip|You can declare a default weight list with [[$defaultweightlist]] and this doesn't count on the 128 limit}} | |||
== Usage == | == Usage == | ||
{{warning|Opening bracket must be on the same line as $weightlist}} | |||
<source lang=php> | <source lang=php> | ||
$weightlist my_weightlist | $weightlist my_weightlist { | ||
{ | |||
<bone> <weight> | <bone> <weight> | ||
<bone> <weight> | <bone> <weight> | ||
Line 19: | Line 23: | ||
<source lang=php> | <source lang=php> | ||
$weightlist no_hands | $weightlist no_hands { | ||
{ | |||
"Bip01_Pelvis" 1.0 | "Bip01_Pelvis" 1.0 | ||
"Bip01_LHand" 0.0 | "Bip01_LHand" 0.0 | ||
Line 40: | Line 43: | ||
"Bip01_R_Clavicle" 0.8 | "Bip01_R_Clavicle" 0.8 | ||
"Bip01_R_Upperarm" 1.0 | "Bip01_R_Upperarm" 1.0 | ||
}</source> | |||
==== PosWeight ==== | |||
optionally you can set '''<code>posweight</code>''' option right after bone ''weight'' value to also set weight for location translations on top of declared weight. Useful for blend different length skeleton animations or even disable position translations. <br/>{{note|'''posweight''' cannot be used when weight is already zero}}{{note|It doesn't really matter if posweight is double quoted}} | |||
<source lang=php> | |||
$weightlist rotate_but_dont_move { | |||
"Bip01_Pelvis" 1.0 "posweight" 0.0 | |||
}</source> | }</source> | ||
Line 45: | Line 56: | ||
* [[$animation#Blending|Subtracted animations]] | * [[$animation#Blending|Subtracted animations]] | ||
Latest revision as of 17:58, 3 August 2025
$weightlist
is a QC command available in all Source games. It defines the influence to which each bone in a model is affected by a $sequence or $animation. For example, you could set the weight of the leg bones to 0 to only animate the top half of the skeleton.
A $weightlist
can be reused as many times as is needed. It must come above anything that uses it in the QC.




Usage

$weightlist my_weightlist {
<bone> <weight>
<bone> <weight>
...
}
$sequence my_weighted_anim "my_anim.smd" weightlist my_weightlist
Bones inherit weight from their parents, and all root bones start with a weight of 0.
$weightlist no_hands {
"Bip01_Pelvis" 1.0
"Bip01_LHand" 0.0
"Bip01_RHand" 0.0
}
$weightlist head_and_arms "Bip01_Spine2" 1.0
$Weightlist UpperbodyBlend {
"Bip01_Pelvis" 0.1
"Bip01_L_Thigh" 0.0
"Bip01_R_Thigh" 0.0
"Bip01_Spine" 0.2
"Bip01_Spine1" 0.4
"Bip01_Spine2" 0.6
"Bip01_Spine4" 0.4
"Bip01_L_Clavicle" 0.8
"Bip01_L_Upperarm" 1.0
"Bip01_R_Clavicle" 0.8
"Bip01_R_Upperarm" 1.0
}
PosWeight
optionally you can set posweight
option right after bone weight value to also set weight for location translations on top of declared weight. Useful for blend different length skeleton animations or even disable position translations.


$weightlist rotate_but_dont_move {
"Bip01_Pelvis" 1.0 "posweight" 0.0
}