X3D Model Documentation: HAnimPrototypes.x3d

  1  <?xml version="1.0" encoding="UTF-8"?>
  2  <!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.3//EN" "https://www.web3d.org/specifications/x3d-3.3.dtd">
  3  <X3D profile='Immersive' version='3.3'  xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='https://www.web3d.org/specifications/x3d-3.3.xsd'>
  4       <head>
  5            <!-- Originally these fundamental prototypes were defined in InterchangableActorsViaDynamicRoutingPrototypes.x3d -->
  6            <meta name='title' content='HAnimPrototypes.x3d'/>
  7            <meta name='description' content='Example implementation of X3D Humanoid Animation (HAnim) nodes using X3D prototypes.'/>
  8            <meta name=' warning ' content=' These are developmental examples that can assist X3D player implementations and support interoperability. They are not intended for author use in regular X3D scenes. '/>
  9            <meta name=' warning ' content=' Developer note: names for these HAnim Prototypes need to be corrected if used internally in an X3D player implementation (e.g. Joint to HAnimJoint). '/>
 10            <meta name=' warning ' content=' Need support for skin '/>
 11            <meta name='creator' content='Ozan APAYDIN, Don Brutzman'/>
 12            <meta name='translator' content='Ozan APAYDIN, Don Brutzman'/>
 13            <meta name='created' content='15 November 2001'/>
 14            <meta name='modified' content='23 May 2020'/>
 15            <meta name=' TODO ' content=' upgrade to match support requirements for HAnim 2.2 '/>
 16            <meta name='reference' content='https://www.web3d.org/files/specifications/19774/V1.0/HAnim/HAnim.html'/>
 17            <meta name='reference' content='https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/hanim.html'/>
 18            <meta name='reference' content='http://HAnim.org/Models/HAnim2001/boxman/boxman.wrl'/>
 19            <meta name='reference' content='http://HAnim.org/Specifications/HAnim2001'/>
 20            <meta name='reference' content='http://www.HAnim.org'/>
 21            <meta name='reference' content='http://HAnim.org/Models'/>
 22            <meta name='reference' content='http://HAnim.org/Specifications'/>
 23            <meta name='reference' content='InterchangableActorsViaDynamicRoutingPrototypes.x3d'/>
 24            <meta name='identifier' content='https://www.web3d.org/x3d/content/examples/HumanoidAnimation/Prototypes/HAnimPrototypes.x3d'/>
 25            <meta name='generator' content='X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit'/>
 26            <meta name='license' content='../license.html'/>
 27       </head>
<!--
<!-- -->
<!-- to top Index for DEF nodes: HumanoidGroup1, HumanoidGroup2, HumanoidGroup3, HumanoidTransform, JointTransform, SegmentGroup, SiteTransform

