X3D Model Documentation: ExtrusionCrossSectionITSSPrototype.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='Immersive' 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='ExtrusionCrossSectionITSSPrototype.x3d'/>
  6            <meta name='creatorcontent='Don Brutzman and Sungmin Kwon'/>
  7            <meta name='createdcontent='23 October 2017'/>
  8            <meta name='modifiedcontent='19 August 2024'/>
  9            <meta name='descriptioncontent='Shape prototype for Enclosing IndexedTriangleStripSet that also draws spine line plus oriented, scaled cross sections at each spine point.'/>
 10            <meta name='hintcontent='Utilize ExtrusionCrossSectionITSS ProtoInstance as if it is a Shape node (with containerField="children") rather than an Extrusion node (with containerField="geometry") under a Shape.'/>
 11            <meta name='referencecontent='https://en.wikipedia.org/wiki/Extrusion'/>
 12            <meta name='referencecontent='VRML 97 Specification, 6.18 Extrusion'/>
 13            <meta name='referencecontent='https://www.web3d.org/technicalinfo/specifications/vrml97/part1/nodesRef.html#Extrusion'/>
 14            <meta name='Imagecontent='VRML 97 Specification, Figure 6.6'/>
 15            <meta name='Imagecontent='https://www.web3d.org/technicalinfo/specifications/vrml97/Images/Extrusion.gif'/>
 16            <meta name='referencecontent='http://realism.com/x3d/examples/Extrusion/_frame.html'/>
 17            <meta name='referencecontent='http://www.cs.brown.edu/~gss/vrml/drawpoly.html'/>
 18            <meta name='referencecontent='ExtrusionXj3dGoldberg1999.java'/>
 19            <meta name='referencecontent='http://web3d.metrolink.com/cgi-bin/cvsweb.cgi/x3d/src/com/sun/j3d/loaders/vrml97/impl/Attic/Extrusion.java'/>
 20            <meta name='identifiercontent='https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter06GeometryPointsLinesPolygons/ExtrusionCrossSectionITSSPrototype.x3d'/>
 21            <meta name='generatorcontent='X3D-Edit 4.0, https://savage.nps.edu/X3D-Edit'/>
 22            <meta name='licensecontent='../license.html'/>
 23       </head>
<!--

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

<!-- to top Index for DEF nodes: CrossSectionFaces, CrossSectionFacesCoordinates, CrossSectionMaterial, CrossSectionScript, EnclosingExtrusion2, ExternalExtrusion2, ExtrusionAppearance2, ExtrusionCoordinates2, ExtrusionMaterial2, InternalCrossSections, Spine, SpineCoordinates, SpineLine, SpineMaterial, Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_index

