<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.3//EN" "https://www.web3d.org/specifications/x3d-3.3.dtd">
<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 ' >
<head>
<meta name='title' content=' PositionOrientationInterpolatorsExampleTraced.x3d '/>
<meta name='description' content='Demonstrate use of PositionInterpolator and OrientationInterpolator to animate object motion, with console output tracing added for PositionInterpolator and ROUTE events.'/>
<meta name='creator' content='Don Brutzman'/>
<meta name='created' content='5 August 2011'/>
<meta name='modified' content='27 August 2023'/>
<meta name='reference' content=' Chapter07EventAnimationInterpolation-EventTracing.pdf '/>
<meta name='reference' content=' PositionOrientationInterpolatorsExampleTracedConsole.txt '/>
<meta name='MovingImage' content=' PositionOrientationInterpolatorsExample.mp4 '/>
<meta name='reference' content=' PositionOrientationInterpolatorsExample.x3d '/>
<meta name='reference' content=' https://X3dGraphics.com '/>
<meta name='reference' content=' https://www.web3d.org/x3d/content/examples/X3dResources.html '/>
<meta name='rights' content='Copyright Don Brutzman and Leonard Daly 2007'/>
<meta name='subject' content=' X3D book, X3D graphics, X3D-Edit, http://www.x3dGraphics.com '/>
<meta name='reference' content=' https://savage.nps.edu/Savage/Tools/Animation/WaypointInterpolatorExample.x3d '/>
<meta name='identifier' content=' https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/PositionOrientationInterpolatorsExampleTraced.x3d '/>
<meta name='generator' content='X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit'/>
<meta name='license' content=' ../license.html'/>
</head>
<!--
to top <!-- Event Graph ROUTE Table shows event connections -->
 
<!-- Index for DEF nodes: AnimationClock, ConeMaterial, Floor, OrientationAnimator, Pointer, PositionAnimator, Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction, Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation, Trace_ROUTE_PositionInterpolator_PositionAnimator
Index for Viewpoint nodes: Viewpoint_1, Viewpoint_2
-->
<Scene>
<WorldInfo title='PositionOrientationInterpolatorsExampleTraced.x3d'/>
<Viewpoint description='Animation demo' orientation='1 0 0 -0.588003' position='0 8 12'/>
<Viewpoint centerOfRotation='5 0.1 5' description='View from above' orientation='1 0 0 -1.570796' position='0 15 0'/>
<!-- ROUTE information for Pointer node:  [from PositionAnimator.value_changed to translation ] [from OrientationAnimator.value_changed to set_rotation ] -->
 <Transform DEF='Pointer' translation='1 0 1'>
<Transform rotation='1 0 0 1.57'>
<Shape>
<Cone bottomRadius='0.5' height='1.5'/>
<Appearance>
<Material DEF='ConeMaterial' diffuseColor='0.427451 1 0.160784'/>
</Appearance>
</Shape>
</Transform>
</Transform>
<Shape DEF='Floor'>
<Box size='12 0.05 12'/>
<Appearance>
<Material diffuseColor='0 0.262745 0.941176'/>
</Appearance>
</Shape>
<!-- note that final value equals first value in keyValue array in order to support smooth looping -->
<!-- first drive around the location -->
<!-- ROUTE information for PositionAnimator node:  [from AnimationClock.fraction_changed to set_fraction ] [from value_changed to Trace_ROUTE_PositionInterpolator_PositionAnimator.value_changed ] [from key to Trace_ROUTE_PositionInterpolator_PositionAnimator.key ] [from keyValue to Trace_ROUTE_PositionInterpolator_PositionAnimator.keyValue ] [from value_changed to Pointer.translation ] [from value_changed to Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation.traceValue ] -->
 <PositionInterpolator DEF='PositionAnimator' key='0 0.2 0.25 0.45 0.5 0.7 0.75 0.95 1' keyValue='-4 0 -4 -4 0 4 -4 0 4 4 0 4 4 0 4 4 0 -4 4 0 -4 -4 0 -4 -4 0 -4'/>

<Group>
<!-- ======= PositionInterpolator Trace ============================================== -->
<!-- ROUTE information for Trace_ROUTE_PositionInterpolator_PositionAnimator node:  [from PositionAnimator.value_changed to value_changed ] [from PositionAnimator.key to key ] [from PositionAnimator.keyValue to keyValue ] -->
 <Script DEF='Trace_ROUTE_PositionInterpolator_PositionAnimator' mustEvaluate='true'>
<field name='reportInterval' type='SFTime' value='1.0' accessType='initializeOnly'
 appinfo='Sampling frequency in seconds (0 means all values)' />
