<?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 content='PositionOrientationInterpolatorsExampleTraced.x3d' name='title'/>
    <meta content='Demonstrate use of PositionInterpolator and OrientationInterpolator to animate object motion, with console output tracing added for PositionInterpolator and ROUTE events.' name='description'/>
    <meta content='Don Brutzman' name='creator'/>
    <meta content='5 August 2011' name='created'/>
    <meta content='2 March 2026' name='modified'/>
    <meta content='Chapter07EventAnimationInterpolation-EventTracing.pdf' name='reference'/>
    <meta content='Chapter07EventAnimationInterpolation-10StepAnimationDesignProcess.pdf' name='reference'/>
    <meta content='PositionOrientationInterpolatorsExampleTracedConsole.txt' name='reference'/>
    <meta content='PositionOrientationInterpolatorsExample.mp4' name='MovingImage'/>
    <meta content='PositionOrientationInterpolatorsExample.x3d' name='reference'/>
    <meta content='https://X3dGraphics.com' name='reference'/>
    <meta content='https://www.web3d.org/x3d/content/examples/X3dResources.html' name='reference'/>
    <meta content='Copyright Don Brutzman and Leonard Daly 2007' name='rights'/>
    <meta content='X3D book, X3D graphics, X3D-Edit, http://www.x3dGraphics.com' name='subject'/>
    <meta content='https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/WaypointInterpolatorExample.x3d' name='reference'/>
    <meta content='https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/PositionOrientationInterpolatorsExampleTraced.x3d' name='identifier'/>
    <meta content='X3D-Edit 3.3, https://www.web3d.org/x3d/tools/X3D-Edit' name='generator'/>
    <meta content='../license.html' name='license'/>
  </head>
  <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'/>
    <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 -->
    <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 ============================================== -->
      <Script DEF='Trace_ROUTE_PositionInterpolator_PositionAnimator' mustEvaluate='true'>
        <field accessType='initializeOnly' appinfo='Sampling frequency in seconds (0 means all values)' name='reportInterval' type='SFTime' value='1.0'/>
        <!-- Trace ROUTEd values on X3D browser console -->
        <field accessType='inputOnly' name='value_changed' type='SFVec3f'/>
        <field accessType='inputOnly' name='key' type='MFFloat'/>
        <field accessType='inputOnly' name='keyValue' type='MFVec3f'/>
        <field accessType='initializeOnly' name='timeStampPreviousReport' type='SFTime' value='-1'/>
        <![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 fromField='value_changed' fromNode='PositionAnimator' toField='value_changed' toNode='Trace_ROUTE_PositionInterpolator_PositionAnimator'/>
      <ROUTE fromField='key' fromNode='PositionAnimator' toField='key' toNode='Trace_ROUTE_PositionInterpolator_PositionAnimator'/>
      <ROUTE fromField='keyValue' fromNode='PositionAnimator' toField='keyValue' toNode='Trace_ROUTE_PositionInterpolator_PositionAnimator'/>
      <!-- ======= PositionInterpolator Trace block complete ===================================================== -->
    </Group>
    <ROUTE fromField='value_changed' fromNode='PositionAnimator' toField='translation' toNode='Pointer'/>
    <Group>
      <!-- ======= ROUTE Trace ============================================== -->
      <Script DEF='Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation' mustEvaluate='true'>
        <!-- Trace ROUTEd values on X3D browser console -->
        <field accessType='initializeOnly' appinfo='Sampling frequency in seconds (0 means all values)' name='reportInterval' type='SFTime' value='1.0'/>
        <field accessType='inputOnly' name='traceValue' type='SFVec3f'/>
        <field accessType='initializeOnly' name='timeStampPreviousReport' type='SFTime' value='-1'/>
        <![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 fromField='value_changed' fromNode='PositionAnimator' toField='traceValue' toNode='Trace_ROUTE_PositionAnimator_value_changed_TO_Pointer_translation'/>
      <!-- ======= ROUTE Trace block complete ===================================================== -->
    </Group>
    <!-- then rotate the pointer to match next direction while paused at each position -->
    <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 fromField='value_changed' fromNode='OrientationAnimator' toField='set_rotation' toNode='Pointer'/>
    <!-- put TimeSensor clock last so that animation design pattern and ROUTE events flow upward -->
    <TimeSensor DEF='AnimationClock' cycleInterval='10' loop='true'/>
    <ROUTE fromField='fraction_changed' fromNode='AnimationClock' toField='set_fraction' toNode='PositionAnimator'/>
    <Group>
      <!-- ======= ROUTE Trace ============================================== -->
      <Script DEF='Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction' mustEvaluate='true'>
        <!-- Trace ROUTEd values on X3D browser console -->
        <field accessType='initializeOnly' appinfo='Sampling frequency in seconds (0 means all values)' name='reportInterval' type='SFTime' value='1.0'/>
        <field accessType='inputOnly' name='traceValue' type='SFFloat'/>
        <field accessType='initializeOnly' name='timeStampPreviousReport' type='SFTime' value='-1'/>
        <![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 fromField='fraction_changed' fromNode='AnimationClock' toField='traceValue' toNode='Trace_ROUTE_AnimationClock_fraction_changed_TO_PositionAnimator_set_fraction'/>
      <!-- ======= ROUTE Trace block complete ===================================================== -->
    </Group>
    <ROUTE fromField='fraction_changed' fromNode='AnimationClock' toField='set_fraction' toNode='OrientationAnimator'/>
    <!-- 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>