Index for ProtoDeclare definition: ExtrusionCrossSectionITSS
-->
 24       <Scene>
 25            <WorldInfo title='ExtrusionCrossSectionITSSPrototype.x3d'/>
 26            <ProtoDeclare name='ExtrusionCrossSectionITSSappinfo='Shape prototype for Extrusion node that also draws spine line plus oriented scaled cross sections at each spine point' documentation='https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter06GeometryPointsLinesPolygons/ExtrusionCrossSectionPrototype.x3d'>
 27                 <ProtoInterface>
 28                      <field name='nametype='SFStringaccessType='initializeOnly'
                     appinfo='Extrusion name'/>
 29                      <field name='crossSectiontype='MFVec2fvalue='1 1 1 -1 -1 -1 -1 1 1 1accessType='initializeOnly'
                     appinfo='Extrusion field'/>
 30                      <field name='spinetype='MFVec3fvalue='0 0 0 0 1 0accessType='initializeOnly'
                     appinfo='Extrusion field'/>
 31                      <field name='scaletype='MFVec2fvalue='1 1accessType='initializeOnly'
                     appinfo='Extrusion field'/>
 32                      <field name='orientationtype='MFRotationvalue='0 0 1 0accessType='initializeOnly'
                     appinfo='Extrusion field'/>
 33                      <field name='beginCaptype='SFBoolvalue='falseaccessType='initializeOnly'
                     appinfo='Extrusion field'/>
 34                      <field name='endCaptype='SFBoolvalue='falseaccessType='initializeOnly'
                     appinfo='Extrusion field'/>
 35                      <field name='ccwtype='SFBoolvalue='trueaccessType='initializeOnly'
                     appinfo='Extrusion field'/>
 36                      <field name='convextype='SFBoolvalue='trueaccessType='initializeOnly'
                     appinfo='Extrusion field'/>
 37                      <field name='creaseAngletype='SFFloatvalue='0accessType='initializeOnly'
                     appinfo='Extrusion field'/>
 38                      <field name='solidtype='SFBoolvalue='trueaccessType='initializeOnly'
                     appinfo='Extrusion field'/>
 39                      <field name='spineColortype='SFColorvalue='0 0.9 0.8accessType='inputOutput'
                     appinfo='emissiveColor of spine'/>
 40                      <field name='crossSectionColortype='SFColorvalue='0.2 0.8 0.3accessType='inputOutput'
                     appinfo='diffuseColor of crossSection'/>
 41                      <field name='crossSectionTransparencytype='SFFloatvalue='0.2accessType='inputOutput'
                     appinfo='transparency of crossSection'/>
 42                      <field name='extrusionColortype='SFColorvalue='0.3 0.3 0.3accessType='inputOutput'
                     appinfo='diffuseColor of extrusion hull'/>
 43                      <field name='extrusionTransparencytype='SFFloatvalue='0.7accessType='inputOutput'
                     appinfo='transparency of extrusion hull'/>
 44                      <field name='extrusionImageTexturetype='SFNodeaccessType='initializeOnly'
                     appinfo='Image to apply to Extrusion'>
 45                           <!-- initialization node (if any) goes here -->
 46                      </field>
 47                      <field name='extrusionTextureTransformtype='SFNodeaccessType='initializeOnly'
                     appinfo='TextureTransform coordinates of image applied to Extrusion'>
 48                           <!-- initialization node (if any) goes here -->
 49                      </field>
 50                      <field name='set_crossSectiontype='MFVec2faccessType='inputOnly'
                     appinfo='Extrusion field'/>
 51                      <field name='set_spinetype='MFVec3faccessType='inputOnly'
                     appinfo='Extrusion field'/>
 52                      <field name='set_scaletype='MFVec2faccessType='inputOnly'
                     appinfo='Extrusion field'/>
 53                      <field name='set_orientationtype='MFRotationaccessType='inputOnly'
                     appinfo='Extrusion field'/>
 54                      <field name='traceEnabledtype='SFBoolvalue='falseaccessType='initializeOnly'
                     appinfo='Whether to provide initialization trace statements showing node construction'/>
 55                 </ProtoInterface>
 56                 <ProtoBody>
 57                      <Group>
 58                           <Shape DEF='Spine'>
 59 
                              <!-- ROUTE information for SpineLine node:  [from CrossSectionScript.spineIndex to set_coordIndex ] -->
                              <IndexedLineSet DEF='SpineLinecolorPerVertex='false'>
 60                                     <Coordinate DEF='SpineCoordinates'>
 61                                          <IS>
 62                                               <connect nodeField='pointprotoField='spine'/>
 63                                               <connect nodeField='set_pointprotoField='set_spine'/>
 64                                          </IS>
 65                                     </Coordinate>
 66                                </IndexedLineSet>
 67                                <Appearance>
 68                                     <Material DEF='SpineMaterial'>
 69                                          <IS>
 70                                               <connect nodeField='emissiveColorprotoField='spineColor'/>
 71                                          </IS>
 72                                     </Material>
 73                                </Appearance>
 74                           </Shape>
 75                           <Shape DEF='InternalCrossSections'>
 76 
                              <!-- ROUTE information for CrossSectionFaces node:  [from CrossSectionScript.facesIndex to set_index ] -->
                              <IndexedTriangleFanSet DEF='CrossSectionFacesccw='truecolorPerVertex='truenormalPerVertex='truesolid='falsecontainerField='geometry'>
 77 
                                   <!-- ROUTE information for CrossSectionFacesCoordinates node:  [from CrossSectionScript.facePoints to point ] -->
                                   <Coordinate DEF='CrossSectionFacesCoordinates'/>
 78                                </IndexedTriangleFanSet>
 79                                <Appearance>
 80                                     <Material DEF='CrossSectionMaterial'>
 81                                          <IS>
 82                                               <connect nodeField='diffuseColorprotoField='crossSectionColor'/>
 83                                               <connect nodeField='transparencyprotoField='crossSectionTransparency'/>
 84                                          </IS>
 85                                     </Material>
 86                                </Appearance>
 87                           </Shape>
 88                           <Shape DEF='ExternalExtrusion2'>
 89                                <Appearance DEF='ExtrusionAppearance2'>
 90                                     <IS>
 91                                          <connect nodeField='textureprotoField='extrusionImageTexture'/>
 92                                          <connect nodeField='textureTransformprotoField='extrusionTextureTransform'/>
 93                                     </IS>
 94                                     <Material DEF='ExtrusionMaterial2'>
 95                                          <IS>
 96                                               <connect nodeField='diffuseColorprotoField='extrusionColor'/>
 97                                               <connect nodeField='transparencyprotoField='extrusionTransparency'/>
 98                                          </IS>
 99                                     </Material>
