X3D Model Documentation: RefractiveMaterial.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='RefractiveMaterial.x3d'/>
  6            <meta name='descriptioncontent='X3D encodings example: create new node RefractiveMaterial for example PrototypesPlus.'/>
  7            <meta name='creatorcontent='Don Brutzman and Joe Williams'/>
  8            <meta name='createdcontent='1 June 2002'/>
  9            <meta name='modifiedcontent='28 October 2019'/>
 10            <meta name='referencecontent='PrototypesPlus.x3d'/>
 11            <meta name='specificationSectioncontent='X3D encodings, ISO/IEC 19776-1.3, Part 1: XML encoding, Annex C.7 Prototypes and alternate representations'/>
 12            <meta name='specificationUrlcontent='https://www.web3d.org/documents/specifications/19776-1/V3.3/Part01/examples.html#PrototyesAndAlternateReps'/>
 13            <meta name='identifiercontent='https://www.web3d.org/x3d/content/examples/Basic/X3dSpecifications/RefractiveMaterial.x3d'/>
 14            <meta name='generatorcontent='X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit'/>
 15            <meta name='licensecontent='../license.html'/>
 16       </head>
<!--

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

<!-- to top Index for DEF nodes: RefractionScript, RefractiveMaterialNode

Index for ProtoDeclare definition: RefractiveMaterial
-->
 17       <Scene>
 18            <!-- Protype definition for external use -->
 19            <WorldInfo title='RefractiveMaterial.x3d'/>
 20            <ProtoDeclare name='RefractiveMaterial'>
 21                 <ProtoInterface>
 22                      <field name='ambientIntensitytype='SFFloatvalue='0accessType='inputOutput'/>
 23                      <field name='diffuseColortype='SFColorvalue='0.5 0.5 0.5accessType='inputOutput'/>
 24                      <field name='specularColortype='SFColorvalue='0 0 0accessType='inputOutput'/>
 25                      <field name='emissiveColortype='SFColorvalue='0 0 0accessType='inputOutput'/>
 26                      <field name='shininesstype='SFFloatvalue='0accessType='inputOutput'/>
 27                      <field name='transparencytype='SFFloatvalue='0accessType='inputOutput'/>
 28                      <field name='indexOfRefractiontype='SFFloatvalue='0.1accessType='inputOutput'/>
 29                 </ProtoInterface>
 30                 <ProtoBody>
 31 
                    <!-- ROUTE information for RefractiveMaterialNode node:  [from RefractionScript.transparency_changed to transparency ] -->
                    <Material DEF='RefractiveMaterialNode'>
 32                           <IS>
 33                                <connect nodeField='ambientIntensityprotoField='ambientIntensity'/>
 34                                <connect nodeField='diffuseColorprotoField='diffuseColor'/>
 35                                <connect nodeField='specularColorprotoField='specularColor'/>
 36                                <connect nodeField='emissiveColorprotoField='emissiveColor'/>
 37                                <connect nodeField='shininessprotoField='shininess'/>
 38                                <connect nodeField='transparencyprotoField='transparency'/>
 39                           </IS>
 40                      </Material>
 41                      <!-- after first node in ProtoDeclare, remainder of nodes do not render -->
 42 
                    <!-- ROUTE information for RefractionScript node:  [from transparency_changed to RefractiveMaterialNode.transparency ] -->
                    <Script DEF='RefractionScript'>
 43                           <field name='transparencyInitialtype='SFFloataccessType='inputOutput'/>
 44                           <field name='indexOfRefractiontype='SFFloataccessType='inputOutput'/>
 45                           <field name='transparency_changedtype='SFFloataccessType='outputOnly'/>
 46                           <IS>
 47                                <connect nodeField='transparencyInitialprotoField='transparency'/>
 48                                <connect nodeField='indexOfRefractionprotoField='indexOfRefraction'/>
 49                           </IS>
  <![CDATA[
          
ecmascript:
function initialize()
{
    // arbitary example modification of usual node properties
    
    var newTransparency = 1.0 - ((1.0 - transparencyInitial) * indexOfRefraction);
    Browser.println ('indexOfRefraction=' + indexOfRefraction +
         ', transparencyInitial=' + transparencyInitial +
         ', transparency_changed=' + newTransparency);
    transparency_changed = newTransparency;
}

function set_transparencyInitial (eventValue)
{
   // input eventValue received for inputOutput field
    transparencyInitial = eventValue;
}

function set_indexOfRefraction (eventValue)
{
   // input eventValue received for inputOutput field
    indexOfRefraction = eventValue;
}

        
]]>
 51                      </Script>
 52                      < ROUTE  fromNode='RefractionScript' fromField='transparency_changed' toNode='RefractiveMaterialNode' toField='transparency'/>
 53                 </ProtoBody>
 54            </ProtoDeclare>
 55       </Scene>
 56  </X3D>
<!--

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

<!-- to top Index for DEF nodes: RefractionScript, RefractiveMaterialNode

Index for ProtoDeclare definition: RefractiveMaterial
-->
X3D Tooltips element index: connect, field, head, IS, Material, meta, ProtoBody, ProtoDeclare, ProtoInterface, ROUTE, Scene, Script, WorldInfo, X3D, accessType and type, XML data types, 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.

RefractionScript
Script
transparency_changed
SFFloat

ROUTE
event to
(1)
RefractiveMaterialNode
Material
transparency
SFFloat
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/Basic/X3dSpecifications/RefractiveMaterialIndex.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/Basic/X3dSpecifications/RefractiveMaterial.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. -->