Index for ProtoDeclare definitions: Displacer, Humanoid1_1, Joint, Segment, Site
-->
 28       <Scene>
 29            <!-- **********Human Model Protypes********* -->
 30            <ProtoDeclare name='Humanoid1_1' appinfo='The Humanoid node serves as overall container for the Joint Segment Site and Viewpoint nodes which define the skeleton geometry and landmarks of the humanoid figure. Additionally the node provides a means for defining information about the author copyright and usage restrictions of the model.' documentation='http://HAnim.org/Specifications/HAnim2001/part1/Humanoid.html'>
 31                 <ProtoInterface>
 32                      <!-- HAnim v1.1 field definitions -->
 33                      <field name='name' type='SFString' accessType='inputOutput'/>
 34                      <field name='version' type='SFString' value='1.1' accessType='inputOutput'
                     appinfo='legal values: 1.1 or 2.0'/>
 35                      <field name='humanoidVersion' type='SFString' accessType='inputOutput'
                     appinfo='Version of the humanoid being modeled. Hint: HAnim version 2.0'/>
 36                      <field name='info' type='MFString' accessType='inputOutput'/>
 37                      <field name='translation' type='SFVec3f' value='0 0 0' accessType='inputOutput'/>
 38                      <field name='rotation' type='SFRotation' value='0 0 1 0' accessType='inputOutput'/>
 39                      <field name='center' type='SFVec3f' value='0 0 0' accessType='inputOutput'/>
 40                      <field name='scale' type='SFVec3f' value='1 1 1' accessType='inputOutput'/>
 41                      <field name='scaleOrientation' type='SFRotation' value='0 0 1 0' accessType='inputOutput'/>
 42                      <field name='bboxCenter' type='SFVec3f' value='0 0 0' accessType='initializeOnly'/>
 43                      <field name='bboxSize' type='SFVec3f' value='-1 -1 -1' accessType='initializeOnly'/>
 44                      <field name='humanoidBody' type='MFNode' accessType='inputOutput'
                     appinfo='HAnim 1.1 field container for body head. Hint: replaced by 2.0 skeleton.'
                     documentation='http://HAnim.org/Specifications/HAnim1.1/#humanoid'/>
 45                      <field name='skeleton' type='MFNode' accessType='inputOutput'
                     appinfo='HAnim 2.0 field container for body geometry Hint: replaces 1.1 humanoidBody'
                     documentation='http://HAnim.org/Specifications/HAnim2001/part1/Humanoid.html'/>
 46                      <field name='joints' type='MFNode' accessType='inputOutput'
                     appinfo='Container field for Joint nodes'/>
 47                      <field name='segments' type='MFNode' accessType='inputOutput'
                     appinfo='Container field for Segment nodes'/>
 48                      <field name='sites' type='MFNode' accessType='inputOutput'
                     appinfo='Container field for Site nodes'/>
 49                      <field name='viewpoints' type='MFNode' accessType='inputOutput'
                     appinfo='Container field for Viewpoint nodes'/>
 50                      <field name='skinCoord' type='SFNode' accessType='inputOutput'
                     appinfo='Hint: HAnim version 2.0'>
 51                           <!-- NULL -->
 52                      </field>
 53                      <field name='skinNormal' type='SFNode' accessType='inputOutput'
                     appinfo='Hint: HAnim version 2.0'>
 54                           <!-- NULL -->
 55                      </field>
 56                 </ProtoInterface>
 57                 <ProtoBody>
 58                      <Transform DEF='HumanoidTransform'>
 59                           <IS>
 60                                <connect nodeField='translation' protoField='translation'/>
 61                                <connect nodeField='rotation' protoField='rotation'/>
 62                                <connect nodeField='center' protoField='center'/>
 63                                <connect nodeField='scale' protoField='scale'/>
 64                                <connect nodeField='scaleOrientation' protoField='scaleOrientation'/>
 65                                <connect nodeField='bboxCenter' protoField='bboxCenter'/>
 66                                <connect nodeField='bboxSize' protoField='bboxSize'/>
 67                           </IS>
 68                           <Group DEF='HumanoidGroup1'>
 69                                <IS>
 70                                     <connect nodeField='children' protoField='humanoidBody'/>
 71                                </IS>
 72                           </Group>
 73                           <Group DEF='HumanoidGroup2'>
 74                                <IS>
 75                                     <connect nodeField='children' protoField='skeleton'/>
 76                                </IS>
 77                           </Group>
 78                           <Group DEF='HumanoidGroup3'>
 79                                <IS>
 80                                     <connect nodeField='children' protoField='viewpoints'/>
 81                                </IS>
 82                           </Group>
 83                      </Transform>
 84                 </ProtoBody>
 85            </ProtoDeclare>
 86            <ProtoDeclare name='Joint' appinfo='The Joint node is used as a building block to describe the articulations of the humanoid figure. Each articulation of the humanoid figure is represented by a Joint node each of which is organized into a hierarchy that describes the overall skeleton of the humanoid.' documentation='http://HAnim.org/Specifications/HAnim2001/part1/Joint.html'>
 87                 <ProtoInterface>
 88                      <field name='name' type='SFString' accessType='inputOutput'/>
 89                      <field name='ulimit' type='MFFloat' accessType='inputOutput'/>
 90                      <field name='llimit' type='MFFloat' accessType='inputOutput'/>
 91                      <field name='limitOrientation' type='SFRotation' value='0 0 1 0' accessType='inputOutput'/>
 92                      <field name='skinCoordIndex' type='MFInt32' accessType='inputOutput'/>
 93                      <field name='skinCoordWeight' type='MFFloat' accessType='inputOutput'/>
 94                      <field name='stiffness' type='MFFloat' value='0 0 0' accessType='inputOutput'/>
 95                      <field name='translation' type='SFVec3f' value='0 0 0' accessType='inputOutput'/>
 96                      <field name='rotation' type='SFRotation' value='0 0 1 0' accessType='inputOutput'/>
 97                      <field name='scale' type='SFVec3f' value='1 1 1' accessType='inputOutput'/>
 98                      <field name='scaleOrientation' type='SFRotation' value='0 0 1 0' accessType='inputOutput'/>
 99                      <field name='center' type='SFVec3f' value='0 0 0' accessType='inputOutput'/>