100                                </Appearance>
101 
                              <!-- ROUTE information for EnclosingExtrusion2 node:  [from CrossSectionScript.triStripIndex to set_index ] -->
                              <IndexedTriangleStripSet DEF='EnclosingExtrusion2ccw='truecolorPerVertex='trueindex='0 1 2normalPerVertex='truesolid='truecontainerField='geometry'>
102 
                                   <!-- ROUTE information for ExtrusionCoordinates2 node:  [from CrossSectionScript.facePoints to point ] -->
                                   <Coordinate DEF='ExtrusionCoordinates2'/>
103                                </IndexedTriangleStripSet>
104                           </Shape>
105                           <!-- <Shape DEF='ExternalExtrusion'> <Extrusion DEF='EnclosingExtrusion' convex='false' solid='false'> <IS> <connect nodeField='crossSection' protoField='crossSection'/> <connect nodeField='spine' protoField='spine'/> <connect nodeField='scale' protoField='scale'/> <connect nodeField='orientation' protoField='orientation'/> <connect nodeField='set_crossSection' protoField='set_crossSection'/> <connect nodeField='set_spine' protoField='set_spine'/> <connect nodeField='set_scale' protoField='set_scale'/> <connect nodeField='set_orientation' protoField='set_orientation'/> <connect nodeField='beginCap' protoField='beginCap'/> <connect nodeField='endCap' protoField='endCap'/> <connect nodeField='ccw' protoField='ccw'/> <connect nodeField='convex' protoField='convex'/> <connect nodeField='creaseAngle' protoField='creaseAngle'/> <connect nodeField='solid' protoField='solid'/> </IS> </Extrusion> <Appearance DEF='ExtrusionAppearance'> <IS> <connect nodeField='texture' protoField='extrusionImageTexture'/> <connect nodeField='textureTransform' protoField='extrusionTextureTransform'/> </IS> <Material DEF='ExtrusionMaterial'> <IS> <connect nodeField='diffuseColor' protoField='extrusionColor'/> <connect nodeField='transparency' protoField='extrusionTransparency'/> </IS> </Material> </Appearance> </Shape> -->
106                      </Group>
107                      <!-- TODO hardwired local Script path to workaround BS Contact bug -->
108 
109                           <field name='nametype='SFStringaccessType='initializeOnly'/>
110                           <field name='crossSectiontype='MFVec2faccessType='initializeOnly'/>
111                           <field name='spinetype='MFVec3faccessType='initializeOnly'/>
112                           <field name='scaletype='MFVec2faccessType='initializeOnly'/>
113                           <field name='orientationtype='MFRotationaccessType='initializeOnly'/>
114                           <field name='spineColortype='SFColoraccessType='inputOutput'/>
115                           <field name='crossSectionColortype='SFColoraccessType='inputOutput'/>
116                           <field name='crossSectionTransparencytype='SFFloataccessType='inputOutput'/>
117                           <field name='extrusionColortype='SFColoraccessType='inputOutput'/>
118                           <field name='extrusionTransparencytype='SFFloataccessType='inputOutput'/>
119                           <field name='set_crossSectiontype='MFVec2faccessType='inputOnly'/>
120                           <field name='set_spinetype='MFVec3faccessType='inputOnly'/>
121                           <field name='set_scaletype='MFVec2faccessType='inputOnly'/>
122                           <field name='set_orientationtype='MFRotationaccessType='inputOnly'/>
123                           <field name='spineIndextype='MFInt32accessType='outputOnly'/>
124                           <field name='facesIndextype='MFInt32accessType='outputOnly'/>
125                           <field name='facePointstype='MFVec3faccessType='outputOnly'/>
126                           <field name='triStripIndextype='MFInt32accessType='outputOnly'/>
127                           <field name='traceEnabledtype='SFBoolaccessType='initializeOnly'/>
128                           <!-- local variables -->
129                           <field name='computedFacesIndextype='MFInt32accessType='initializeOnly'/>
130                           <field name='computedFacePointstype='MFVec3faccessType='initializeOnly'/>
131                           <field name='computedTriStripIndextype='MFInt32accessType='initializeOnly'/>
132                           <IS>
133                                <connect nodeField='nameprotoField='name'/>
134                                <connect nodeField='crossSectionprotoField='crossSection'/>
135                                <connect nodeField='spineprotoField='spine'/>
136                                <connect nodeField='scaleprotoField='scale'/>
137                                <connect nodeField='spineColorprotoField='spineColor'/>
138                                <connect nodeField='crossSectionColorprotoField='crossSectionColor'/>
139                                <connect nodeField='crossSectionTransparencyprotoField='crossSectionTransparency'/>
140                                <connect nodeField='extrusionColorprotoField='extrusionColor'/>
141                                <connect nodeField='extrusionTransparencyprotoField='extrusionTransparency'/>
142                                <connect nodeField='orientationprotoField='orientation'/>
143                                <connect nodeField='set_crossSectionprotoField='set_crossSection'/>
144                                <connect nodeField='set_spineprotoField='set_spine'/>
145                                <connect nodeField='set_scaleprotoField='set_scale'/>
146                                <connect nodeField='set_orientationprotoField='set_orientation'/>
147                                <connect nodeField='traceEnabledprotoField='traceEnabled'/>
148                           </IS>
149                      </Script>
150                      < ROUTE  fromNode='CrossSectionScript' fromField='spineIndex' toNode='SpineLine' toField='set_coordIndex'/>
151                      < ROUTE  fromNode='CrossSectionScript' fromField='facesIndex' toNode='CrossSectionFaces' toField='set_index'/>
152                      < ROUTE  fromNode='CrossSectionScript' fromField='facePoints' toNode='CrossSectionFacesCoordinates' toField='point'/>
153                      < ROUTE  fromNode='CrossSectionScript' fromField='triStripIndex' toNode='EnclosingExtrusion2' toField='set_index'/>
154                      <Group>
155                           <!-- ======= ROUTE Trace ============================================== -->
156 
                         <!-- ROUTE information for Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_index node:  [from CrossSectionScript.triStripIndex to traceValue ] -->
                         <Script DEF='Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_indexmustEvaluate='true'>
