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='https://www.w3.org/2001/XMLSchema-instance' xsd:noNamespaceSchemaLocation='https://www.web3d.org/specifications/x3d-3.3.xsd'>
  4       <head>
  5            <meta name='title' content=' ExtrusionCrossSectionITSSPrototype.x3d '/>
  6            <meta name='creator' content='Don Brutzman'/>
  7            <meta name='creator' content='Sungmin Kwon'/>
  8            <meta name='created' content='23 October 2017'/>
  9            <meta name='modified' content='14 July 2025'/>
 10            <meta name='description' content='Shape prototype for Enclosing IndexedTriangleStripSet that also draws spine line plus oriented, scaled cross sections at each spine point.'/>
 11            <meta name='hint' content='Utilize ExtrusionCrossSectionITSS ProtoInstance as if it is a Shape node (with containerField="children") rather than an Extrusion node (with containerField="geometry") under a Shape.'/>
 12            <meta name=' TODO ' content=' Multiple Extrusion property fields not yet supported. '/>
 13            <meta name='reference' content='https://en.wikipedia.org/wiki/Extrusion'/>
 14            <meta name='reference' content='VRML 97 Specification, 6.18 Extrusion'/>
 15            <meta name='reference' content='https://www.web3d.org/technicalinfo/specifications/vrml97/part1/nodesRef.html#Extrusion'/>
 16            <meta name='Image' content='VRML 97 Specification, Figure 6.6'/>
 17            <meta name='Image' content='https://www.web3d.org/technicalinfo/specifications/vrml97/Images/Extrusion.gif '/>
 18            <meta name='reference' content=' http://realism.com/x3d/examples/Extrusion/_frame.html '/>
 19            <meta name='reference' content=' http://www.cs.brown.edu/~gss/vrml/drawpoly.html '/>
 20            <meta name='reference' content=' ExtrusionXj3dGoldberg1999.java '/>
 21            <meta name='reference' content=' http://web3d.metrolink.com/cgi-bin/cvsweb.cgi/x3d/src/com/sun/j3d/loaders/vrml97/impl/Attic/Extrusion.java '/>
 22            <meta name='identifier' content=' https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter06GeometryPointsLinesPolygons/ExtrusionCrossSectionITSSPrototype.x3d '/>
 23            <meta name='generator' content='X3D-Edit 4.0, https://www.web3d.org/x3d/tools/X3D-Edit'/>
 24            <meta name='license' content='../license.html'/>
 25       </head>
<!--

Event Graph ROUTE Table shows event connections.

--> <!-- to top DEF nodes index: 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

