<?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='Interchange'  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=' NormalInterpolatorExample.x3d '/>
<meta name='description' content='Example normal (perpendicular vector) animation, where orange vectors show normal direction at each polygon vertex.'/>
<meta name='creator' content='Don Brutzman'/>
<meta name='created' content='3 May 2008'/>
<meta name='modified' content='25 August 2023'/>
<meta name='reference' content=' https://www.web3d.org/x3d/content/examples/Vrml2Sourcebook/Chapter19-NormalsShading/Figure19.27SquareFaceAnimatingNormals.x3d '/>
<meta name='subject' content='X3D NormalInterpolator example'/>
<meta name='identifier' content=' https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/NormalInterpolatorExample.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: AnimatedNormalNode, Clock, FlatSquare, LightBlue, NormalPath, NormalVectors, NormalVectorsAnimation
Index for Viewpoint nodes: Viewpoint_1, Viewpoint_2
-->
<Scene>
<WorldInfo title='NormalInterpolatorExample.x3d'/>
<Viewpoint description='Animating normals on right vertices of a quadrilateral' position='0 0 8'/>
<Viewpoint description='Other side - note difference in animated shading' orientation='0 1 0 3.14159' position='0 0 -7'/>
<Shape>
<IndexedFaceSet DEF='FlatSquare' solid='false' coordIndex='0 1 2 3' normalIndex='0 1 2 3'>
<Coordinate point='-2 -2 0 2 -2 0 2 2 0 -2 2 0'/>
<!-- Normal vector with 4 SFVec3f triplet values, one for each corner of quadrilateral -->
<!-- ROUTE information for AnimatedNormalNode node:  [from NormalPath.value_changed to set_vector ] -->
 <Normal DEF='AnimatedNormalNode' vector='0 0 1 0 0 1 0 0 1 0 0 1'/>
</IndexedFaceSet>
<Appearance>
<Material DEF='LightBlue' diffuseColor='0.3 0.6 0.9'/>
</Appearance>
</Shape>
<!-- NormalInterpolator keyValue array must match sizes of target Normal vector and key arrays -->
<!-- Thus this keyValue array has 4 * 3 = 12 total SFVec3f triplet values -->
<!-- ROUTE information for NormalPath node:  [from Clock.fraction_changed to set_fraction ] [from value_changed to AnimatedNormalNode.set_vector ] -->
 <NormalInterpolator DEF='NormalPath' key='0 0.5 1' keyValue='0 0 1 0 0 1 0 0 1 0 0 1 0 0 1 1 0 0 1 0 0 0 0 1 0 0 1 0 0 1 0 0 1 0 0 1'/>

< ROUTE  fromNode=' NormalPath' fromField='value_changed' toNode=' AnimatedNormalNode' toField='set_vector'/>
<!-- ROUTE information for Clock node:  [from fraction_changed to NormalPath.set_fraction ] [from fraction_changed to NormalVectorsAnimation.set_fraction ] -->
 <TimeSensor DEF='Clock' cycleInterval='8' loop='true'/>

< ROUTE  fromNode=' Clock' fromField='fraction_changed' toNode=' NormalPath' toField='set_fraction'/>
<!-- This block above completes the primary functionality of this scene. More to follow, however! -->
<!-- ============================================================================================================== -->
<!-- Note that a Normal is not rendered - it is invisible. So this scene adds some lines to visualize what is happening. -->
<Shape>
<IndexedLineSet coordIndex='0 1 -1 2 3 -1 4 5 -1 6 7 -1'>
<!-- ROUTE information for NormalVectors node:  [from NormalVectorsAnimation.value_changed to point ] -->
 <Coordinate DEF='NormalVectors' point='-2 -2 0 -2 -2 1 2 -2 0 2 -2 1 2 2 0 2 2 1 -2 2 0 -2 2 1'/>
</IndexedLineSet>
<Appearance>
<Material emissiveColor='0.9 0.6 0.1'/>
</Appearance>
</Shape>
<!-- ROUTE information for NormalVectorsAnimation node:  [from Clock.fraction_changed to set_fraction ] [from value_changed to NormalVectors.point ] -->
 <CoordinateInterpolator DEF='NormalVectorsAnimation' key='0 0.5 1' keyValue='-2 -2 0 -2 -2 1 2 -2 0 2 -2 1 2 2 0 2 2 1 -2 2 0 -2 2 1 -2 -2 0 -2 -2 1 2 -2 0 3 -2 0 2 2 0 3 2 0 -2 2 0 -2 2 1 -2 -2 0 -2 -2 1 2 -2 0 2 -2 1 2 2 0 2 2 1 -2 2 0 -2 2 1'/>

< ROUTE  fromNode=' NormalVectorsAnimation' fromField='value_changed' toNode=' NormalVectors' toField='point'/>
< ROUTE  fromNode=' Clock' fromField='fraction_changed' toNode=' NormalVectorsAnimation' toField='set_fraction'/>
</Scene>
</X3D>
<!--
to top <!-- Event Graph ROUTE Table shows event connections -->
 
<!-- Index for DEF nodes: AnimatedNormalNode, Clock, FlatSquare, LightBlue, NormalPath, NormalVectors, NormalVectorsAnimation
Index for Viewpoint nodes: Viewpoint_1, Viewpoint_2
-->

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.

Clock
TimeSensor
fraction_changed
SFFloat

ROUTE
event to
(1)
NormalPath
NormalInterpolator
set_fraction
SFFloat
 
 
then 		NormalPath
NormalInterpolator
value_changed
SFVec3f

ROUTE
event to
(2)
AnimatedNormalNode
Normal
set_vector
MFVec3f
Clock
TimeSensor
fraction_changed
SFFloat

ROUTE
event to
(1)
NormalVectorsAnimation
CoordinateInterpolator
set_fraction
SFFloat
 
 
then 		NormalVectorsAnimation
CoordinateInterpolator
value_changed
MFVec3f

ROUTE
event to
(2)
NormalVectors
Coordinate
point
MFVec3f

-->

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