X3D Model Documentation: PositionOrientationInterpolatorsExample.x3d

  1  <?xml version="1.0" encoding="UTF-8"?>
  2  <!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.3//EN" "https://www.web3d.org/specifications/x3d-3.3.dtd">
  3  <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'>
  4       <head>
  5            <meta name='titlecontent='PositionOrientationInterpolatorsExample.x3d'/>
  6            <meta name='descriptioncontent='Demonstrate use of PositionInterpolator and OrientationInterpolator to animate object motion.'/>
  7            <meta name='creatorcontent='Don Brutzman'/>
  8            <meta name='createdcontent='29 January 2008'/>
  9            <meta name='modifiedcontent='20 October 2019'/>
 10            <meta name='MovingImagecontent='PositionOrientationInterpolatorsExample.mp4'/>
 11            <meta name='referencecontent='PositionOrientationInterpolatorsExampleTraced.x3d'/>
 12            <meta name='referencecontent='https://X3dGraphics.com'/>
 13            <meta name='referencecontent='https://www.web3d.org/x3d/content/examples/X3dResources.html'/>
 14            <meta name='rightscontent='Copyright Don Brutzman and Leonard Daly 2007'/>
 15            <meta name='subjectcontent='X3D book, X3D graphics, X3D-Edit, http://www.x3dGraphics.com'/>
 16            <meta name='referencecontent='https://savage.nps.edu/Savage/Tools/Animation/WaypointInterpolatorExample.x3d'/>
 17            <meta name='identifiercontent='https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/PositionOrientationInterpolatorsExample.x3d'/>
 18            <meta name='generatorcontent='X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit'/>
 19            <meta name='licensecontent='../license.html'/>
 20       </head>
<!--

<!--
Event Graph ROUTE Table shows event connections.
-->

<!-- to top Index for DEF nodes: AnimationClock, ConeMaterial, Floor, OrientationAnimator, Pointer, PositionAnimator

Index for Viewpoint nodes: Viewpoint_1, Viewpoint_2
-->
 21       <Scene>
 22            <WorldInfo title='PositionOrientationInterpolatorsExample.x3d'/>
 23            <Viewpoint description='Animation demoorientation='1 0 0 -0.588003position='0 8 12'/>
 24            <Viewpoint centerOfRotation='5 0.1 5description='View from aboveorientation='1 0 0 -1.570796position='0 15 0'/>
 25 
          <!-- ROUTE information for Pointer node:  [from PositionAnimator.value_changed to set_translation ] [from OrientationAnimator.value_changed to set_rotation ] -->
          <Transform DEF='Pointertranslation='1 0 1'>
 26                 <Transform rotation='1 0 0 1.57'>
 27                      <Shape>
 28                           <Cone bottomRadius='0.5height='1.5'/>
 29                           <Appearance>
 30                                <Material DEF='ConeMaterialdiffuseColor='0.427451 1 0.160784'/>
 31                           </Appearance>
 32                      </Shape>
 33                 </Transform>
 34            </Transform>
 35            <Shape DEF='Floor'>
 36                 <Box size='12 0.05 12'/>
 37                 <Appearance>
 38                      <Material diffuseColor='0 0.262745 0.941176'/>
 39                 </Appearance>
 40            </Shape>
 41            <!-- note that final value equals first value in keyValue array in order to support smooth looping -->
 42            <!-- first drive around the location -->
 43 
          <!-- ROUTE information for PositionAnimator node:  [from AnimationClock.fraction_changed to set_fraction ] [from value_changed to Pointer.set_translation ] -->
          <PositionInterpolator DEF='PositionAnimatorkey='0 0.2 0.25 0.45 0.5 0.7 0.75 0.95 1keyValue='-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'/>
 44            < ROUTE  fromNode='PositionAnimator' fromField='value_changed' toNode='Pointer' toField='set_translation'/>
 45            <!-- then rotate the pointer to match next direction while paused at each position -->
 46 
          <!-- ROUTE information for OrientationAnimator node:  [from AnimationClock.fraction_changed to set_fraction ] [from value_changed to Pointer.set_rotation ] -->
          <OrientationInterpolator DEF='OrientationAnimatorkey='0 0.2 0.25 0.45 0.5 0.7 0.75 0.95 1keyValue='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'/>
 47            <!-- final rotation value is 2pi rather than 0 so that rotation animation is smooth, not flip-flopping -->
 48            < ROUTE  fromNode='OrientationAnimator' fromField='value_changed' toNode='Pointer' toField='set_rotation'/>
 49            <!-- put TimeSensor clock last so that animation design pattern and ROUTE events flow upward -->
 50 
          <!-- ROUTE information for AnimationClock node:  [from fraction_changed to PositionAnimator.set_fraction ] [from fraction_changed to OrientationAnimator.set_fraction ] -->
          <TimeSensor DEF='AnimationClockcycleInterval='10loop='true'/>
 51            < ROUTE  fromNode='AnimationClock' fromField='fraction_changed' toNode='PositionAnimator' toField='set_fraction'/>
 52            < ROUTE  fromNode='AnimationClock' fromField='fraction_changed' toNode='OrientationAnimator' toField='set_fraction'/>
 53            <!-- notice that explanatory Text is placed later in scene although it is graphically located above driving plane -->
 54            <Transform translation='0 4 0'>
 55                 <Billboard axisOfRotation='0 0 0'>
 56                      <Shape>
 57                           <Text string='"Animation using PositionInterpolator" "and OrientationInterpolator"'>
 58                                <FontStyle justify='"MIDDLE" "MIDDLE"size='0.6'/>
 59                           </Text>
 60                           <Appearance>
 61                                <Material/>
 62                           </Appearance>
 63                      </Shape>
 64                 </Billboard>
 65            </Transform>
 66       </Scene>
 67  </X3D>
<!--

<!--
Event Graph ROUTE Table shows event connections.
-->

<!-- to top Index for DEF nodes: AnimationClock, ConeMaterial, Floor, OrientationAnimator, Pointer, PositionAnimator

Index for Viewpoint nodes: Viewpoint_1, Viewpoint_2
-->
X3D Tooltips element index: Appearance, Billboard, Box, Cone, FontStyle, head, Material, meta, OrientationInterpolator, PositionInterpolator, ROUTE, Scene, Shape, Text, TimeSensor, Transform, Viewpoint, WorldInfo, X3D, accessType and type, XML data types, field types

Event Graph ROUTE Table with 4 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
value_changed
SFVec3f

ROUTE
event to
(2)
Pointer
Transform
set_translation
SFVec3f
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
Additional guidance on X3D animation can be found in the 10-Step Animation Design Process and Event Tracing hint sheets. Have fun with X3D! 😀

-->
<!-- Online at
https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/PositionOrientationInterpolatorsExampleIndex.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/PositionOrientationInterpolatorsExample.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. -->