X3D Model Documentation: ECMAScriptSaiCreateNodesFromPrototype.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='ECMAScriptSaiCreateNodesFromPrototype.x3d'/>
  6            <meta name='descriptioncontent='Java Scene Authoring Interface (JSAI) scene and source code example that show creation of nodes from a prototype.'/>
  7            <meta name='creatorcontent='X3D Working Group'/>
  8            <meta name='createdcontent='23 February 2005'/>
  9            <meta name='modifiedcontent='28 October 2019'/>
 10            <meta name='referencecontent='https://www.web3d.org/files/specifications/19777-1/V3.3/Part1/X3D_ECMAScript.html'/>
 11            <meta name='specificationSectioncontent='X3D language bindings, ISO/IEC 19777-1, Part 1: ECMAScript, B.6 Create nodes from a prototype'/>
 12            <meta name='specificationUrlcontent='https://www.web3d.org/files/specifications/19777-1/V3.3/Part1/examples.html#CreateNodesFromAPrototype'/>
 13            <meta name='generatorcontent='X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit'/>
 14            <meta name='identifiercontent='https://www.web3d.org/x3d/content/examples/Basic/X3dSpecifications/ECMAScriptSaiCreateNodesFromPrototype.x3d'/>
 15            <meta name='licensecontent='../license.html'/>
 16       </head>
<!--

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

<!-- to top Index for DEF node: SC

Index for ProtoDeclare definition: ColoredSphere
-->
 17       <Scene>
 18            <WorldInfo title='ECMAScriptSaiCreateNodesFromPrototype.x3d'/>
 19            <ProtoDeclare name='ColoredSphere'>
 20                 <ProtoInterface>
 21                      <field name='colortype='SFColorvalue='0 1 0accessType='initializeOnly'/>
 22                 </ProtoInterface>
 23                 <ProtoBody>
 24                      <Shape>
 25                           <Sphere/>
 26                           <Appearance>
 27                                <Material>
 28                                     <IS>
 29                                          <connect nodeField='diffuseColorprotoField='color'/>
 30                                     </IS>
 31                                </Material>
 32                           </Appearance>
 33                      </Shape>
 34                 </ProtoBody>
 35            </ProtoDeclare>
 36            <Script DEF='SC'>
  <![CDATA[
      
ecmascript:
function initialize() {
    // Create nodes directly in the parent scene
    scene = Browser.currentScene;

	// TODO scene.protoDeclarations not defined in
	// https://www.web3d.org/documents/specifications/19777-1/V3.3/Part1/functions.html
	// but Table 7.5 — Execution context properties does define .protos
	// For precise clarity, consider deprecating/renaming .protos as .protoDeclarations
	
    // Look through proto declarations for ColoredSphere
//  protoDecls = scene.protoDeclarations;
    protoDecls = scene.protos;

    var protoDecl;

    for(i=0; i < protoDecls.length; i++) {
        if (protoDecls[i].name == 'ColoredSphere')
            protoDecl = protoDecls[i];
    }

    // Create an instance of RedSphere
    instance = protoDecl.newInstance();

    // Set the color field to Red
    instance.color = new SFColor(1,0,0);

    // Add the created proto to the scene
    scene.rootNodes[0] = instance;
}

    
]]>
 38            </Script>
 39       </Scene>
 40  </X3D>
<!--

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

<!-- to top Index for DEF node: SC

Index for ProtoDeclare definition: ColoredSphere
-->
X3D Tooltips element index: Appearance, connect, field, head, IS, Material, meta, ProtoBody, ProtoDeclare, ProtoInterface, Scene, Script, Shape, Sphere, WorldInfo, X3D, accessType and type, XML data types, field types

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

SC
Script
No ROUTE connection found for output events from this node.
This Script has no direct access to other nodes. 
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/ECMAScriptSaiCreateNodesFromPrototypeIndex.html -->
<!-- Version control at
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/content/examples/Basic/X3dSpecifications/ECMAScriptSaiCreateNodesFromPrototype.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. -->