<?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=' ColorInterpolatorExample.x3d '/>
<meta name='description' content='Demonstrate basic design pattern for animating a node.'/>
<meta name='creator' content='Don Brutzman'/>
<meta name='created' content='17 April 2005'/>
<meta name='modified' content='20 October 2019'/>
<meta name='drawing' content='ColorInterpolatorExampleSceneGraphWithRoutes.png'/>
<meta name='Image' content='ColorInterpolatorExample4Colors.png' />
<meta name='subject' content='Animation ColorInterpolator'/>
<meta name='identifier' content=' https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/ColorInterpolatorExample.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, ColorChanger, SphereMaterial, TextTriggerTouchSensor
-->
<Scene>
<WorldInfo title='ColorInterpolatorExample.x3d'/>
<Group>
<!-- Place triggering text above sphere of interest -->
<Transform translation='0 2 0'>
<Shape>
<Text string='"Touch text to" "start animation..."'>
<FontStyle justify='"MIDDLE" "MIDDLE"'/>
</Text>
<Appearance>
<Material/>
</Appearance>
</Shape>
<!-- Selectable Text design pattern has transparent Box and TouchSensor description as a tooltip -->
<Shape>
<Box size='6.2 2 .001'/>
<Appearance>
<Material transparency='1'/>
</Appearance>
</Shape>
<!-- This TouchSensor only reacts to user clicking on the sibling Shape and Text, because it is under a parent Transform grouping node -->
<!-- ROUTE information for TextTriggerTouchSensor node:  [from touchTime to AnimationClock.startTime ] -->
 <TouchSensor DEF='TextTriggerTouchSensor' description='Touch text to start...'/>
</Transform>
<!-- Here is Sphere with accompanying Material that will get animated -->
<Transform translation='0 -1 0'>
<Shape>
<Sphere/>
<Appearance>
<!-- SphereMaterial diffuseColor gets overridden by interpolator output -->
<!-- ROUTE information for SphereMaterial node:  [from ColorChanger.value_changed to diffuseColor ] -->
 <Material DEF='SphereMaterial' diffuseColor='0.5 0.5 0.5'/>
</Appearance>
</Shape>
</Transform>
<!-- TimeSensor is triggered to start by TouchSensor, then sends animating values to Interpolator -->
<!-- ROUTE information for AnimationClock node:  [from TextTriggerTouchSensor.touchTime to startTime ] [from fraction_changed to ColorChanger.set_fraction ] -->
 <TimeSensor DEF='AnimationClock' cycleInterval='6'/>

<!-- ROUTE 1: TouchSensor trigger to TimeSensor clock -->
< ROUTE  fromNode=' TextTriggerTouchSensor' fromField='touchTime' toNode=' AnimationClock' toField='startTime'/>
<!-- Interpolator: ColorChanger interpolates evenly between red, green, blue and then back to red -->
<!-- ROUTE information for ColorChanger node:  [from AnimationClock.fraction_changed to set_fraction ] [from value_changed to SphereMaterial.diffuseColor ] -->
 <ColorInterpolator DEF='ColorChanger' key='0 0.3333 0.6666 1' keyValue='1 0 0 0 1 0 0 0 1 1 0 0'/>

<!-- ROUTE 2: the ColorChanger interpolator gets stimulated by AnimationClock TimeSensor fraction to compute a color value -->
< ROUTE  fromNode=' AnimationClock' fromField='fraction_changed' toNode=' ColorChanger' toField='set_fraction'/>
<!-- ROUTE 3: Interpolator output is sent to target node of interest. Changed color value is routed to SphereMaterial color. -->
< ROUTE  fromNode=' ColorChanger' fromField='value_changed' toNode=' SphereMaterial' toField='diffuseColor'/>
</Group>
</Scene>
</X3D>
<!--
to top <!-- Event Graph ROUTE Table shows event connections -->
 
<!-- Index for DEF nodes: AnimationClock, ColorChanger, SphereMaterial, TextTriggerTouchSensor
-->

Event Graph ROUTE Table entries with 3 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.

TextTriggerTouchSensor
TouchSensor
touchTime
SFTime

ROUTE
event to
(1)
AnimationClock
TimeSensor
startTime
SFTime
 
 
then 		AnimationClock
TimeSensor
fraction_changed
SFFloat

ROUTE
event to
(2)
ColorChanger
ColorInterpolator
set_fraction
SFFloat
 
 
then 		ColorChanger
ColorInterpolator
value_changed
SFColor

ROUTE
event to
(3)
SphereMaterial
Material
diffuseColor
SFColor


-->

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