100                      <field name='bboxCenter' type='SFVec3f' value='0 0 0' accessType='initializeOnly'/>
101                      <field name='bboxSize' type='SFVec3f' value='-1 -1 -1' accessType='initializeOnly'/>
102                      <field name='children' type='MFNode' accessType='inputOutput'/>
103                      <field name='addChildren' type='MFNode' accessType='inputOnly'/>
104                      <field name='removeChildren' type='MFNode' accessType='inputOnly'/>
105                 </ProtoInterface>
106                 <ProtoBody>
107                      <Transform DEF='JointTransform'>
108                           <IS>
109                                <connect nodeField='translation' protoField='translation'/>
110                                <connect nodeField='rotation' protoField='rotation'/>
111                                <connect nodeField='center' protoField='center'/>
112                                <connect nodeField='scale' protoField='scale'/>
113                                <connect nodeField='scaleOrientation' protoField='scaleOrientation'/>
114                                <connect nodeField='bboxCenter' protoField='bboxCenter'/>
115                                <connect nodeField='bboxSize' protoField='bboxSize'/>
116                                <connect nodeField='children' protoField='children'/>
117                                <connect nodeField='addChildren' protoField='addChildren'/>
118                                <connect nodeField='removeChildren' protoField='removeChildren'/>
119                           </IS>
120                      </Transform>
121                 </ProtoBody>
122            </ProtoDeclare>
123            <ProtoDeclare name='Segment' appinfo='The Segment node is used describe the attributes of the physical links between the joints of the humanoid figure. Each body part (pelvis thigh calf etc.) of the humanoid figure is represented by a Segment node.' documentation='http://HAnim.org/Specifications/HAnim2001/part1/Segment.html'>
124                 <ProtoInterface>
125                      <field name='name' type='SFString' accessType='inputOutput'/>
126                      <field name='mass' type='SFFloat' value='0' accessType='inputOutput'/>
127                      <field name='centerOfMass' type='SFVec3f' value='0 0 0' accessType='inputOutput'/>
128                      <field name='momentsOfInertia' type='MFFloat' value='0 0 0 0 0 0 0 0 0' accessType='inputOutput'/>
129                      <field name='bboxCenter' type='SFVec3f' value='0 0 0' accessType='initializeOnly'/>
130                      <field name='bboxSize' type='SFVec3f' value='-1 -1 -1' accessType='initializeOnly'/>
131                      <field name='children' type='MFNode' accessType='inputOutput'/>
132                      <field name='addChildren' type='MFNode' accessType='inputOnly'/>
133                      <field name='removeChildren' type='MFNode' accessType='inputOnly'/>
134                      <field name='coord' type='SFNode' accessType='inputOutput'
                     appinfo='contains Coordinate nodes'>
135                           <!-- NULL -->
136                      </field>
137                      <field name='displacers' type='MFNode' accessType='inputOutput'
                     appinfo='contains Displacer nodes'/>
