X3D Model Documentation: HiddenViewpointPrototype.x3d

  1  <?xml version="1.0" encoding="UTF-8"?>
  2 
<!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.0//EN" "https://www.web3d.org/specifications/x3d-3.0.dtd">
  3  <X3D profile='Immersive' version='3.0'  xmlns:xsd='http://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='https://www.web3d.org/specifications/x3d-3.0.xsd'>
  4       <head>
  5            <meta name='title' content=' HiddenViewpointPrototype.x3d '/>
  6            <meta name='description' content="Prototype to produce hidden viewpoints that becomes active (binds) upon pointer selection to reveal an interesting view, with an optionally label. Especially cool is deselecting: the user returns to wherever the previous viewpoint was. Numerous HiddenViewpoints can be used without cluttering up the browser's viewpoint description list."/>
  7            <meta name='creator' content='Don Brutzman'/>
  8            <meta name='created' content='1 May 2001'/>
  9            <meta name='modified' content='28 November 2019'/>
 10            <meta name='Image' content='HiddenViewpointTest-WaypointInterpolator.png'/>
 11            <meta name='Image' content='https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/HiddenViewpointTest-WaypointInterpolator.png'/>
 12            <meta name='reference' content=' WaypointInterpolatorExample.x3d '/>
 13            <meta name='identifier' content=' https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/HiddenViewpointPrototype.x3d '/>
 14            <meta name='generator' content='X3D-Edit 3.2, https://www.web3d.org/x3d/tools/X3D-Edit'/>
 15            <meta name='license' content='../../license.html'/>
 16       </head>
<!--
<!--
Event Graph ROUTE Table shows event connections.
-->
<!-- to top DEF nodes index: HiddenViewNoDescription, HiddenViewpointTransform, InvisibleTouchSensorNoDescription, LabelFontStyle, LabelText, LabelTextLOD, LabelTransform, LocationTransform, TextMaterial, TransparentSphere

Index for Viewpoint nodes: Viewpoint_1, HiddenViewNoDescription

