<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.0//EN" "https://www.web3d.org/specifications/x3d-3.0.dtd">
<X3D profile='Interactive'  version='3.0 xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation =' https://www.web3d.org/specifications/x3d-3.0.xsd ' >
<head>
<meta name='titlecontent=' Example17.x3d '/>
<meta name='translatorcontent='Don Brutzman'/>
<meta name='createdcontent='26 June 2000'/>
<meta name='modifiedcontent='28 October 2019'/>
<meta name='creatorcontent='X3D working group'/>
<meta name='descriptioncontent="VRML 97 specification example: VRML provides control of the viewer's camera through use of a script. This is useful for things such as guided tours, merry-go-round rides, and transportation devices such as buses and elevators. These next two examples show a couple of ways to use this feature. This example is a simple guided tour through the world. Upon entry, a guide orb hovers in front of the viewer. Click on this and a tour through the world begins. The orb follows the user around on his tour. A ProximitySensor ensures that the tour is started only if the user is close to the initial starting point. Note that this is done without scripts thanks to the touchTime output of the TouchSensor."/>
<meta name='referencecontent='originals/exampleD_17.wrl'/>
<meta name='specificationSectioncontent=' VRML 97, ISO/IEC 14772-1, Part 1: Functional specification and UTF-8 encoding, D.17 Guided tour'/>
<meta name='specificationUrlcontent=' https://www.web3d.org/documents/specifications/14772/V2.0/part1/examples.html#D.17 '/>
<meta name='identifiercontent=' https://www.web3d.org/x3d/content/examples/Basic/Vrml97Specification/Example17.x3d '/>
<meta name='generatorcontent='X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit'/>
<meta name='licensecontent=' ../license.html'/>
</head>
<!--

to top <!-- Event Graph ROUTE Table shows event connections -->
 
<!-- Index for DEF nodes: GuidePI, GuideRI, GuideTransform, ProxSensor, StartTour, TourGuide, TS

Index for Viewpoint node: TourGuide
-->
<Scene>
<WorldInfo title='Example17.x3d'/>
<Group>
<Transform translation='0.0 -1.0 0.0'>
<Shape>
<Box size='30.0 0.2 30.0'/>
<Appearance>
<Material/>
</Appearance>
</Shape>
</Transform>
<Transform translation='-1.0 0.0 0.0'>
<Shape>
<Cone/>
<Appearance>
<Material diffuseColor='0.5 0.8 0.0'/>
</Appearance>
</Shape>
</Transform>
<Transform translation='1.0 0.0 0.0'>
<Shape>
<Cylinder/>
<Appearance>
<Material diffuseColor='0.0 0.2 0.7'/>
</Appearance>
</Shape>
</Transform>
<!-- ROUTE information for GuideTransform node:  [from GuidePI.value_changed to translation ] [from GuideRI.value_changed to rotation ] -->
<Transform DEF='GuideTransform'>
<!-- ROUTE information for TourGuide node:  [from TS.isActive to set_bind ] -->
<Viewpoint DEF='TourGuidedescription='Tour Guidejump='false'/>

<!-- ROUTE information for ProxSensor node:  [from isActive to StartTour.enabled ] -->
<ProximitySensor DEF='ProxSensorsize='50.0 50.0 50.0'/>

<!-- ROUTE information for StartTour node:  [from ProxSensor.isActive to enabled ] [from touchTime to TS.startTime ] -->
<TouchSensor DEF='StartTourdescription='touch to start guided tour'/>

<Transform translation='0.6 0.4 8.0'>
<Shape>
<Sphere radius='0.2'/>
<Appearance>
<Material diffuseColor='1.0 0.6 0.0'/>
</Appearance>
</Shape>
</Transform>
</Transform>
</Group>
<!-- ROUTE information for GuidePI node:  [from TS.fraction_changed to set_fraction ] [from value_changed to GuideTransform.translation ] -->
<PositionInterpolator DEF='GuidePIkey='0.0 0.2 0.3 0.5 0.6 0.8 0.9 1.0keyValue='0.0 0.0 0.0 0.0 0.0 -5.0 2.0 0.0 -5.0 2.0 6.0 -15.0 -4.0 6.0 -15.0 -4.0 0.0 -5.0 0.0 0.0 -5.0 0.0 0.0 0.0'/>

<!-- ROUTE information for GuideRI node:  [from TS.fraction_changed to set_fraction ] [from value_changed to GuideTransform.rotation ] -->
<OrientationInterpolator DEF='GuideRIkey='0.0 0.2 0.3 0.5 0.6 0.8 0.9 1.0keyValue='0.0 1.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0 1.2 0.0 1.0 0.0 3.0 0.0 1.0 0.0 3.5 0.0 1.0 0.0 5.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0 0.0'/>


< ROUTE  fromNode=' ProxSensor' fromField='isActive' toNode=' StartTour' toField='enabled'/>
< ROUTE  fromNode=' StartTour' fromField='touchTime' toNode=' TS' toField='startTime'/>
< ROUTE  fromNode=' TS' fromField='isActive' toNode=' TourGuide' toField='set_bind'/>
< ROUTE  fromNode=' TS' fromField='fraction_changed' toNode=' GuidePI' toField='set_fraction'/>
< ROUTE  fromNode=' TS' fromField='fraction_changed' toNode=' GuideRI' toField='set_fraction'/>
< ROUTE  fromNode=' GuidePI' fromField='value_changed' toNode=' GuideTransform' toField='translation'/>
< ROUTE  fromNode=' GuideRI' fromField='value_changed' toNode=' GuideTransform' toField='rotation'/>
</Scene>
</X3D>
<!--

to top <!-- Event Graph ROUTE Table shows event connections -->
 
<!-- Index for DEF nodes: GuidePI, GuideRI, GuideTransform, ProxSensor, StartTour, TourGuide, TS

Index for Viewpoint node: TourGuide
-->

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

ProxSensor
ProximitySensor
isActive
SFBool

ROUTE
event to
(1)
StartTour
TouchSensor
enabled
SFBool

 
 
then
StartTour
TouchSensor
touchTime
SFTime

ROUTE
event to
(2)
TS
TimeSensor
startTime
SFTime

 
 
then
TS
TimeSensor
fraction_changed
SFFloat

ROUTE
event to
(3)
GuidePI
PositionInterpolator
set_fraction
SFFloat

 
 
then
GuidePI
PositionInterpolator
value_changed
SFVec3f

ROUTE
event to
(4)
GuideTransform
Transform
translation
SFVec3f
 
 
 
then
TS
TimeSensor
fraction_changed
SFFloat

ROUTE
event to
(3)
GuideRI
OrientationInterpolator
set_fraction
SFFloat

 
 
then
GuideRI
OrientationInterpolator
value_changed
SFRotation

ROUTE
event to
(4)
GuideTransform
Transform
rotation
SFRotation
 
 
 
then
TS
TimeSensor
isActive
SFBool

ROUTE
event to
(3)
TourGuide
Viewpoint
set_bind
SFBool


-->

<!-- Online at
https://www.web3d.org/x3d/content/examples/Basic/Vrml97Specification/Example17Index.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/Basic/Vrml97Specification/Example17.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. -->