Body Groups: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(Redirected page to $bodygroup)
 
Line 1: Line 1:
''Body Groups'' are sub-meshes of a model that can have changeable states. Server code can change the state of a model's body groups.
#redirect [[$bodygroup]]
 
== Syntax ==
To define a body groups, you need to add lines in the [[.qc]]:
 
$bodygroup (name)
{
studio (modelname)
["studio" modelname]
[blank]
}
 
== Examples ==
 
A single .mdl could be used for characters with and without glasses:
 
$bodygroup studio
{
studio "dude.smd"
}
$bodygroup eyewear
{
studio "glasses.smd"
blank
}
 
This example has two body groups numbered 0 and 1. Group 0 uses a single mesh and group 1 uses 2, a model of a pair of glasses (state 0) and the built-in "no-polygons" model (state 1) which is used to "turn-off" the glasses.
 
=== Multiple sets ===
You can have multiple entries in a bodygroup, for example you could have 4 different sets of the chest, each with different styles:
 
$bodygroup chest
{
studio "chest_with_no_armor.smd"
studio "chest_with_light_armor.smd"
studio "chest_with_heavy_armor.smd"
studio "chest_with_super_armor.smd"
}
 
You could also just put the armor pieces in their own group and always draw the underlying chest without armor, but it's less efficient and often there's no clean "base" set, such as if you're using bodygroups to define multiple heads.
 
The models used in bodygroups can span any number of bones.
 
== Switching groups in code ==
 
To change a body group's state call <code>CBaseAnimating::SetBodygroup( int iGroup, int iValue )</code> in server code. For example, this would randomly give 1 out of 5 characters glasses:
 
SetBodygroup( 1, ( RandomInt( 1, 5 ) == 1 )?1:0 );
 
Bodygroups are limited to 32 bits of combinations, which is a total of 4,294,967,296 combinations.  If you used the above eyewear and chest examples, the total combinations would be eyewear x chest, or 2 x 4, or a total of 8 combinations. Just multiply all your bodygroup combinations together to make sure your total is less than the max.  Weapons by default are limited to 256 combinations, though it's just a network limit which is easy for your mod to change.  See:
 
BEGIN_NETWORK_TABLE_NOBASE(CBaseViewModel, DT_BaseViewModel)
...
<b>SendPropInt (SENDINFO(m_nBody), 8),</b>
 
==See also==
* [[Multiple_Skins_for_a_Single_Model | Skins]]
* DOD Player Models make extensive use of Bodygroups.
 
[[Category:Modeling]]

Latest revision as of 04:15, 31 December 2010

Redirect to:

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Body_Groups&oldid=141148"