-->
 26       <Scene>
 27            <WorldInfo title='ExtrusionCrossSectionITSSPrototype.x3d'/>
 28            <ProtoDeclare name='ExtrusionCrossSectionITSS' appinfo='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'>
 29                 <ProtoInterface>
 30                      <field name='name' type='SFString' accessType='initializeOnly' appinfo='Extrusion name'/>
 31                      <field name='crossSection' type='MFVec2f' value='1 1 1 -1 -1 -1 -1 1 1 1' accessType='initializeOnly' appinfo='Extrusion field'/>
 32                      <field name='spine' type='MFVec3f' value='0 0 0 0 1 0' accessType='initializeOnly' appinfo='Extrusion field'/>
 33                      <field name='scale' type='MFVec2f' value='1 1' accessType='initializeOnly' appinfo='Extrusion field'/>
 34                      <field name='orientation' type='MFRotation' value='0 0 1 0' accessType='initializeOnly' appinfo='Extrusion field'/>
 35                      <field name='beginCap' type='SFBool' value='false' accessType='initializeOnly' appinfo='Extrusion field'/>
 36                      <field name='endCap' type='SFBool' value='false' accessType='initializeOnly' appinfo='Extrusion field'/>
 37                      <field name='ccw' type='SFBool' value='true' accessType='initializeOnly' appinfo='Extrusion field'/>
 38                      <field name='convex' type='SFBool' value='true' accessType='initializeOnly' appinfo='Extrusion field'/>
 39                      <field name='creaseAngle' type='SFFloat' value='0' accessType='initializeOnly' appinfo='Extrusion field'/>
 40                      <field name='solid' type='SFBool' value='true' accessType='initializeOnly' appinfo='Extrusion field'/>
 41                      <field name='spineColor' type='SFColor' value='0 0.9 0.8' accessType='inputOutput' appinfo='emissiveColor of spine'/>
 42                      <field name='crossSectionColor' type='SFColor' value='0.2 0.8 0.3' accessType='inputOutput' appinfo='diffuseColor of crossSection'/>
 43                      <field name='crossSectionTransparency' type='SFFloat' value='0.2' accessType='inputOutput' appinfo='transparency of crossSection'/>
 44                      <field name='extrusionColor' type='SFColor' value='0.3 0.3 0.3' accessType='inputOutput' appinfo='diffuseColor of extrusion hull'/>
 45                      <field name='extrusionTransparency' type='SFFloat' value='0.7' accessType='inputOutput' appinfo='transparency of extrusion hull'/>
 46                      <field name='extrusionImageTexture' type='SFNode' accessType='initializeOnly' appinfo='Image to apply to Extrusion'>
 47                           <!-- initialization node (if any) goes here -->
 48                      </field>
 49                      <field name='extrusionTextureTransform' type='SFNode' accessType='initializeOnly' appinfo='TextureTransform coordinates of image applied to Extrusion'>
 50                           <!-- initialization node (if any) goes here -->
 51                      </field>
 52                      <field name='set_crossSection' type='MFVec2f' accessType='inputOnly' appinfo='Extrusion field'/>
 53                      <field name='set_spine' type='MFVec3f' accessType='inputOnly' appinfo='Extrusion field'/>
 54                      <field name='set_scale' type='MFVec2f' accessType='inputOnly' appinfo='Extrusion field'/>
 55                      <field name='set_orientation' type='MFRotation' accessType='inputOnly' appinfo='Extrusion field'/>
 56                      <field name='traceEnabled' type='SFBool' value='false' accessType='initializeOnly' appinfo='Whether to provide initialization trace statements showing node construction'/>
 57                 </ProtoInterface>
 58                 <ProtoBody>
 59                      <Group>
 60                           <Shape DEF='Spine'>
 61 
                              <!-- ROUTE information for SpineLine node:  [from CrossSectionScript.spineIndex to set_coordIndex ] -->
                               <IndexedLineSet DEF='SpineLine' colorPerVertex='false'>
 62                                     <Coordinate DEF='SpineCoordinates'>
 63                                          <IS>
 64                                               <connect nodeField='point' protoField='spine'/>
 65                                               <connect nodeField='set_point' protoField='set_spine'/>
 66                                          </IS>
 67                                     </Coordinate>
 68                                </IndexedLineSet>
 69                                <Appearance>
 70                                     <Material DEF='SpineMaterial'>
 71                                          <IS>
 72                                               <connect nodeField='emissiveColor' protoField='spineColor'/>
 73                                          </IS>
 74                                     </Material>
 75                                </Appearance>
 76                           </Shape>
 77                           <Shape DEF='InternalCrossSections'>
 78 
                              <!-- ROUTE information for CrossSectionFaces node:  [from CrossSectionScript.facesIndex to set_index ] -->
                               <IndexedTriangleFanSet DEF='CrossSectionFaces' ccw='true' colorPerVertex='true' normalPerVertex='true' solid='false' containerField='geometry'>
 79 
                                   <!-- ROUTE information for CrossSectionFacesCoordinates node:  [from CrossSectionScript.facePoints to point ] -->
                                    <Coordinate DEF='CrossSectionFacesCoordinates'/>
 80                                </IndexedTriangleFanSet>
 81                                <Appearance>
 82                                     <Material DEF='CrossSectionMaterial'>
 83                                          <IS>
 84                                               <connect nodeField='diffuseColor' protoField='crossSectionColor'/>
 85                                               <connect nodeField='transparency' protoField='crossSectionTransparency'/>
 86                                          </IS>
 87                                     </Material>
 88                                </Appearance>
 89                           </Shape>
 90                           <Shape DEF='ExternalExtrusion2'>
 91                                <Appearance DEF='ExtrusionAppearance2'>
 92                                     <IS>
 93                                          <connect nodeField='texture' protoField='extrusionImageTexture'/>
 94                                          <connect nodeField='textureTransform' protoField='extrusionTextureTransform'/>
 95                                     </IS>
 96                                     <Material DEF='ExtrusionMaterial2'>
 97                                          <IS>
 98                                               <connect nodeField='diffuseColor' protoField='extrusionColor'/>
 99                                               <connect nodeField='transparency' protoField='extrusionTransparency'/>