<!-- Trace ROUTEd values on X3D browser console -->
<field name='value_changed' type='SFVec3f' accessType='inputOnly'/>
<field name='key' type='MFFloat' accessType='inputOnly'/>
<field name='keyValue' type='MFVec3f' accessType='inputOnly'/>
<field name='timeStampPreviousReport' type='SFTime' value='-1' accessType='initializeOnly'/>
<![CDATA[ 
        
ecmascript:
    function value_changed (eventValue, timeStamp) {
      if (timeStamp - timeStampPreviousReport >= reportInterval) {
        Browser.println ('Trace_ROUTE_PositionInterpolator_PositionAnimator type=SFVec3f value_changed=' + eventValue.toString());
        timeStampPreviousReport = timeStamp;
      }
    }
    function key (eventValue) {
      Browser.println ('Trace_ROUTE_PositionInterpolator_PositionAnimator type=MFFloat key=' + eventValue.toString());
    }
    function keyValue (eventValue) {
      Browser.println ('Trace_ROUTE_PositionInterpolator_PositionAnimator type=MFVec3f keyValue=' + eventValue.toString());
    }
]]>
</Script>
< ROUTE  fromNode=' PositionAnimator' fromField='value_changed' toNode=' Trace_ROUTE_PositionInterpolator_PositionAnimator' toField='value_changed'/>
< ROUTE  fromNode=' PositionAnimator' fromField='key' toNode=' Trace_ROUTE_PositionInterpolator_PositionAnimator' toField='key'/>
< ROUTE  fromNode=' PositionAnimator' fromField='keyValue' toNode=' Trace_ROUTE_PositionInterpolator_PositionAnimator' toField='keyValue'/>
<!-- ======= PositionInterpolator Trace block complete ===================================================== -->
</Group>
< ROUTE  fromNode=' PositionAnimator' fromField='value_changed' toNode=' Pointer' toField='translation'/>
<Group>
<!-- ======= ROUTE Trace ============================================== -->
<!-- ROUTE information for Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation node:  [from PositionAnimator.value_changed to traceValue ] -->
 <Script DEF='Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation' mustEvaluate='true'>
<!-- Trace ROUTEd values on X3D browser console -->
<field name='reportInterval' type='SFTime' value='1.0' accessType='initializeOnly'
 appinfo='Sampling frequency in seconds (0 means all values)' />
<field name='traceValue' type='SFVec3f' accessType='inputOnly'/>
<field name='timeStampPreviousReport' type='SFTime' value='-1' accessType='initializeOnly'/>
<![CDATA[ 
        
ecmascript:
    function traceValue (eventValue, timeStamp) {
      // input eventValue received for trace field
      if (timeStamp - timeStampPreviousReport >= reportInterval) {
        Browser.println ('Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation type=SFVec3f value=' + eventValue.toString());
        timeStampPreviousReport = timeStamp;
      }
    }
    function timeOfDay (someTime) {
      hh = Math.floor (someTime /(60*60)) % 24;
      mm = Math.floor (someTime / 60)     % 60;
      ss = Math.floor (someTime)          % 60;
      if (hh < 9) hour   = '0' + hh;
      else        hour   =       hh;
      if (mm < 9) minute = '0' + mm;
      else        minute =       mm;
      if (ss < 9) second = '0' + ss;
      else        second =       ss;
      return '(' + hour + ':' + minute + ':' + second + ' GMT)';
    }
]]>
</Script>
< ROUTE  fromNode=' PositionAnimator' fromField='value_changed' toNode=' Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation' toField='traceValue'/>
<!-- ======= ROUTE Trace block complete ===================================================== -->
</Group>
<!-- then rotate the pointer to match next direction while paused at each position -->
<!-- ROUTE information for OrientationAnimator node:  [from AnimationClock.fraction_changed to set_fraction ] [from value_changed to Pointer.set_rotation ] -->
 <OrientationInterpolator DEF='OrientationAnimator' key='0 0.2 0.25 0.45 0.5 0.7 0.75 0.95 1' keyValue='0 1 0 0 0 1 0 0 0 1 0 1.57 0 1 0 1.57 0 1 0 3.14 0 1 0 3.14 0 1 0 4.71 0 1 0 4.71 0 1 0 6.283'/>

<!-- final rotation value is 2pi rather than 0 so that rotation animation is smooth, not flip-flopping -->
< ROUTE  fromNode=' OrientationAnimator' fromField='value_changed' toNode=' Pointer' toField='set_rotation'/>
<!-- put TimeSensor clock last so that animation design pattern and ROUTE events flow upward -->
<!-- ROUTE information for AnimationClock node:  [from fraction_changed to PositionAnimator.set_fraction ] [from fraction_changed to Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction.traceValue ] [from fraction_changed to OrientationAnimator.set_fraction ] -->
 <TimeSensor DEF='AnimationClock' cycleInterval='10' loop='true'/>

