This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
formats:modules:derigxml:xml_rig_file_.rig.xml [2008/03/21 00:26] – dragonlord | formats:modules:derigxml:xml_rig_file_.rig.xml [2020/10/26 23:03] (current) – [Sample file] dragonlord | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Rig File format ====== | + | {{tag> |
- | The rig file format is recognized by the [[http:// | + | <WRAP youarehere> |
+ | [[:start|Start Page]] >> [[: | ||
+ | </WRAP> | ||
+ | ====== Rig File Format (*.derig) ====== | ||
+ | The rig file format is recognized by the [[http:// | ||
+ | ====== Structure ====== | ||
- | |||
- | ====== Structure ====== | ||
* rig | * rig | ||
* comments | * comments | ||
Line 20: | Line 23: | ||
* dynamic | * dynamic | ||
* parent | * parent | ||
- | * sphere | + | |
- | * position | + | * < |
- | * x, y, z | + | |
- | * radius | + | Where < |
- | * box | + | |
- | * position | + | * position |
- | * x, y, z | + | * x, y, z |
- | * rotation | + | * radius |
- | * x, y, z | + | * box |
- | * halfExtends | + | * position |
- | * x, y, z | + | * x, y, z |
- | * cylinder | + | * rotation |
- | * position | + | * x, y, z |
- | * x, y, z | + | * halfExtends |
- | * rotation | + | * x, y, z |
- | * x, y, z | + | * cylinder |
- | * topRadius | + | * position |
- | * bottomRadius | + | * x, y, z |
- | * capsule | + | * rotation |
- | * position | + | * x, y, z |
- | * x, y, z | + | * halfHeight |
- | * rotation | + | |
- | * x, y, z | + | * bottomRadius |
- | * topRadius | + | * radius |
- | * bottomRadius | + | |
+ | * position | ||
+ | * x, y, z | ||
+ | * rotation | ||
+ | * x, y, z | ||
+ | * halfHeight | ||
+ | | ||
+ | * bottomRadius | ||
+ | * radius | ||
====== Tags ====== | ====== Tags ====== | ||
+ | |||
^Tag^Description^Required^Occurance^Default^ | ^Tag^Description^Required^Occurance^Default^ | ||
|rig|Defines the properties of the entire rig.|yes|once|-| | |rig|Defines the properties of the entire rig.|yes|once|-| | ||
- | |author|Can be used to store the author | + | |comments|Comments about the file, the author, credits and other things.|no|once|< |
- | |bone|Defines a bone in the rig. Order is not important since the engine determines the correct links between the rig bones. Just do never produce loops as this is going to make the file fail upon loading. | + | |bone|Defines a bone in the rig. Order is not important since the engine determines the correct links between the rig bones. Just do never produce loops as this is going to make the file fail upon loading.|no|multiple|-| |
- | |position|Defines the position of a bone. Requires three attributes " | + | |bone.name|Defines |
- | |rotation|Defines the rotation of a bone. Requires three attribures "x", "y" and "z" for the respective coordinate axis. Rotation is counter clockwise for all axes and is measured in degrees.|no|once|(0, | + | |position|Defines the position of a bone.|no|once|(0, |
- | |centralMassPoint|Defines the location of the central mass point of the the rig or bone. Requires three attributes " | + | |x,y,z|Defines the x, y or z value of various vector type tags.|no|once|-| |
+ | |rotation|Defines | ||
+ | |centralMassPoint|Defines the location of the central mass point of the the rig or bone.|no|once|(0, | ||
|mass|Defines the mass in kg of the entire rig or a bone.|no|once|0| | |mass|Defines the mass in kg of the entire rig or a bone.|no|once|0| | ||
|dynamic|Defines if the rig or bone is kinematic or dynamic. If dynamic it is subject to physics simulation. If kinematic it is driven by user specified linear and angular velocities. Kinematic is best used for rigs which have animations applied. Value is " | |dynamic|Defines if the rig or bone is kinematic or dynamic. If dynamic it is subject to physics simulation. If kinematic it is driven by user specified linear and angular velocities. Kinematic is best used for rigs which have animations applied. Value is " | ||
|parent|Defines the parent bone. If empty the bone has no parent. Otherwise the name of a bone has to be specified. Do not create loops or the loading fails.|no|once|< | |parent|Defines the parent bone. If empty the bone has no parent. Otherwise the name of a bone has to be specified. Do not create loops or the loading fails.|no|once|< | ||
+ | |sphere|Defines a sphere shape.|no|multiple|-| | ||
+ | |sphere.position|Position of the sphere shape.|no|once|(0, | ||
+ | |sphere.radius|Radius of the sphere shape.|no|once|1| | ||
|box|Defines a box shape.|no|multiple|-| | |box|Defines a box shape.|no|multiple|-| | ||
- | |box.center|Defines the center | + | |box.position|Position |
- | |box.halfSize|Defines the extends of a box shape. | + | |box.rotation|Rotation of the shape. Rotation is counter clockwise for all axes and is measured in degrees.|no|once|(0, |
+ | |box.halfExtends|Half extends of the box shape. | ||
+ | |cylinder|Defines a cylinder shape. The cylinder | ||
+ | |cylinder.position|Position of the cylinder shape.|no|once|(0,0,0)| | ||
+ | |cylinder.rotation|Rotation of the cylinder shape. Rotation is counter clockwise | ||
+ | |cylinder.halfHeight|Half height of the cylinder. This is half the length | ||
+ | |cylinder.topRadius|Radius of the top part of the cylinder.|no|once|0.5| | ||
+ | |cylinder.bottomRadius|Radius of the bottom part of the cylinder.|no|once|0.5| | ||
+ | |cylinder.radius|Shortcut | ||
+ | |capsule|Defines a capsule shape. The capsule is oriented along the Y axis and has a top and a bottom radius. For a uniform capsule both are the same.|no|multiple|-| | ||
+ | |capsule.position|Position of the capsule shape.|no|once|(0, | ||
+ | |capsule.rotation|Rotation of the capsule shape. Rotation is counter clockwise for all axes and is measured in degrees.|no|once|(0,0,0)| | ||
+ | |capsule.halfHeight|Half height of the capsule. This is half the length of the top sphere center of the cylinder to the bottom one.|no|once|0.5| | ||
+ | |capsule.topRadius|Radius of the top part of the capsule.|no|once|0.5| | ||
+ | |capsule.bottomRadius|Radius of the bottom part of the capsule.|no|once|0.5| | ||
+ | |capsule.radius|Shortcut to define the top and bottom radius of the capsule to the same value.|no|once|0.5| | ||
====== Sample file ====== | ====== Sample file ====== | ||
+ | |||
<code xml><? | <code xml><? | ||
- | < | ||
<rig> | <rig> | ||
+ | < | ||
- | <author>RPTD (roland@rptd.ch)</author> | + | <bone> |
- | + | <name>rootBone</name> | |
- | <bone name=" | + | < |
- | < | + | <x>0</x> <y>0</y> <z>0</z> |
- | < | + | </ |
- | < | + | < |
+ | <x>0</x> <y>0</y> <z>0</z> | ||
+ | </ | ||
+ | < | ||
+ | <x>0</x> <y>0.2</y> <z>0</z> | ||
+ | </ | ||
< | < | ||
- | <center | + | <position> |
- | <halfSize | + | <x>0</x> <y>0</y> <z>0</z> |
+ | </ | ||
+ | < | ||
+ | <x>0.2</x> <y>0.4</y> <z>0.1</ | ||
+ | </halfExtends> | ||
</ | </ | ||
< | < | ||
Line 80: | Line 123: | ||
</ | </ | ||
- | <bone name=" | + | <bone> |
- | < | + | < |
- | < | + | < |
- | < | + | < |
- | < | + | <x>0</x> <y>0.6</y> <z>0</z> |
- | <box> | + | </ |
- | <center | + | < |
- | <halfSize x="0.1" y="0.15" z=" | + | <x>0</x> <y>0</y> <z>0</z> |
- | </box> | + | </rotation> |
+ | < | ||
+ | <x>0</x> <y>0.75</y> <z>0</z> | ||
+ | </ | ||
+ | < | ||
+ | <position> | ||
+ | <x>0</x> <y>0</y> <z>0</ | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | <topRadius> | ||
+ | < | ||
+ | </capsule> | ||
< | < | ||
< | < | ||
Line 95: | Line 152: | ||
</ | </ | ||
</ | </ | ||
- | |||
- | ====== Links ====== | ||
- | * [[gamedev: | ||
- | * [[: |