100                                          </IS>
101                                     </Material>
102                                </Appearance>
103 
                              <!-- ROUTE information for EnclosingExtrusion2 node:  [from CrossSectionScript.triStripIndex to set_index ] -->
                               <IndexedTriangleStripSet DEF='EnclosingExtrusion2' ccw='true' colorPerVertex='true' index='0 1 2' normalPerVertex='true' solid='true' containerField='geometry'>
104 
                                   <!-- ROUTE information for ExtrusionCoordinates2 node:  [from CrossSectionScript.facePoints to point ] -->
                                    <Coordinate DEF='ExtrusionCoordinates2'/>
105                                </IndexedTriangleStripSet>
106                           </Shape>
107                           <!-- <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> -->
108                      </Group>
109                      <!-- TODO hardwired local Script path to workaround BS Contact bug -->
110 
                    <!-- ROUTE information for CrossSectionScript node:  [from spineIndex to SpineLine.set_coordIndex ] [from facesIndex to CrossSectionFaces.set_index ] [from facePoints to CrossSectionFacesCoordinates.point ] [from triStripIndex to EnclosingExtrusion2.set_index ] [from triStripIndex to Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_index.traceValue ] [from facePoints to ExtrusionCoordinates2.point ] -->
                     <Script DEF='CrossSectionScript'   url=' "ExtrusionCrossSectionITSSPrototype.js" "https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter06GeometryPointsLinesPolygons/ExtrusionCrossSectionITSSPrototype.js" '>
111                           <field name='name' type='SFString' accessType='initializeOnly'/>
112                           <field name='crossSection' type='MFVec2f' accessType='initializeOnly'/>
113                           <field name='spine' type='MFVec3f' accessType='initializeOnly'/>
114                           <field name='scale' type='MFVec2f' accessType='initializeOnly'/>
115                           <field name='orientation' type='MFRotation' accessType='initializeOnly'/>
116                           <field name='spineColor' type='SFColor' accessType='inputOutput'/>
117                           <field name='crossSectionColor' type='SFColor' accessType='inputOutput'/>
118                           <field name='crossSectionTransparency' type='SFFloat' accessType='inputOutput'/>
119                           <field name='extrusionColor' type='SFColor' accessType='inputOutput'/>
120                           <field name='extrusionTransparency' type='SFFloat' accessType='inputOutput'/>
121                           <field name='set_crossSection' type='MFVec2f' accessType='inputOnly'/>
122                           <field name='set_spine' type='MFVec3f' accessType='inputOnly'/>
123                           <field name='set_scale' type='MFVec2f' accessType='inputOnly'/>
124                           <field name='set_orientation' type='MFRotation' accessType='inputOnly'/>
125                           <field name='spineIndex' type='MFInt32' accessType='outputOnly'/>
126                           <field name='facesIndex' type='MFInt32' accessType='outputOnly'/>
127                           <field name='facePoints' type='MFVec3f' accessType='outputOnly'/>
128                           <field name='triStripIndex' type='MFInt32' accessType='outputOnly'/>
129                           <field name='traceEnabled' type='SFBool' accessType='initializeOnly'/>
130                           <!-- local variables -->
131                           <field name='computedFacesIndex' type='MFInt32' accessType='initializeOnly'/>
132                           <field name='computedFacePoints' type='MFVec3f' accessType='initializeOnly'/>
133                           <field name='computedTriStripIndex' type='MFInt32' accessType='initializeOnly'/>
134                           <IS>
135                                <connect nodeField='name' protoField='name'/>
136                                <connect nodeField='crossSection' protoField='crossSection'/>
137                                <connect nodeField='spine' protoField='spine'/>
138                                <connect nodeField='scale' protoField='scale'/>
139                                <connect nodeField='spineColor' protoField='spineColor'/>
140                                <connect nodeField='crossSectionColor' protoField='crossSectionColor'/>
141                                <connect nodeField='crossSectionTransparency' protoField='crossSectionTransparency'/>
142                                <connect nodeField='extrusionColor' protoField='extrusionColor'/>
143                                <connect nodeField='extrusionTransparency' protoField='extrusionTransparency'/>
144                                <connect nodeField='orientation' protoField='orientation'/>
145                                <connect nodeField='set_crossSection' protoField='set_crossSection'/>
146                                <connect nodeField='set_spine' protoField='set_spine'/>
147                                <connect nodeField='set_scale' protoField='set_scale'/>
148                                <connect nodeField='set_orientation' protoField='set_orientation'/>
149                                <connect nodeField='traceEnabled' protoField='traceEnabled'/>
150                           </IS>
151                      </Script>
152                      < ROUTE  fromNode='CrossSectionScript' fromField='spineIndex' toNode='SpineLine' toField='set_coordIndex'/>
153                      < ROUTE  fromNode='CrossSectionScript' fromField='facesIndex' toNode='CrossSectionFaces' toField='set_index'/>
154                      < ROUTE  fromNode='CrossSectionScript' fromField='facePoints' toNode='CrossSectionFacesCoordinates' toField='point'/>
155                      < ROUTE  fromNode='CrossSectionScript' fromField='triStripIndex' toNode='EnclosingExtrusion2' toField='set_index'/>
156                      <Group>
157                           <!-- ======= ROUTE Trace ============================================== -->
158 
                         <!-- 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_index' mustEvaluate='true'>