157                                <!-- Trace ROUTEd event values on X3D browser console -->
158                                <field name='reportIntervaltype='SFTimevalue='1.0accessType='initializeOnly'
                               appinfo='Sampling frequency in seconds (0 means all values)'/>
159                                <field name='traceValuetype='MFInt32accessType='inputOnly'/>
160                                <field name='timeStampPreviousReporttype='SFTimevalue='-1accessType='initializeOnly'/>
  <![CDATA[
            
ecmascript:
    function traceValue (eventValue, timeStamp) {
      // input eventValue received for trace field
      if (timeStamp - timeStampPreviousReport >= reportInterval) {
        Browser.println ('Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_index type=MFInt32 value=' + eventValue.toString());
        timeStampPreviousReport = timeStamp;
      }
    }
    function timeOfDay (someTime) {
      hh = Math.floor (someTime /(60*60)) % 24;
      mm = Math.floor (someTime / 60)     % 60;
      ss = Math.floor (someTime)          % 60;
      if (hh < 9) hour   = '0' + hh;
      else        hour   =       hh;
      if (mm < 9) minute = '0' + mm;
      else        minute =       mm;
      if (ss < 9) second = '0' + ss;
      else        second =       ss;
      return '(' + hour + ':' + minute + ':' + second + ' GMT)';
    }

          
]]>
162                           </Script>
163                           < ROUTE  fromNode='CrossSectionScript' fromField='triStripIndex' toNode='Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_index' toField='traceValue'/>
164                           <!-- ======= ROUTE Trace block complete ===================================================== -->
165                      </Group>
166                      < ROUTE  fromNode='CrossSectionScript' fromField='facePoints' toNode='ExtrusionCoordinates2' toField='point'/>
167                      <!-- -->
168                 </ProtoBody>
169            </ProtoDeclare>
170            <!-- ==================== -->
171            <!-- Example instance adapted from Figure15.12Torus.x3d -->
172            <!-- https://www.web3d.org/x3d/content/examples/Basic/Vrml2Sourcebook/Chapter15-Extrusion/Figure15.12Torus.x3d -->
173            <!-- Redirection text in case a user examines this PROTO file via a 3D browser: -->
174            <Group>
175                 <Transform translation='0 0.5 0'>
176                      <Shape>
177                           <Appearance>
178                                <Material diffuseColor='0 1 1emissiveColor='0 1 1'/>
179                           </Appearance>
180                           <Text string='"ExtrusionCrossSectionITSS" "is a Prototype definition scene"'>
181                                <FontStyle justify='"MIDDLE" "MIDDLE"size='0.7'/>
182                           </Text>
183                      </Shape>
184                 </Transform>
185            </Group>
186       </Scene>
187  </X3D>
<!--

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

