Skip to content

Commit

Permalink
Add section about root bone in combination with OSI
Browse files Browse the repository at this point in the history
Signed-off-by: ClemensLinnhoff <[email protected]>
  • Loading branch information
ClemensLinnhoff committed Jan 21, 2025
1 parent 56b70bb commit 5ef2c4c
Showing 1 changed file with 6 additions and 2 deletions.
8 changes: 6 additions & 2 deletions content/geometry/object-human/human-general.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -19,12 +19,16 @@ The default pose is the A-pose.
The naming convention makes it possible to mirror one side of the skeleton to the other.
The bones follow a specific bone orientation: The y-axis of a bone always follows the bone direction, regardless of whether it points sidewards, upwards, or forwards. The x-axis usually faces forwards accordingly.

The skeleton starts with a root bone positioned at the origin of the asset, the center of the bounding box projected to the ground.
This position is static and does not change relativ to the asset during simulation.
When using an ASAM OpenMATERIAL 3D human asset in combination with ASAM OSI, the OSI field https://opensimulationinterface.github.io/osi-antora-generator/asamosi/latest/gen/structosi3_1_1MovingObject_1_1PedestrianAttributes.html#a75db7466abca2d283c8d64d424385c0a[bbcenter_to_root] must be set to the vector from the center of the bounding box to the center of the ground projection of the bounding box.
This specifically means: x=0, y=0, z=-half of the bounding box height.

<<fig-human-structure>> shows the orientation of the coordinate system of a human skeleton.

[#fig-human-structure]
.Human bone structure
image::fig_human-structure.svg[,400]

Bones with a local transform are indicated in the structure by a (T).

This is only an indicator in the documentation and is not necessarily contained in the actual node name.
This is only an indicator in the documentation and is not contained in the actual node name.

0 comments on commit 5ef2c4c

Please sign in to comment.