[x3d-public] HAnim2 Motion node is missing startFrame, endFrame fields

[Don Brutzman]

Useful fields startFrame, endFrame fields are missing from interface of Motion node in HAnim2 specification.  They are correctly described in specification text.

[1] HAnim2, 6 HAnim motion data animation using Motion objects
     6.3 Data structure of Motion object
     https://www.web3d.org/documents/specifications/19774/V2.0/MotionDataAnimation/MotionNodes.html#MotionObject

Missing entries:

   int   startFrame   0   [0,infinity]
   int   endFrame     0   [0,infinity]

Prose is there OK.  Excerpt from approved specification:

==================
"The startFrame and endFrame fields indicate the index numbers for the initial and final frames that are animated by the Motion node. Note that startFrame can precede, equal or follow endFrame. The default endFrame value is reset to (frameCount - 1) whenever frameCount is changed. Similar to frameIndex, the values of startFrame and endFrame shall be greater than or equal to zero, and less than frameCount.

Receipt of a next event with value true triggers the next set of enabled channel animation values to be applied by the Motion object. Receipt of a previous event with value true triggers the previous set of enabled channel animation values to be applied by the Motion object. Sending a false event to the next or previous fields has no effect. These trigger events "wrap around" after reaching the boundary of startFrame and endFrame; i.e., next goes to startFrame after endFrame, and previous goes to endFrame after startFrame.

The loop field controls whether automatic repetitions occur. The Motion object executes in cycles, where a cycle is defined as a complete execution through endFrame. If, at the end of a cycle, the value of loop is false, execution is terminated. Conversely, if loop is true at the end of a cycle, the Motion object continues execution into the next cycle at startFrame. Thus, Motion object animation with loop true at the end of every cycle continues cycling indefinitely."
==================

Similarly needed in X3D4 Architecture 26.3.4 HAnimMotion, X3D Schema/DTD, X3DUOM, X3D Tooltips.

   SFInt32  [in out]    startFrame	0          [0,∞)
   SFInt32  [in out]    endFrame	 	0          [0,∞)

For issue-tracking purposes, entered as

[2] Mantis 1321: HAnim2 Motion node is missing startFrame, endFrame fields
     https://www.web3d.org/member-only/mantis/view.php?id=1321

[3] Mantis 1322: X3D4 HAnimMotion node is missing startFrame, endFrame fields
     https://www.web3d.org/member-only/mantis/view.php?id=1322

Review is welcome.  Apologies for this editorial omission!

Absent uproar, Dick and I will add and commit these important additions in all appropriate locations.

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 http://faculty.nps.edu/brutzman