138                 </ProtoInterface>
139                 <ProtoBody>
140                      <Group DEF='SegmentGroup'>
141                           <IS>
142                                <connect nodeField='bboxCenter' protoField='bboxCenter'/>
143                                <connect nodeField='bboxSize' protoField='bboxSize'/>
144                                <connect nodeField='children' protoField='children'/>
145                                <connect nodeField='addChildren' protoField='addChildren'/>
146                                <connect nodeField='removeChildren' protoField='removeChildren'/>
147                           </IS>
148                      </Group>
149                 </ProtoBody>
150            </ProtoDeclare>
151            <ProtoDeclare name='Site' appinfo='The Site node can be used for three purposes: (a) to define an "end effector" location which can be used by an inverse kinematics system (b) to define an attachment point for accessories such as jewelry and clothing and (c) to define a location for a virtual camera in the reference frame of a Segment node (such as a view "through the eyes" of the humanoid for use in multi-user worlds).' documentation='http://HAnim.org/Specifications/HAnim2001/part1/Site.html'>
152                 <ProtoInterface>
153                      <field name='name' type='SFString' accessType='inputOutput'/>
154                      <field name='translation' type='SFVec3f' value='0 0 0' accessType='inputOutput'/>
155                      <field name='rotation' type='SFRotation' value='0 0 1 0' accessType='inputOutput'/>
156                      <field name='scale' type='SFVec3f' value='1 1 1' accessType='inputOutput'/>
157                      <field name='scaleOrientation' type='SFRotation' value='0 0 1 0' accessType='inputOutput'/>
158                      <field name='center' type='SFVec3f' value='0 0 0' accessType='inputOutput'/>
159                      <field name='bboxCenter' type='SFVec3f' value='0 0 0' accessType='initializeOnly'/>
160                      <field name='bboxSize' type='SFVec3f' value='-1 -1 -1' accessType='initializeOnly'/>
161                      <field name='children' type='MFNode' accessType='inputOutput'/>
162                      <field name='addChildren' type='MFNode' accessType='inputOnly'/>
163                      <field name='removeChildren' type='MFNode' accessType='inputOnly'/>
164                 </ProtoInterface>
165                 <ProtoBody>
166                      <Transform DEF='SiteTransform'>
167                           <IS>
168                                <connect nodeField='translation' protoField='translation'/>
169                                <connect nodeField='rotation' protoField='rotation'/>
170                                <connect nodeField='center' protoField='center'/>
171                                <connect nodeField='scale' protoField='scale'/>
172                                <connect nodeField='scaleOrientation' protoField='scaleOrientation'/>
173                                <connect nodeField='bboxCenter' protoField='bboxCenter'/>
174                                <connect nodeField='bboxSize' protoField='bboxSize'/>
175                                <connect nodeField='children' protoField='children'/>
176                                <connect nodeField='addChildren' protoField='addChildren'/>
177                                <connect nodeField='removeChildren' protoField='removeChildren'/>
178                           </IS>
179                      </Transform>
180                 </ProtoBody>
181            </ProtoDeclare>
182            <ProtoDeclare name='Displacer' appinfo='A Displacer can be used in three different ways: (a) identify the vertices corresponding to a particular feature on a Segment (b) represent a particular muscular action which displaces the vertices in various directions (linearly or radially) and (c) represent a complete configuration of the vertices in a Segment.' documentation='http://HAnim.org/Specifications/HAnim2001/part1/Displacer.html'>
183                 <ProtoInterface>
184                      <field name='name' type='SFString' accessType='inputOutput'/>
185                      <field name='coordIndex' type='MFInt32' accessType='inputOutput'/>
186                      <field name='displacements' type='MFVec3f' accessType='inputOutput'/>
187                 </ProtoInterface>
188                 <ProtoBody>
189                      <WorldInfo info='"null body node"'/>
190                 </ProtoBody>
191            </ProtoDeclare>
192            <Shape>
193                 <Text string='"Humanoid Animation" "(HAnim) prototype" "implementations"'>
194                      <FontStyle justify='"MIDDLE" "MIDDLE"'/>
195                 </Text>
196                 <Appearance>
197                      <Material ambientIntensity='0.25' diffuseColor='0.795918 0.505869 0.093315' shininess='0.39' specularColor='0.923469 0.428866 0.006369'>
198                           <!-- Universal Media Library: Autumn 9 -->
199                      </Material>
200                 </Appearance>
201            </Shape>
202       </Scene>
203  </X3D>
<!--
<!-- -->
<!-- to top Index for DEF nodes: HumanoidGroup1, HumanoidGroup2, HumanoidGroup3, HumanoidTransform, JointTransform, SegmentGroup, SiteTransform

Index for ProtoDeclare definitions: Displacer, Humanoid1_1, Joint, Segment, Site
-->
X3D Tooltips element index: Appearance, connect, field, FontStyle, Group, head, IS, Material, meta, ProtoBody, ProtoDeclare, ProtoInterface, Scene, Shape, Text, Transform, WorldInfo, X3D, plus documentation for accessType definitions, type definitions, XML data types, and field types
-->
<!-- Online at
https://www.web3d.org/x3d/content/examples/HumanoidAnimation/Prototypes/HAnimPrototypesIndex.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/HumanoidAnimation/Prototypes/HAnimPrototypes.x3d -->

<!-- Color-coding legend: X3D terminology <X3dNode  DEF='idName' field='value'/> matches XML terminology <XmlElement  DEF='idName' attribute='value'/>
(Light-blue background: event-based behavior node or statement) (Grey background inside box: inserted documentation) (Magenta background: X3D Extensibility)
    <ProtoDeclare name='ProtoName'> <field name='fieldName'/> </ProtoDeclare> -->

to top <!-- For additional help information about X3D scenes, please see X3D Tooltips, X3D Resources, and X3D Scene Authoring Hints. -->