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
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
SFString age SFString inputOutput Humanoid model age in human years. Hint: can be encoded as info attribute keyword=value pair.
SFString authorEmail SFString inputOutput Author Email address. Hint: can be encoded as info attribute keyword=value pair.
SFString authorName SFString inputOutput Author name. Hint: can be encoded as info attribute keyword=value pair.
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.
SFVec3f center SFVec3f inputOutput 0 0 0 Translation offset from origin of local coordinate system.
MFNode children MFNode inputOutput Node field that contains a list of children nodes
SFString copyright SFString inputOutput Copyright information. Hint: can be encoded as info attribute keyword=value pair.
SFString creationDate SFString inputOutput Humanoid model creation date. Hint: can be encoded as info attribute keyword=value pair.
SFString gender SFString inputOutput Humanoid model gender (typically male or female).
SFString height SFString inputOutput Humanoid model height (meters). Hint: can be encoded as info attribute keyword=value pair.
SFString humanoidVersion SFString inputOutput 2.0 Metadata keyword=value pair.
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.
SFBool invert SFBool inputOutput FALSE inverts matrix if true
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.
SFBool localCoordSystem SFBool initializeOnly FALSE Defines if vertices and normals initially shall beconverted into the humanoids local coordinate system.
MFString logFeature MFString inputOutput state, child, parent, route, eventIn, eventOut controls the logging of changes, state: log state changes (e.g. live), child: log child add/remove, parent: log parent add/remove, route: log route add/remove; eventIn: log receiving of events, eventOut: log sending of events: guiView, runtime system should create node-view, guiEdit: runtime system should create node-editeverything: log everything
SFMatrix4f matrix_changed SFMatrix4f outputOnly The matrix that defines the nodes transformation after an update.
SFNode metadata SFNode inputOutput MetadataObject container for payload metadata inside MetadataSet element
SFFloat minEffectiveWeight SFFloat inputOutput 0.0 Ignore joints with little (smaller minEffectiveWeight) influence.
SFString name SFString inputOutput name must be present so that HAnimHumanoid can be identified at runtime.
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
SFBool render SFBool inputOutput TRUE Flag to control the visibility of the node or subtree
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).
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.
SFBool showBBox SFBool inputOutput FALSE Show Bounding Box of Subtree.
SFBool showProxyGeometry SFBool inputOutput FALSE show cartesian coordinate system
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 skeleton MFNode inputOutput HAnimJoint holds scene graph of the joint hierarchy to describe geometry
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.
SFVec3f translation SFVec3f inputOutput 0 0 0 Position of children relative to local coordinate system.
SFString usageRestrictions SFString inputOutput Author/owner-specified usage restrictions. Hint: can be encoded as info attribute keyword=value pair.
SFString version SFString inputOutput 2.0 Humanoid Animation (H-Anim) Specification version
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.
SFString weight SFString inputOutput Humanoid model weight (kilograms). Hint: can be encoded as info attribute keyword=value pair.