<!-- to top Index for DEF nodes: CrossSectionFaces, CrossSectionFacesCoordinates, CrossSectionMaterial, CrossSectionScript, EnclosingExtrusion2, ExternalExtrusion2, ExtrusionAppearance2, ExtrusionCoordinates2, ExtrusionMaterial2, InternalCrossSections, Spine, SpineCoordinates, SpineLine, SpineMaterial, Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_index

Index for ProtoDeclare definition: ExtrusionCrossSectionITSS
-->
X3D Tooltips element index: Appearance, connect, Coordinate, field, FontStyle, Group, head, IndexedLineSet, IndexedTriangleFanSet, IndexedTriangleStripSet, IS, Material, meta, ProtoBody, ProtoDeclare, ProtoInterface, ROUTE, Scene, Script, Shape, Text, Transform, WorldInfo, X3D, accessType and type, XML data types, field types

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

CrossSectionScript
Script
spineIndex
MFInt32

ROUTE
event to
(1)
SpineLine
IndexedLineSet
set_coordIndex
MFInt32
CrossSectionScript
Script
facesIndex
MFInt32

ROUTE
event to
(1)
CrossSectionFaces
IndexedTriangleFanSet
set_index
MFInt32
CrossSectionScript
Script
facePoints
MFVec3f

ROUTE
event to
(1)
CrossSectionFacesCoordinates
Coordinate
point
MFVec3f
CrossSectionScript
Script
triStripIndex
MFInt32

ROUTE
event to
(1)
EnclosingExtrusion2
IndexedTriangleStripSet
set_index
MFInt32
CrossSectionScript
Script
triStripIndex
MFInt32

ROUTE
event to
(1)
Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_index
Script
traceValue
MFInt32
CrossSectionScript
Script
facePoints
MFVec3f

ROUTE
event to
(1)
ExtrusionCoordinates2
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/Chapter06GeometryPointsLinesPolygons/ExtrusionCrossSectionITSSPrototypeIndex.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter06GeometryPointsLinesPolygons/ExtrusionCrossSectionITSSPrototype.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)
    <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. -->