instantreality 1.0

Component:
H-Anim
Status:
fully implemented
Structure type:
concrete
Standard:
X3D3.0

HAnimHumanoid

The HAnimHumanoid node is used to: (a) store references to the joints, segments and views, (b) serve as a container for the entire humanoid, (c) provide a convenient way of moving the humanoid through its environment, and (d) store human-readable data such as author and copyright information. HAnimHumanoid contains HAnimJoint, HAnimSegment, HAnimSite, Coordinate, Normal, Viewpoint and skin nodes. The geometry of an H-Anim figure can be described in two ways: either by segments or skinned.

Inheritance

Code

XML encoding
<HAnimHumanoid logFeature=''
showBBox='FALSE'
render='TRUE'
bboxSize='-1 -1 -1'
bboxCenter='0 0 0'
showProxyGeometry='FALSE'
invert='FALSE'
translation='0 0 0'
scaleOrientation='0 0 1 0'
scale='1 1 1'
center='0 0 0'
rotation='0 0 1 0'
localCoordSystem='FALSE'
minEffectiveWeight='0.0'
weight=''
height=''
gender=''
age=''
usageRestrictions=''
creationDate=''
copyright=''
authorName=''
authorEmail=''
humanoidVersion='2.0'
name=''
version='2.0'
info=''
 />
Classic encoding
HAnimHumanoid {
	logFeature [""]
	showBBox FALSE
	render TRUE
	bboxSize -1 -1 -1
	bboxCenter 0 0 0
	showProxyGeometry FALSE
	invert FALSE
	translation 0 0 0
	scaleOrientation 0 0 1 0
	scale 1 1 1
	center 0 0 0
	rotation 0 0 1 0
	localCoordSystem FALSE
	minEffectiveWeight 0.0
	weight ""
	height ""
	gender ""
	age ""
	usageRestrictions ""
	creationDate ""
	copyright ""
	authorName ""
	authorEmail ""
	humanoidVersion "2.0"
	name ""
	version "2.0"
	info [""]
}

Interface

Filter: X3D only | Avalon only | All
id Name DataType PartType Default ValueType Description
MFString info MFString inputOutput Metadata keyword=value pairs VRML 97 encoding combines all the regular keyword=value pairs under info. Hint: the info field can usually be ignored since the other XML attributes for HAnimHumanoid can contain all required info.
SFString name SFString inputOutput name must be present so that HAnimHumanoid can be identified at runtime.
SFString version SFString inputOutput 2.0 Humanoid Animation (H-Anim) Specification version
MFNode skeleton MFNode inputOutput HAnimJoint holds scene graph of the joint hierarchy to describe geometry
MFNode joints MFNode inputOutput HAnimJoint The joints field contains an unordered list of references, one for each Joint object defined within the skeleton field hierarchy of the Humanoid object.
MFNode segments MFNode inputOutput HAnimSegment The segments field contains an unordered list of references, one for each Segment object defined within the skeleton field hierarchy of the Humanoid object.
MFNode sites MFNode inputOutput HAnimSite The sites field contains an unordered list of references, one for each Site object defined within the skeleton field hierarchy of the Humanoid object.
MFNode skin MFNode inputOutput The skin field contains one or more indexed face set definitions. Those indexed face set definitions utilize the point and normal data that is defined within the skinCoord and skinNormal fields, respectively, of the Humanoid object.
SFNode skinCoord SFNode inputOutput Coordinate3D The skinCoord field contains a single sequence of points which are used by the internal mechanisms of the Humanoid object to create the appropriate surface deformations as well as by the indexed face set definitions within the skin field which do the actual rendering of the surface geometry.
SFNode skinNormal SFNode inputOutput Normal3D The skinNormal field contains the normal data definition which is used by the internal mechanisms of the Humanoid object to create the appropriate surface deformations as well as the indexed face set definitions within the skin field, which contains the actual surface geometry that is rendered.
MFNode viewpoints MFNode inputOutput Viewpoint The viewpoints field can contain zero or more Site object definitions. The purpose of these Site objects is to define locations for virtual cameras in the reference frame of the Humanoid object.
SFVec3f center SFVec3f inputOutput 0 0 0 Translation offset from origin of local coordinate system.
SFRotation rotation SFRotation inputOutput 0 0 1 0 Orientation of children relative to local coordinate system.
SFVec3f scale SFVec3f inputOutput 1 1 1 Non-uniform x-y-z scale of child coordinate system, adjusted by center and scaleOrientation.
SFRotation scaleOrientation SFRotation inputOutput 0 0 1 0 Preliminary rotation of coordinate system before scaling (to allow scaling around arbitrary orientations).
SFVec3f translation SFVec3f inputOutput 0 0 0 Position of children relative to local coordinate system.
MFNode children MFNode inputOutput Node field that contains a list of children nodes
MFNode addChildren MFNode inputOnly The addChildren event appends nodes to the children field of a grouping node. Any nodes passed to the addChildren inputOnly field that are already in the children list of the grouping node are ignored
MFNode removeChildren MFNode inputOnly The removeChildren event removes nodes from the children fieldof the grouping node . Any nodes in the removeChildren event that are not in the children list of the grouping node are ignored
SFVec3f bboxCenter SFVec3f initializeOnly 0 0 0 Bounding box center: position offset from origin of local coordinate system.
SFVec3f bboxSize SFVec3f initializeOnly -1 -1 -1 Bounding box size: automatically calculated, can be specified as an optimization or constraint.
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element