[x3d-public] X3D4 prose suggestions for HAnim nodesHAnimSegment and

[Joseph D Williams]

➢ I am thinking that it might say … HAnimSegment node *and its children* provide// a visual representation …

* Each body segment is stored in an HAnimSegment node. Segment is child of a Joint. A Joint can parent multiple Segments. Segment can contain child geometry as well as child Site(s) containing sensors, surface feature names and locations, geometries, Viewpoint(s), and, unless it is the terminating Segment, at least one child Joint. A Segment, and its child content are animated by rotation of its parent joint and control of that joint’s parent structures. 

Thanks, 
Joe

* Each body segment is stored in an HAnimSegment node.

Recommend further detail. Suggested prose:

* Each body segment is stored in an HAnimSegment node, providing a visual representation of the skeleton segment. Parent/child translation and rotation relationships are defined between parent/child HAnimSegment nodes.

From: John Carlson
Sent: Tuesday, October 4, 2022 1:16 PM
To: Brutzman, Donald (Don) (CIV)
Cc: X3D Public Mailing List (x3d-public at web3d.org); h-anim at web3d.org
Subject: Re: [x3d-public] X3D4 prose suggestions for HAnim nodesHAnimSegment and

I am thinking that it might say … HAnimSegment node *and its children* provide// a visual representation …

I’m unsure of the grammar.

On Tue, Oct 4, 2022 at 1:37 PM Brutzman, Donald (Don) (CIV) <brutzman at nps.edu> wrote:
While reviewing various X3D Tooltip descriptions, found a lack of clarity and potential for editorial improvement in X3D4 Architecture specification.  This additional prose might help clear up recurring mystery that sometimes occurs with author understanding of how X3D implements two Humanoid Animation (HAnim) nodes.
 
• Mantis 1402: Insufficient description for HAnimSegment
• https://www.web3d.org/member-only/mantis/view.php?id=1402
 
Mantis 1402: Insufficient description for HAnimSegment
Description
Node description for HAnimSegment is exceedingly terse and insufficient to describe purpose.

* Each body segment is stored in an HAnimSegment node.

Recommend further detail. Suggested prose:

* Each body segment is stored in an HAnimSegment node, providing a visual representation of the skeleton segment. Parent/child translation and rotation relationships are defined between parent/child HAnimSegment nodes.

Additional Information
References:

* https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/components/hanim.html#HAnimSegment

* https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/ObjectInterfaces.html#Segment



 
• Mantis 1403: Insufficient description for HAnimJoint
• https://www.web3d.org/member-only/mantis/view.php?id=1403
 
Mantis 1403: Insufficient description for HAnimJoint
Description
Node description for HAnimJoint is exceedingly terse and insufficient to describe purpose.

* Each joint in the body is represented by an HAnimJoint node, which is used to define the relationship of each body segment to its immediate parent.

Recommend further detail. Suggested prose addition:

* The child HAnimSegment node provides a visual representation of the skeleton segment.


Additional Information
References:

* https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-DIS/Part01/components/hanim.html#HAnimJoint

* https://www.web3d.org/documents/specifications/19774/V2.0/Architecture/ObjectInterfaces.html#Joint



 
 
All comments on this suggest improvement to editorial phrasing are welcome.  Please note that no functional changes are involved.
 
Next.  As previously announced, we will be going over all Web3D comments on the current ISO ballot during this week’s X3D Working Group meeting, Friday October 7, 09-1000 pacific.  Only a handful are outstanding and we expect to resolve them all as either (a) ballot submission, or (b) defer to X3D4.1. Participation welcome.
 
Have fun with X3D clarity!  8)
 
all the best, Don
-- 
Don Brutzman  Naval Postgraduate School, Code USW/Br        brutzman at nps.edu
Watkins 270,  MOVES Institute, Monterey CA 93943-5000 USA    +1.831.656.2149
X3D graphics, virtual worlds, Navy robotics https:// faculty.nps.edu/brutzman
 
_______________________________________________
x3d-public mailing list
x3d-public at web3d.org
http://web3d.org/mailman/listinfo/x3d-public_web3d.org

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20221006/939a4a4f/attachment.html>