X3D Model Documentation: NormalInterpolatorExample.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='Interchange' 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='NormalInterpolatorExample.x3d'/>
  6            <meta name='descriptioncontent='Example normal (perpendicular vector) animation, where orange vectors show normal direction at each polygon vertex.'/>
  7            <meta name='creatorcontent='Don Brutzman'/>
  8            <meta name='createdcontent='3 May 2008'/>
  9            <meta name='modifiedcontent='25 August 2023'/>
 10            <meta name='referencecontent='https://www.web3d.org/x3d/content/examples/Vrml2Sourcebook/Chapter19-NormalsShading/Figure19.27SquareFaceAnimatingNormals.x3d'/>
 11            <meta name='subjectcontent='X3D NormalInterpolator example'/>
 12            <meta name='identifiercontent='https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter07EventAnimationInterpolation/NormalInterpolatorExample.x3d'/>
 13            <meta name='generatorcontent='X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit'/>
 14            <meta name='licensecontent='../license.html'/>
 15       </head>
<!--

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

<!-- to top Index for DEF nodes: AnimatedNormalNode, Clock, FlatSquare, LightBlue, NormalPath, NormalVectors, NormalVectorsAnimation

Index for Viewpoint nodes: Viewpoint_1, Viewpoint_2
-->
 16       <Scene>
 17            <WorldInfo title='NormalInterpolatorExample.x3d'/>
 18            <Viewpoint description='Animating normals on right vertices of a quadrilateralposition='0 0 8'/>
 19            <Viewpoint description='Other side - note difference in animated shadingorientation='0 1 0 3.14159position='0 0 -7'/>
 20            <Shape>
 21                 <IndexedFaceSet DEF='FlatSquaresolid='falsecoordIndex='0 1 2 3normalIndex='0 1 2 3'>
 22                      <Coordinate point='-2 -2 0 2 -2 0 2 2 0 -2 2 0'/>
 23                      <!-- Normal vector with 4 SFVec3f triplet values, one for each corner of quadrilateral -->
 24 
                    <!-- ROUTE information for AnimatedNormalNode node:  [from NormalPath.value_changed to set_vector ] -->
                    <Normal DEF='AnimatedNormalNodevector='0 0 1 0 0 1 0 0 1 0 0 1'/>
 25                 </IndexedFaceSet>
 26                 <Appearance>
 27                      <Material DEF='LightBluediffuseColor='0.3 0.6 0.9'/>
 28                 </Appearance>
 29            </Shape>
 30            <!-- NormalInterpolator keyValue array must match sizes of target Normal vector and key arrays -->
 31            <!-- Thus this keyValue array has 4 * 3 = 12 total SFVec3f triplet values -->
 32 
          <!-- ROUTE information for NormalPath node:  [from Clock.fraction_changed to set_fraction ] [from value_changed to AnimatedNormalNode.set_vector ] -->
          <NormalInterpolator DEF='NormalPathkey='0 0.5 1keyValue='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'/>
 33            < ROUTE  fromNode='NormalPath' fromField='value_changed' toNode='AnimatedNormalNode' toField='set_vector'/>
 34 
          <!-- ROUTE information for Clock node:  [from fraction_changed to NormalPath.set_fraction ] [from fraction_changed to NormalVectorsAnimation.set_fraction ] -->
          <TimeSensor DEF='ClockcycleInterval='8loop='true'/>
 35            < ROUTE  fromNode='Clock' fromField='fraction_changed' toNode='NormalPath' toField='set_fraction'/>
 36            <!-- This block above completes the primary functionality of this scene. More to follow, however! -->
 37            <!-- ============================================================================================================== -->
 38            <!-- Note that a Normal is not rendered - it is invisible. So this scene adds some lines to visualize what is happening. -->
 39            <Shape>
 40                 <IndexedLineSet coordIndex='0 1 -1 2 3 -1 4 5 -1 6 7 -1'>
 41 
                    <!-- ROUTE information for NormalVectors node:  [from NormalVectorsAnimation.value_changed to point ] -->
                    <Coordinate DEF='NormalVectorspoint='-2 -2 0 -2 -2 1 2 -2 0 2 -2 1 2 2 0 2 2 1 -2 2 0 -2 2 1'/>
 42                 </IndexedLineSet>
 43                 <Appearance>
 44                      <Material emissiveColor='0.9 0.6 0.1'/>
 45                 </Appearance>
 46            </Shape>
 47 
          <!-- ROUTE information for NormalVectorsAnimation node:  [from Clock.fraction_changed to set_fraction ] [from value_changed to NormalVectors.point ] -->
          <CoordinateInterpolator DEF='NormalVectorsAnimationkey='0 0.5 1keyValue='-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'/>
 48            < ROUTE  fromNode='NormalVectorsAnimation' fromField='value_changed' toNode='NormalVectors' toField='point'/>
 49            < ROUTE  fromNode='Clock' fromField='fraction_changed' toNode='NormalVectorsAnimation' toField='set_fraction'/>
 50       </Scene>
 51  </X3D>
<!--

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

<!-- to top Index for DEF nodes: AnimatedNormalNode, Clock, FlatSquare, LightBlue, NormalPath, NormalVectors, NormalVectorsAnimation

Index for Viewpoint nodes: Viewpoint_1, Viewpoint_2
-->
X3D Tooltips element index: Appearance, Coordinate, CoordinateInterpolator, head, IndexedFaceSet, IndexedLineSet, Material, meta, Normal, NormalInterpolator, ROUTE, Scene, Shape, TimeSensor, 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.

Clock
TimeSensor
fraction_changed
SFFloat

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

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
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/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. -->