< ROUTE  fromNode=' AnimationClock' fromField='fraction_changed' toNode=' PositionAnimator' toField='set_fraction'/>
<Group>
<!-- ======= ROUTE Trace ============================================== -->
<!-- ROUTE information for Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction node:  [from AnimationClock.fraction_changed to traceValue ] -->
 <Script DEF='Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction' mustEvaluate='true'>
<!-- Trace ROUTEd values on X3D browser console -->
<field name='reportInterval' type='SFTime' value='1.0' accessType='initializeOnly'
 appinfo='Sampling frequency in seconds (0 means all values)' />
<field name='traceValue' type='SFFloat' accessType='inputOnly'/>
<field name='timeStampPreviousReport' type='SFTime' value='-1' accessType='initializeOnly'/>
<![CDATA[ 
        
ecmascript:
    function traceValue (eventValue, timeStamp) {
      // input eventValue received for trace field
      if (timeStamp - timeStampPreviousReport >= reportInterval) {
        Browser.println ('Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction type=SFFloat value=' + eventValue);
        timeStampPreviousReport = timeStamp;
      }
    }
    function timeOfDay (someTime) {
      hh = Math.floor (someTime /(60*60)) % 24;
      mm = Math.floor (someTime / 60)     % 60;
      ss = Math.floor (someTime)          % 60;
      if (hh < 9) hour   = '0' + hh;
      else        hour   =       hh;
      if (mm < 9) minute = '0' + mm;
      else        minute =       mm;
      if (ss < 9) second = '0' + ss;
      else        second =       ss;
      return '(' + hour + ':' + minute + ':' + second + ' GMT)';
    }
]]>
</Script>
< ROUTE  fromNode=' AnimationClock' fromField='fraction_changed' toNode=' Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction' toField='traceValue'/>
<!-- ======= ROUTE Trace block complete ===================================================== -->
</Group>
< ROUTE  fromNode=' AnimationClock' fromField='fraction_changed' toNode=' OrientationAnimator' toField='set_fraction'/>
<!-- notice that explanatory Text is placed later in scene although it is graphically located above driving plane -->
<Transform translation='0 4 0'>
<Billboard axisOfRotation='0 0 0'>
<Shape>
<Text string='"Animation using PositionInterpolator" "and OrientationInterpolator"'>
<FontStyle justify='"MIDDLE" "MIDDLE"' size='0.6'/>
</Text>
<Appearance>
<Material/>
</Appearance>
</Shape>
</Billboard>
</Transform>
</Scene>
</X3D>
<!--
to top <!-- Event Graph ROUTE Table shows event connections -->
 
<!-- Index for DEF nodes: AnimationClock, ConeMaterial, Floor, OrientationAnimator, Pointer, PositionAnimator, Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction, Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation, Trace_ROUTE_PositionInterpolator_PositionAnimator
Index for Viewpoint nodes: Viewpoint_1, Viewpoint_2
-->

Event Graph ROUTE Table entries with 9 ROUTE connections total, showing X3D event-model relationships for this scene.

Each row shows an event cascade that may occur during a single timestamp interval between frame renderings, as part of the X3D execution model.

AnimationClock
TimeSensor
fraction_changed
SFFloat

ROUTE
event to
(1)
PositionAnimator
PositionInterpolator
set_fraction
SFFloat
 
 
then 		PositionAnimator
PositionInterpolator
key
MFFloat

ROUTE
event to
(2)
Trace_ROUTE_PositionInterpolator_PositionAnimator
Script
key
MFFloat
 
 
 
then 		PositionAnimator
PositionInterpolator
keyValue
MFVec3f

ROUTE
event to
(2)
Trace_ROUTE_PositionInterpolator_PositionAnimator
Script
keyValue
MFVec3f
 
 
 
then 		PositionAnimator
PositionInterpolator
value_changed
SFVec3f

ROUTE
event to
(2)
Trace_ROUTE_PositionInterpolator_PositionAnimator
Script
value_changed
SFVec3f
 
 
 
then 		PositionAnimator
PositionInterpolator
value_changed
SFVec3f

ROUTE
event to
(2)
Pointer
Transform
translation
SFVec3f
 
 
 
then 		PositionAnimator
PositionInterpolator
value_changed
SFVec3f

ROUTE
event to
(2)
Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation
Script
traceValue
SFVec3f
AnimationClock
TimeSensor
fraction_changed
SFFloat

ROUTE
event to
(1)
Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction
Script
traceValue
SFFloat
AnimationClock
TimeSensor
fraction_changed
SFFloat

ROUTE
event to
(1)
OrientationAnimator
OrientationInterpolator
set_fraction
SFFloat
 
 
then 		OrientationAnimator
OrientationInterpolator
value_changed
SFRotation

ROUTE
event to
(2)
Pointer
Transform
set_rotation
SFRotation


-->

<!-- Online at
https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/PositionOrientationInterpolatorsExampleTracedIndex.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/PositionOrientationInterpolatorsExampleTraced.x3d -->

<!-- Color 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)
-->

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