Merge branch 'main' into 72-Add-human-class-meta-data

content/general-docs/introduction.adoc

@@ -160,4 +160,9 @@ Notes, footnotes, and examples shall not contain requirements or any information
 
 The following deliverables are provided for {THIS_STANDARD}:
 
-> Define the deliverables of this project here
+* https://asam-ev.github.io/OpenMATERIAL/asamopenmaterial/latest/specification/index.html[ASAM OpenMATERIAL 3D BS 1.0.0 Specification, 2025-MM-DD] (this document, contained in this site)
+* https://github.com/asam-ev/OpenMATERIAL/tree/main/schemas[JSON schema files] for all json formats (contained in the open-source standard repository)
+* https://github.com/asam-ev/OpenMATERIAL/tree/main/examples[Example files] for all defined file formats (contained in the open-source standard repository) and further examples of
+** a https://github.com/asam-ev/OpenMATERIAL/tree/main/examples/vehicle_example[vehicle] (contained in the open-source standard repository)
+** a https://github.com/asam-ev/OpenMATERIAL/tree/main/examples/human_example[human] (contained in the open-source standard repository)
+** an https://github.com/asam-ev/OpenMATERIAL/tree/main/examples/environment_example[environment] (contained in the open-source standard repository)

content/general-docs/scope.adoc

@@ -6,7 +6,8 @@ ifndef::include-only-once[]
 include::{root-path}_config.adoc[]
 endif::[]
 
-{THIS_STANDARD} specifies
+{THIS_STANDARD} specifies:
+
 * Structure and coordinate frames for 3D models (*3D Data Files*), supporting common 3D exchange formats such as FBX, glTF and USD. 
 * Metadata for 3D models and references to *Material Mapping Files* based on JSON schemas in *Asset Files*.
 * Material mapping based on JSON schemas in *Material Mapping Files*.

content/geometry/object-environment/environment-general.adoc

@@ -7,5 +7,7 @@ The structure begins with a root node, which is the parent of all other nodes. I
 Children of the root node are terrain, environment objects and the road network.
 The latter is further detailed by its child nodes drivable area, sidewalks, roadmarks, road objects and signals.
 
+An https://github.com/asam-ev/OpenMATERIAL/tree/main/examples/environment_example[example environment asset] is provided in the examples folder.
+
 Groups with a local transform are indicated in the structure by a (T).
 This is only an indicator in the documentation and must not be contained in the actual node name.

content/geometry/object-human/human-general.adoc

@@ -1,3 +1,14 @@
 = General
 
-//Add general information about the human structure
+A human is a bipedal being that can be represented by an object in 3D geometry.
+
+The human 3D geometry is generically structured into the node structure and skeleton (also often called armature) defined in the xref:../geometry/object-human/human-index.adoc#_model_structure[Model structure].
+The structure starts with a Root node as a parent group for all other nodes in the structure.
+Splitting the object into different parts, such as clothing, hair, and accessories, enables animation and exchange of parts.
+Not all nodes have to be present in every human 3D model.
+Custom object parts may be added to facilitate and better visualize additional use cases, but all custom parts shall adhere to the specified structure principle.
+
+In the coordinate system for human 3D geometry, the x-axis points forwards, the y-axis points sidewards, and the z-axis points upwards.
+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.

content/geometry/object-human/human-index.adoc

@@ -1,6 +1,5 @@
 = Human structure
 
 include::human-general.adoc[leveloffset=+1]
-include::human-model-creation.adoc[leveloffset=+1]
-include::human-model-structure.adoc[leveloffset=+1]
+include::human-structure.adoc[leveloffset=+1]
 include::human-notes.adoc[leveloffset=+1]