Index for ProtoDeclare definition: HiddenViewpoint
-->
 17       <Scene>
 18            <WorldInfo title='HiddenViewpointPrototype.x3d'/>
 19            <ProtoDeclare name='HiddenViewpoint' appinfo='Hidden viewpoint becomes active (binds) upon pointer selection to reveal an interesting view with an optionally label'>
 20                 <ProtoInterface>
 21                      <field name='position' type='SFVec3f' value='0 0 0' accessType='inputOutput'/>
 22                      <field name='rotation' type='SFRotation' value='0 1 0 0' accessType='inputOutput'/>
 23                      <field name='sensorRadius' type='SFFloat' value='1' accessType='initializeOnly'/>
 24                      <field name='activate' type='SFBool' accessType='inputOnly'/>
 25                      <field name='label' type='MFString' accessType='inputOutput'/>
 26                      <field name='labelOffset' type='SFVec3f' value='0 -1 0' accessType='inputOutput'/>
 27                      <field name='labelFontSize' type='SFFloat' value='1' accessType='initializeOnly'/>
 28                      <field name='labelColor' type='SFColor' value='0.8 0.8 0.8' accessType='inputOutput'/>
 29                 </ProtoInterface>
 30                 <ProtoBody>
 31                      <!-- Touchable Sphere to bind a labeled local viewpoint while clicked... -->
 32                      <Transform DEF='LocationTransform'>
 33                           <IS>
 34                                <connect nodeField='translation' protoField='position'/>
 35                                <connect nodeField='center' protoField='position'/>
 36                                <connect nodeField='rotation' protoField='rotation'/>
 37                           </IS>
 38                           <Shape>
 39                                <Sphere DEF='TransparentSphere'>
 40                                     <IS>
 41                                          <connect nodeField='radius' protoField='sensorRadius'/>
 42                                     </IS>
 43                                </Sphere>
 44                                <Appearance>
 45                                     <Material transparency='1'/>
 46                                </Appearance>
 47                           </Shape>
 48 
                         <!-- ROUTE information for InvisibleTouchSensorNoDescription node:  [from isActive to HiddenViewNoDescription.set_bind ] -->
                          <TouchSensor DEF='InvisibleTouchSensorNoDescription'/>
 49                           <Transform DEF='HiddenViewpointTransform'>
 50                                <IS>
 51                                     <connect nodeField='translation' protoField='labelOffset'/>
 52                                </IS>
 53                                <!-- No description is provided for HiddenViewpoint so that it does NOT appear in the viewpoint list. -->
 54 
                              <!-- ROUTE information for HiddenViewNoDescription node:  [from InvisibleTouchSensorNoDescription.isActive to set_bind ] -->
                               <Viewpoint DEF='HiddenViewNoDescription' position='0 0 4'>
 55                                     <IS>
 56                                          <connect nodeField='set_bind' protoField='activate'/>
 57                                     </IS>
 58                                </Viewpoint>
 59                           </Transform>
 60                           <LOD DEF='LabelTextLOD' range='8'>
 61                                <Group>
 62                                     <Transform DEF='LabelTransform'>
 63                                          <IS>
 64                                               <connect nodeField='translation' protoField='labelOffset'/>
 65                                          </IS>
 66                                          <Shape>
 67                                               <Text DEF='LabelText'>
 68                                                    <IS>
 69                                                         <connect nodeField='string' protoField='label'/>
 70                                                    </IS>
 71                                                    <FontStyle DEF='LabelFontStyle' justify='"MIDDLE" "MIDDLE"'>
 72                                                         <IS>
 73                                                              <connect nodeField='size' protoField='labelFontSize'/>
 74                                                         </IS>
 75                                                    </FontStyle>
 76                                               </Text>
 77                                               <Appearance>
 78                                                    <Material DEF='TextMaterial' diffuseColor='0 0 0'>
 79                                                         <IS>
 80                                                              <connect nodeField='emissiveColor' protoField='labelColor'/>
 81                                                         </IS>
 82                                                    </Material>
 83                                                    <!-- emissiveColor used for TextMaterial so that label is visible regardless. Thus diffuseColor set to (0 0 0) so that default value (0.8 0.8 0.8) doesn't wash out emissive. -->
 84                                               </Appearance>
 85                                          </Shape>
 86                                     </Transform>
 87                                </Group>
 88                                <WorldInfo info='"null node"'/>
 89                           </LOD>
 90                      </Transform>
 91                      < ROUTE  fromNode='InvisibleTouchSensorNoDescription' fromField='isActive' toNode='HiddenViewNoDescription' toField='set_bind'/>
 92                 </ProtoBody>
 93            </ProtoDeclare>
 94            <!-- ====================================== -->
 95            <Viewpoint description='HiddenViewpoint launch' position='0 0 12'/>
 96            <Anchor description='WaypointInterpolator example' parameter='"target=_blank"'   url=' "WaypointInterpolatorExample.x3d" "https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/WaypointInterpolatorExample.x3d" "WaypointInterpolatorExample.wrl" "https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/WaypointInterpolatorExample.wrl" '>
 97                 <Shape>
 98                      <Text string='"Click on this text to see" "HiddenViewpoint example use" "" "then click beneath origin axes" "in WaypointInterpolator" "example scene"'>
 99                           <FontStyle justify='"MIDDLE" "MIDDLE"'/>
100                      </Text>
101                      <Appearance>
102                           <Material diffuseColor='1 1 0.2'/>
103                      </Appearance>
104                 </Shape>
105            </Anchor>
106       </Scene>
107  </X3D>
<!--
<!--
Event Graph ROUTE Table shows event connections.
-->
<!-- to top DEF nodes index: HiddenViewNoDescription, HiddenViewpointTransform, InvisibleTouchSensorNoDescription, LabelFontStyle, LabelText, LabelTextLOD, LabelTransform, LocationTransform, TextMaterial, TransparentSphere

Index for Viewpoint nodes: Viewpoint_1, HiddenViewNoDescription

Index for ProtoDeclare definition: HiddenViewpoint
-->
X3D Tooltips element index: Anchor, Appearance, connect, field, FontStyle, Group, head, IS, LOD, Material, meta, ProtoBody, ProtoDeclare, ProtoInterface, ROUTE, Scene, Shape, Sphere, Text, TouchSensor, Transform, Viewpoint, WorldInfo, X3D, plus documentation for accessType definitions, type definitions, XML data types, and field types

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

InvisibleTouchSensorNoDescription
TouchSensor
isActive
SFBool
→
ROUTE
event to
(1)
HiddenViewNoDescription
Viewpoint
set_bind
SFBool

line 96
Anchor
description='WaypointInterpolator example' 
User-interaction hint for this node. 

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/Savage/Tools/Animation/HiddenViewpointPrototypeIndex.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/Savage/Tools/Animation/HiddenViewpointPrototype.x3d -->

<!-- Color-coding 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)
    <ProtoDeclare name='ProtoName'> <field name='fieldName'/> </ProtoDeclare> -->

to top <!-- For additional help information about X3D scenes, please see X3D Tooltips, X3D Resources, and X3D Scene Authoring Hints. -->