X3D Model Documentation: Figure30_5ScriptTorusBuilder.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='titlecontent='Figure30_5ScriptTorusBuilder.x3d'/>
  6            <meta name='creatorcontent='Figure 30.5, The VRML 2.0 Sourcebook, Copyright [1997] By Andrea L. Ames, David R. Nadeau, and John L. Moreland'/>
  7            <meta name='referencecontent='http://www.wiley.com/legacy/compbooks/vrml2sbk/ch30/30fig05.htm'/>
  8            <meta name='translatorcontent='Don Brutzman'/>
  9            <meta name='createdcontent='28 September 2000'/>
 10            <meta name='modifiedcontent='20 October 2019'/>
 11            <meta name='descriptioncontent='A torus shape built with a donut-maker program script. Also see Figures 31.6 and 31.7 for comparison.'/>
 12            <meta name='identifiercontent='https://www.web3d.org/x3d/content/examples/Vrml2Sourcebook/Chapter30Scripts/Figure30_5ScriptTorusBuilder.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: Donut, DonutMakerExternalScript, DonutMakerInternalScript

Index for Viewpoint node: Viewpoint_1
-->
 16       <Scene>
 17            <WorldInfo title='Figure30_5ScriptTorusBuilder.x3d'/>
 18            <Viewpoint description='Torusorientation='1 0 0 -0.78position='0 5 5'/>
 19            <Group>
 20                 <Shape>
 21 
                    <!-- ROUTE information for Donut node:  [from DonutMakerInternalScript.spine_changed to set_spine ] [from DonutMakerInternalScript.crossSection_changed to set_crossSection ] -->
                    <Extrusion DEF='DonutbeginCap='falseconvex='falsecreaseAngle='1.57endCap='false'/>
 22                      <Appearance>
 23                           <Material diffuseColor='0 0.4 0.8'/>
 24                      </Appearance>
 25                 </Shape>
 26                 <Script DEF='DonutMakerExternalScript'   url=' "donutmaker.js" "https://www.web3d.org/x3d/content/examples/Vrml2Sourcebook/Chapter30Scripts/donutmaker.js" '>
 27                      <field name='spineRadiustype='SFFloatvalue='2accessType='initializeOnly'/>
 28                      <field name='crossSectionRadiustype='SFFloatvalue='1accessType='initializeOnly'/>
 29                      <field name='spineResolutiontype='SFInt32value='16accessType='initializeOnly'/>
 30                      <field name='crossSectionResolutiontype='SFInt32value='16accessType='initializeOnly'/>
 31                      <field name='set_spineRadiustype='SFFloataccessType='inputOnly'/>
 32                      <field name='set_crossSectionRadiustype='SFFloataccessType='inputOnly'/>
 33                      <field name='spine_changedtype='MFVec3faccessType='outputOnly'/>
 34                      <field name='crossSection_changedtype='MFVec2faccessType='outputOnly'/>
 35                 </Script>
 36 
               <!-- ROUTE information for DonutMakerInternalScript node:  [from spine_changed to Donut.set_spine ] [from crossSection_changed to Donut.set_crossSection ] -->
               <Script DEF='DonutMakerInternalScript'>
 37                      <field name='spineRadiustype='SFFloatvalue='2accessType='initializeOnly'/>
 38                      <field name='crossSectionRadiustype='SFFloatvalue='1accessType='initializeOnly'/>
 39                      <field name='spineResolutiontype='SFInt32value='16accessType='initializeOnly'/>
 40                      <field name='crossSectionResolutiontype='SFInt32value='16accessType='initializeOnly'/>
 41                      <field name='set_spineRadiustype='SFFloataccessType='inputOnly'/>
 42                      <field name='set_crossSectionRadiustype='SFFloataccessType='inputOnly'/>
 43                      <field name='spine_changedtype='MFVec3faccessType='outputOnly'/>
 44                      <field name='crossSection_changedtype='MFVec2faccessType='outputOnly'/>
  <![CDATA[
        
ecmascript:

function initialize( ) {
    generateCrossSection( );
    generateSpine( );
}

function set_crossSectionRadius( csr, ts ) {
    crossSectionRadius = csr;
    generateCrossSection( );
//  Browser.println ('crossSectionRadius = ' + csr);
}

function set_spineRadius( sr, ts ) {
    spineRadius = sr;
    generateSpine( );
//  Browser.println ('spineRadius = ' + sr);
}

function generateCrossSection( ) {
    angle = 0.0;
    delta = (2 * 3.141592653) / crossSectionResolution;
    for ( i = 0; i <= crossSectionResolution; i++ ) {
        crossSection_changed[i][0] =  crossSectionRadius * Math.cos( angle );
        crossSection_changed[i][1] = -crossSectionRadius * Math.sin( angle );
        angle += delta;
    }
    // added code to make ends meet
    crossSection_changed[crossSectionResolution + 1][0] = crossSection_changed[0][0];
    crossSection_changed[crossSectionResolution + 1][1] = crossSection_changed[0][1];
}

function generateSpine( ) {
    angle = 0.0;
    delta = (2 * 3.141592653) / spineResolution;
    for ( i = 0; i <= spineResolution; i++ ) {
        spine_changed[i][0] =  spineRadius * Math.cos( angle );
        spine_changed[i][1] =  0.0;
        spine_changed[i][2] = -spineRadius * Math.sin( angle );
        angle += delta;
    }
    // added code to make ends meet
    spine_changed[spineResolution + 1][0] = spine_changed[0][0];
    spine_changed[spineResolution + 1][1] = 0.0;
    spine_changed[spineResolution + 1][2] = spine_changed[0][2];
}

      
]]>
 46                 </Script>
 47            </Group>
 48            <!-- Either ROUTE from DonutMakerExternalScript or DonutMakerInternalScript, both methods work -->
 49            < ROUTE  fromNode='DonutMakerInternalScript' fromField='spine_changed' toNode='Donut' toField='set_spine'/>
 50            < ROUTE  fromNode='DonutMakerInternalScript' fromField='crossSection_changed' toNode='Donut' toField='set_crossSection'/>
 51       </Scene>
 52  </X3D>
<!--

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

<!-- to top Index for DEF nodes: Donut, DonutMakerExternalScript, DonutMakerInternalScript

Index for Viewpoint node: Viewpoint_1
-->
X3D Tooltips element index: Appearance, Extrusion, field, Group, head, Material, meta, ROUTE, Scene, Script, Shape, Viewpoint, WorldInfo, X3D, accessType and type, XML data types, field types

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

DonutMakerInternalScript
Script
spine_changed
MFVec3f

ROUTE
event to
(1)
Donut
Extrusion
set_spine
MFVec3f
DonutMakerInternalScript
Script
crossSection_changed
MFVec2f

ROUTE
event to
(1)
Donut
Extrusion
set_crossSection
MFVec2f
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/Vrml2Sourcebook/Chapter30Scripts/Figure30_5ScriptTorusBuilderIndex.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/Vrml2Sourcebook/Chapter30Scripts/Figure30_5ScriptTorusBuilder.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. -->