159                                <!-- Trace ROUTEd event values on X3D browser console -->
160                                <field name='reportInterval' type='SFTime' value='1.0' accessType='initializeOnly' appinfo='Sampling frequency in seconds (0 means all values)'/>
161                                <field name='traceValue' type='MFInt32' accessType='inputOnly'/>
162                                <field name='timeStampPreviousReport' type='SFTime' value='-1' accessType='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)';
    }
]]>
164                           </Script>
165                           < ROUTE  fromNode='CrossSectionScript' fromField='triStripIndex' toNode='Trace_ROUTE_CrossSectionScript_triStripIndex_TO_EnclosingExtrusion2_set_index' toField='traceValue'/>
166                           <!-- ======= ROUTE Trace block complete ===================================================== -->
167                      </Group>
168                      < ROUTE  fromNode='CrossSectionScript' fromField='facePoints' toNode='ExtrusionCoordinates2' toField='point'/>
169                      <!-- -->
170                 </ProtoBody>
171            </ProtoDeclare>
172            <!-- ==================== -->
173            <!-- Example instance adapted from Figure15.12Torus.x3d -->
174            <!-- https://www.web3d.org/x3d/content/examples/Basic/Vrml2Sourcebook/Chapter15-Extrusion/Figure15.12Torus.x3d -->
175            <!-- Redirection text in case a user examines this PROTO file via a 3D browser: -->
176            <Group>
177                 <Transform translation='0 0.5 0'>
178                      <Shape>
179                           <Appearance>
180                                <Material diffuseColor='0 1 1' emissiveColor='0 1 1'/>
181                           </Appearance>
182                           <Text string='"ExtrusionCrossSectionITSS" "is a Prototype definition scene"'>
183                                <FontStyle justify='"MIDDLE" "MIDDLE"' size='0.7'/>
184                           </Text>
185                      </Shape>
186                 </Transform>
187            </Group>
188       </Scene>
189  </X3D>
<!--

Event Graph ROUTE Table shows event connections.

--> <!-- to top DEF nodes index: 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: to top Appearance, connect, Coordinate, field, FontStyle, Group, head, IndexedLineSet, IndexedTriangleFanSet, IndexedTriangleStripSet, IS, Material, meta, ProtoBody, ProtoDeclare, ProtoInterface, ROUTE, Scene, Script, Shape, Text, Transform, WorldInfo, X3D,
plus documentation for accessType definitions, type definitions, XML data types, and field types

🔖   Event Graph ROUTE Table entries with 2 ROUTE connections, showing X3D event-model relationships for this scene.

Each row with a ROUTE statement shows an event cascade that may occur during a single timestamp interval between frame renderings, performed 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 -->
<!-- SourceForge version control Version control at    
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter06GeometryPointsLinesPolygons/ExtrusionCrossSectionITSSPrototype.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. -->