<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">package Basic.Geospatial;

import org.web3d.x3d.jsail.Core.*;
import org.web3d.x3d.jsail.fields.*;
import org.web3d.x3d.jsail.Geometry3D.*;
import org.web3d.x3d.jsail.Geospatial.*;
import org.web3d.x3d.jsail.Grouping.*;
import org.web3d.x3d.jsail.Navigation.*;
import org.web3d.x3d.jsail.Networking.*;
import org.web3d.x3d.jsail.Scripting.*;
import org.web3d.x3d.jsail.Shape.*;
import org.web3d.x3d.jsail.Text.*;

// Javadoc metadata annotations follow, see below for X3DJSAIL Java source code.
/**
 * &lt;p&gt; X3D prototypes to render Keyhole Markup Language (KML) information. &lt;/p&gt;
 &lt;p&gt; Related links: Catalog page &lt;a href="../../../Geospatial/KmlPrototypesIndex.html" target="_blank"&gt;KmlPrototypes&lt;/a&gt;,  source &lt;a href="../../../Geospatial/KmlPrototypes.java"&gt;KmlPrototypes.java&lt;/a&gt;, &lt;a href="https://www.web3d.org/x3d/content/examples/X3dResources.html" target="_blank"&gt;X3D Resources&lt;/a&gt;, &lt;a href="https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html" target="_blank"&gt;X3D Scene Authoring Hints&lt;/a&gt;, and &lt;a href="https://www.web3d.org/x3d/content/X3dTooltips.html" target="_blank"&gt;X3D Tooltips&lt;/a&gt;. &lt;/p&gt;
	&lt;table style="color:black; border:0px solid; border-spacing:10px 0px;"&gt;
        &lt;caption&gt;Scene Meta Information&lt;/caption&gt;
		&lt;tr style="background-color:silver; border-color:silver;"&gt;
			&lt;td style="text-align:center; padding:10px 0px;"&gt;&lt;i&gt;meta tags&lt;/i&gt;&lt;/td&gt;
			&lt;td style="text-align:left;   padding:10px 0px;"&gt;&amp;nbsp; Document Metadata &lt;/td&gt;
		&lt;/tr&gt;

		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; title &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; &lt;a href="../../../Geospatial/KmlPrototypes.x3d"&gt;KmlPrototypes.x3d&lt;/a&gt; &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; description &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; X3D prototypes to render Keyhole Markup Language (KML) information. &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; translated &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; 20 August 2007 &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; modified &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; 20 October 2019 &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; creator &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; Don Brutzman &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr style="color:burntorange"&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; warning &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; under development &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; identifier &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; &lt;a href="https://www.web3d.org/x3d/content/examples/Basic/Geospatial/KmlPrototypes.x3d" target="_blank"&gt;https://www.web3d.org/x3d/content/examples/Basic/Geospatial/KmlPrototypes.x3d&lt;/a&gt; &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; reference &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; &lt;a href="http://www.opengeospatial.org/standards/kml" target="_blank"&gt;http://www.opengeospatial.org/standards/kml&lt;/a&gt; &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; reference &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; &lt;a href="http://schemas.opengis.net/kml" target="_blank"&gt;http://schemas.opengis.net/kml&lt;/a&gt; &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; reference &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; &lt;a href="http://schemas.opengis.net/kml/2.2.0/ogckml22.xsd" target="_blank"&gt;http://schemas.opengis.net/kml/2.2.0/ogckml22.xsd&lt;/a&gt; &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; reference &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; KmlToX3d.xslt &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; generator &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; X3D-Edit 3.3, &lt;a href="https://savage.nps.edu/X3D-Edit" target="_blank"&gt;https://savage.nps.edu/X3D-Edit&lt;/a&gt; &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr&gt;
			&lt;td style="text-align:right; vertical-align: text-top;"&gt; &lt;i&gt; license &lt;/i&gt; &lt;/td&gt;
			&lt;td&gt; &lt;a href="../../../Geospatial/../license.html"&gt;../license.html&lt;/a&gt; &lt;/td&gt;
		&lt;/tr&gt;
		&lt;tr style="background-color:silver; border-color:silver;"&gt;
			&lt;td style="text-align:center;" colspan="2"&gt;  &amp;nbsp; &lt;/td&gt;
		&lt;/tr&gt;
	&lt;/table&gt;

	&lt;p&gt;
		This program uses the
		&lt;a href="https://www.web3d.org/specifications/java/X3DJSAIL.html" target="_blank"&gt;X3D Java Scene Access Interface Library (X3DJSAIL)&lt;/a&gt;.
		It has been produced using the 
		&lt;a href="https://www.web3d.org/x3d/stylesheets/X3dToJava.xslt" target="_blank"&gt;X3dToJava.xslt&lt;/a&gt;
		stylesheet
	       (&lt;a href="https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/stylesheets/X3dToJava.xslt" target="_blank"&gt;version control&lt;/a&gt;)
                which is used to create Java source code from an original &lt;code&gt;.x3d&lt;/code&gt; model.
	&lt;/p&gt;

	* @author Don Brutzman
 */

public class KmlPrototypes
{
	/** Default constructor to create this object. */
	public KmlPrototypes ()
	{
	  initialize();
	}

	/** Create and initialize the X3D model for this object. */
	public final void initialize()
	{
            try { // catch-all
  x3dModel = new X3D().setProfile(X3D.PROFILE_IMMERSIVE).setVersion(X3D.VERSION_3_3)
  .setHead(new head()
    .addComponent(new component().setName("Geospatial").setLevel(1))
    .addMeta(new meta().setName(meta.NAME_TITLE      ).setContent("KmlPrototypes.x3d"))
    .addMeta(new meta().setName(meta.NAME_DESCRIPTION).setContent("X3D prototypes to render Keyhole Markup Language (KML) information."))
    .addMeta(new meta().setName(meta.NAME_TRANSLATED ).setContent("20 August 2007"))
    .addMeta(new meta().setName(meta.NAME_MODIFIED   ).setContent("20 October 2019"))
    .addMeta(new meta().setName(meta.NAME_CREATOR    ).setContent("Don Brutzman"))
    .addMeta(new meta().setName(meta.NAME_WARNING    ).setContent("under development"))
    .addMeta(new meta().setName(meta.NAME_IDENTIFIER ).setContent("https://www.web3d.org/x3d/content/examples/Basic/Geospatial/KmlPrototypes.x3d"))
    .addMeta(new meta().setName(meta.NAME_REFERENCE  ).setContent("http://www.opengeospatial.org/standards/kml"))
    .addMeta(new meta().setName(meta.NAME_REFERENCE  ).setContent("http://schemas.opengis.net/kml"))
    .addMeta(new meta().setName(meta.NAME_REFERENCE  ).setContent("http://schemas.opengis.net/kml/2.2.0/ogckml22.xsd"))
    .addMeta(new meta().setName(meta.NAME_REFERENCE  ).setContent("KmlToX3d.xslt"))
    .addMeta(new meta().setName(meta.NAME_GENERATOR  ).setContent("X3D-Edit 3.3, https://savage.nps.edu/X3D-Edit"))
    .addMeta(new meta().setName(meta.NAME_LICENSE    ).setContent("../license.html")))
  .setScene(new Scene()
    .addChild(new ProtoDeclare("PlaceMark").setName("PlaceMark").setAppinfo("A Placemark with a Point has an icon associated with it that marks a point on the earth in the 3D viewer.").setDocumentation("http://code.google.com/apis/kml/documentation/kml_tags_21.html#placemark")
      .setProtoInterface(new ProtoInterface()
        .addField(new field().setName("id").setType(field.TYPE_SFSTRING).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
        .addField(new field().setName("name").setType(field.TYPE_MFSTRING).setAccessType(field.ACCESSTYPE_INPUTOUTPUT).setAppinfo("Label for the object"))
        .addField(new field().setName("description").setType(field.TYPE_SFSTRING).setAccessType(field.ACCESSTYPE_INPUTOUTPUT).setAppinfo("User-supplied text that appears in the description balloon"))
        .addField(new field().setName("coordinates").setType(field.TYPE_SFVEC3D).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setValue(new SFVec3d(0.0,0.0,0.0)).setAppinfo("longitude latitude and altitude"))
        .addField(new field().setName("address").setType(field.TYPE_MFSTRING).setAccessType(field.ACCESSTYPE_INPUTOUTPUT).setAppinfo("A string value representing an unstructured address written as a standard street city state address and/or as a postal code."))
        .addField(new field().setName("visibility").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setValue(true).setAppinfo(". Specifies whether the feature is drawn in the 3D viewer when it is initially loaded"))
        .addField(new field().setName("set_visibility").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INPUTONLY))
        .addField(new field().setName("visibility_changed").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
        .addComments(" TODO: is the 'open' parameter appropriate for X3D? Maintain value for round-trip conversions. ")
        .addField(new field().setName("open").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setValue(true).setAppinfo("Specifies whether a Folder appears closed or open when first loaded"))
        .addComments(" TODO: need LookAt Prototype ")
        .addField(new field().setName("snippet").setType(field.TYPE_MFSTRING).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setAppinfo("A short description of the feature"))
        .addField(new field().setName("set_snippet").setType(field.TYPE_MFSTRING).setAccessType(field.ACCESSTYPE_INPUTONLY))
        .addField(new field().setName("snippet_changed").setType(field.TYPE_MFSTRING).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
        .addComments(" TODO: AddressDetails, phoneNumber, TimePrimitive, styleUrl, StyleSelector, Region ")
        .addComments(" TODO: Geometry prototypes for KML Point,LineString,LinearRing, Polygon,MultiGeometry,Model ")
        .addField(new field().setName("geometry").setType(field.TYPE_MFNODE).setAccessType(field.ACCESSTYPE_INPUTOUTPUT).setAppinfo("Shape or (KML) Point LineString LinearRing Polygon MultiGeometry Model")
          .addComments(" default NULL node "))
        .addField(new field().setName("diffuseColor").setType(field.TYPE_SFCOLOR).setAccessType(field.ACCESSTYPE_INPUTOUTPUT).setValue(new SFColor(0.2,0.8,0.4)).setAppinfo("Default color for PlaceMark"))
        .addField(new field().setName("metadata").setType(field.TYPE_SFNODE).setAccessType(field.ACCESSTYPE_INPUTOUTPUT)
          .addComments(" default NULL node ")))
      .setProtoBody(new ProtoBody()
        .addComments(" TODO: is Switch needed to choose between balloon and provided geometry, or are both shown? ")
        .addChild(new Switch("SwitchVisible").setWhichChoice(0)
          .addChild(new Anchor()
            .setIS(new IS()
              .addConnect(new connect().setNodeField("url").setProtoField("address"))
              .addConnect(new connect().setNodeField("description").setProtoField("description")))
            .addChild(new GeoLocation()
              .setGeoOrigin(new GeoOrigin()
                .setIS(new IS()
                  .addConnect(new connect().setNodeField("geoCoords").setProtoField("coordinates")))))
            .addChild(new Shape("PlaceMarkBalloon")
              .setGeometry(new Extrusion().setCreaseAngle(3.14).setCrossSection(new MFVec2f(new double[] {1.00,0.00,0.92,-0.38,0.71,-0.71,0.38,-0.92,0.00,-1.00,-0.38,-0.92,-0.71,-0.71,-0.92,-0.38,-1.00,-0.00,-0.92,0.38,-0.71,0.71,-0.38,0.92,0.00,1.00,0.38,0.92,0.71,0.71,0.92,0.38,1.00,0.00})).setScale(new MFVec2f(new double[] {0.01,0.01,0.03,0.03,0.06,0.06,0.09,0.09,0.14,0.14,0.23,0.23,0.25,0.25,0.23,0.23,0.18,0.18,0.1,0.1,0.03,0.03})).setSpine(new MFVec3f(new double[] {0.0,0.0,0.0,0.0,0.12,0.0,0.0,0.28,0.0,0.0,0.4,0.0,0.0,0.55,0.0,0.0,0.65,0.0,0.0,0.75,0.0,0.0,0.85,0.0,0.0,0.92,0.0,0.0,0.98,0.0,0.0,1.0,0.0})))
              .setAppearance(new Appearance()
                .setMaterial(new Material("PlaceMarkMaterial")
                  .setIS(new IS()
                    .addConnect(new connect().setNodeField("diffuseColor").setProtoField("diffuseColor"))))))
            .addChild(new Transform("PlaceMarkName").setTranslation(0.0,1.2,0.0)
              .addChild(new Shape()
                .setGeometry(new Text()
                  .setIS(new IS()
                    .addConnect(new connect().setNodeField("string").setProtoField("name")))
                  .setFontStyle(new FontStyle().setJustify(FontStyle.JUSTIFY_MIDDLE_MIDDLE).setSize(0.2)))
                .setAppearance(new Appearance()
                  .setMaterial(new Material().setUSE("PlaceMarkMaterial")))))
            .addChild(new Transform("SnippetTranslation").setTranslation(0.0,2.4,0.0)
              .addChild(new Shape()
                .setGeometry(new Text()
                  .setIS(new IS()
                    .addConnect(new connect().setNodeField("string").setProtoField("snippet")))
                  .setFontStyle(new FontStyle().setJustify(FontStyle.JUSTIFY_MIDDLE_MIDDLE).setSize(0.2)))
                .setAppearance(new Appearance()
                  .setMaterial(new Material().setUSE("PlaceMarkMaterial")))))
            .addChild(new Group("GeometryGroup")
              .setIS(new IS()
                .addConnect(new connect().setNodeField("children").setProtoField("geometry"))))))
        .addComments(" remaining nodes in ProtoBody are not rendered ")
        .addChild(new WorldInfo()
          .setIS(new IS()
            .addConnect(new connect().setNodeField("title").setProtoField("id"))))
        .addChild(new Group("MetadataHolderPlaceMark")
          .setIS(new IS()
            .addConnect(new connect().setNodeField("metadata").setProtoField("metadata"))))
        .addChild(new Script("BehaviorScript").setSourceCode("""
ecmascript:

function initialize ()
{
	Browser.println ('visibility=' + visibility);
	if (visibility == false) visibilityChoice = -1;

	// TODO:  if (open == false) open_changed = -1;

	adjustSnippetOffset ();
}

function set_visibility (value, timestamp)
{
	visibility = value;         // remember change
	visibility_changed = value; // send eventOut
	if (visibility == false) visibilityChoice = -1;
	else                     visibilityChoice =  0;
}

function set_snippet (value, timestamp)
{
	snippet = value;         // remember change
	snippet_changed = value; // send eventOut
	adjustSnippetOffset ();
}

function adjustSnippetOffset () // TODO
{
//	snippetOffset = new SFVec3f (0.0, (snippet.length * 0.3), 0.0);
//	Browser.println ('snippet.length=' + snippet.length + ', snippetOffset=' + snippetOffset);
}

function set_open (value, timestamp) // TODO
{

}
""")
          .addField(new field().setName("visibility").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
          .addField(new field().setName("set_visibility").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INPUTONLY))
          .addField(new field().setName("visibility_changed").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
          .addField(new field().setName("visibilityChoice").setType(field.TYPE_SFINT32).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
          .addField(new field().setName("open").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
          .addField(new field().setName("snippet").setType(field.TYPE_MFSTRING).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
          .addField(new field().setName("set_snippet").setType(field.TYPE_MFSTRING).setAccessType(field.ACCESSTYPE_INPUTONLY))
          .addField(new field().setName("snippet_changed").setType(field.TYPE_MFSTRING).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
          .addField(new field().setName("snippetOffset").setType(field.TYPE_SFVEC3F).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
          .setIS(new IS()
            .addConnect(new connect().setNodeField("visibility").setProtoField("visibility"))
            .addConnect(new connect().setNodeField("set_visibility").setProtoField("set_visibility"))
            .addConnect(new connect().setNodeField("visibility_changed").setProtoField("visibility_changed"))
            .addConnect(new connect().setNodeField("open").setProtoField("open"))
            .addConnect(new connect().setNodeField("snippet").setProtoField("snippet"))
            .addConnect(new connect().setNodeField("set_snippet").setProtoField("set_snippet"))
            .addConnect(new connect().setNodeField("snippet_changed").setProtoField("snippet_changed"))))
        .addChild(new ROUTE().setFromNode("BehaviorScript").setFromField("visibilityChoice").setToNode("SwitchVisible").setToField("whichChoice"))
        .addChild(new ROUTE().setFromNode("BehaviorScript").setFromField("snippetOffset").setToNode("SnippetTranslation").setToField("set_translation"))))
    .addChild(new ProtoDeclare("Point").setName("Point").setAppinfo("A geographic location defined by longitude latitude and (required) altitude.").setDocumentation("http://code.google.com/apis/kml/documentation/kml_tags_21.html#point")
      .setProtoInterface(new ProtoInterface()
        .addField(new field().setName("id").setType(field.TYPE_SFSTRING).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
        .addField(new field().setName("altitudeMode").setType(field.TYPE_SFSTRING).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setValue("clampToGround").setAppinfo("allowed values: clampToGround relativeToGround absolute"))
        .addField(new field().setName("coordinates").setType(field.TYPE_SFVEC3D).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setValue(new SFVec3d(0.0,0.0,0.0)))
        .addField(new field().setName("set_coordinates").setType(field.TYPE_SFVEC3D).setAccessType(field.ACCESSTYPE_INPUTONLY))
        .addField(new field().setName("coordinates_changed").setType(field.TYPE_SFVEC3D).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
        .addField(new field().setName("extrude").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setValue(false))
        .addField(new field().setName("tessellate").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setValue(false))
        .addField(new field().setName("metadata").setType(field.TYPE_SFNODE).setAccessType(field.ACCESSTYPE_INPUTOUTPUT)
          .addComments(" default NULL node ")))
      .setProtoBody(new ProtoBody()
        .addChild(new Script("PointScript").setSourceCode("""
ecmascript:

function initialize ()
{
	if  (altitudeMode == '') altitudeMode = 'clampToGround';
	if ((altitudeMode != 'clampToGround') &amp;&amp;
	    (altitudeMode != 'relativeToGround') &amp;&amp;
	    (altitudeMode != 'absolute'))
	{
		warningString = '[Point';
		if (id != '') warningString += ' ' + id;
		warningString += '] illegal value ';
		warningString += 'altitudeMode=' + altitudeMode;
		Browser.println (warningString);
	}
}

function set_coordinates (value)
{
	coordinates = value;
	coordinates_changed = value;
}

// TODO: how to handle extrude, tessellate
""")
          .addField(new field().setName("altitudeMode").setType(field.TYPE_SFSTRING).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
          .addField(new field().setName("coordinates").setType(field.TYPE_SFVEC3D).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
          .addField(new field().setName("set_coordinates").setType(field.TYPE_SFVEC3D).setAccessType(field.ACCESSTYPE_INPUTONLY))
          .addField(new field().setName("coordinates_changed").setType(field.TYPE_SFVEC3D).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
          .addField(new field().setName("extrude").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
          .addField(new field().setName("tessellate").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY))
          .setIS(new IS()
            .addConnect(new connect().setNodeField("altitudeMode").setProtoField("altitudeMode"))
            .addConnect(new connect().setNodeField("coordinates").setProtoField("coordinates"))
            .addConnect(new connect().setNodeField("set_coordinates").setProtoField("set_coordinates"))
            .addConnect(new connect().setNodeField("coordinates_changed").setProtoField("coordinates_changed"))
            .addConnect(new connect().setNodeField("extrude").setProtoField("extrude"))
            .addConnect(new connect().setNodeField("tessellate").setProtoField("tessellate"))))
        .addChild(new WorldInfo()
          .setIS(new IS()
            .addConnect(new connect().setNodeField("title").setProtoField("id"))))
        .addChild(new Group("MetadataHolderPoint")
          .setIS(new IS()
            .addConnect(new connect().setNodeField("metadata").setProtoField("metadata"))))))
    .addComments(" ========== Examples ========== ")
    .addChild(new Viewpoint().setDescription("Placemark example").setPosition(0.0,0.0,4.0))
    .addComments(" &lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt; &lt;kml xmlns=\"http://earth.google.com/kml/2.1\"&gt; &lt;Placemark&gt; &lt;name&gt;Simple placemark&lt;/name&gt; &lt;description&gt;Attached to the ground. Intelligently places itself at the height of the underlying terrain.&lt;/description&gt; &lt;Point&gt; &lt;coordinates&gt;-122.0822035425683,37.42228990140251,0&lt;/coordinates&gt; &lt;/Point&gt; &lt;/Placemark&gt; &lt;/kml&gt; ")
    .addChild(new ProtoInstance("PlaceMark").setContainerField("children")
      .addFieldValue(new fieldValue().setName("name").setValue(new String[] {"Simple placemark"}))
      .addFieldValue(new fieldValue().setName("description").setValue("Attached to the ground. Intelligently places itself at the height of the underlying terrain."))
      .addFieldValue(new fieldValue().setName("coordinates").setValue(new SFVec3d(-122.0822035425683,37.42228990140251,0.0)))
      .addFieldValue(new fieldValue().setName("address").setValue(new String[] {"https://www.web3d.org/x3d-earth"}))));
            }
            catch (Exception ex)
            {       
                System.err.println ("*** Further hints on X3DJSAIL errors and exceptions at");
                System.err.println ("*** https://www.web3d.org/specifications/java/X3DJSAIL.html");
                throw (ex);
            }
	}
	// end of initialize() method

	/** The initialized model object, created within initialize() method. */
	private X3D x3dModel;

	/** 
	 * Provide a 
	 * &lt;a href="https://dzone.com/articles/java-copy-shallow-vs-deep-in-which-you-will-swim" target="_blank"&gt;shallow copy&lt;/a&gt;
	 * of the X3D model.
	 * @see &lt;a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/Core/X3D.html"&gt;X3D&lt;/a&gt;
	 * @return KmlPrototypes model
	 */
	public X3D getX3dModel()
	{	  
		return x3dModel;
	}
	   
    /** 
     * Default main() method provided for test purposes, uses CommandLine to set global ConfigurationProperties for this object.
     * @param args array of input parameters, provided as arguments
     * @see &lt;a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/Core/X3D.html#handleArguments-java.lang.String:A-"&gt;X3D.handleArguments(args)&lt;/a&gt;
     * @see &lt;a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/Core/X3D.html#validationReport--"&gt;X3D.validationReport()&lt;/a&gt;
     * @see &lt;a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/CommandLine.html"&gt;CommandLine&lt;/a&gt;
     * @see &lt;a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/CommandLine.html#USAGE"&gt;CommandLine.USAGE&lt;/a&gt;
     * @see &lt;a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/ConfigurationProperties.html"&gt;ConfigurationProperties&lt;/a&gt;
     */
    public static void main(String args[])
    {
        System.out.println("Build this X3D model, showing validation diagnostics...");
        X3D thisExampleX3dModel = new KmlPrototypes().getX3dModel();
//      System.out.println("X3D model construction complete.");
	
        // next handle command line arguments
        boolean hasArguments = (args != null) &amp;&amp; (args.length &gt; 0);
        boolean validate = true; // default
        boolean argumentsLoadNewModel = false;
        String  fileName = new String();

        if (args != null)
        {
                for (String arg : args)
                {
                        if (arg.toLowerCase().startsWith("-v") || arg.toLowerCase().contains("validate"))
                        {
                                validate = true; // making sure
                        }
                        if (arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_X3D) ||
                                arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_CLASSICVRML) ||
                                arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_X3DB) ||
                                arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_VRML97) ||
                                arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_EXI) ||
                                arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_GZIP) ||
                                arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_ZIP) ||
                                arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_HTML) ||
                                arg.toLowerCase().endsWith(X3D.FILE_EXTENSION_XHTML))
                        {
                                argumentsLoadNewModel = true;
                                fileName = arg;
                        }
                }
        }
        if      (argumentsLoadNewModel)
                System.out.println("WARNING: \"Basic.Geospatial.KmlPrototypes\" model invocation is attempting to load file \"" + fileName + "\" instead of simply validating itself... file loading ignored.");
        else if (hasArguments) // if no arguments provided, this method produces usage warning
                thisExampleX3dModel.handleArguments(args);
	
        if (validate)
        {
            //  System.out.println("--- TODO fix duplicated outputs ---"); // omit when duplicated outputs problem is solved/refactored
		String validationResults = thisExampleX3dModel.validationReport();
            //  System.out.println("-----------------------------------"); // omit when duplicated outputs problem is solved/refactored
                System.out.print("Basic.Geospatial.KmlPrototypes self-validation test confirmation: ");
                if (!validationResults.equals("success"))
                    System.out.println();
                System.out.println(validationResults.trim());

                // experimental: test X3DJSAIL output files
                // Geospatial/KmlPrototypes_JavaExport.* file validation is checked when building X3D Example Archives
                String filenameX3D  = "Geospatial/KmlPrototypes_JavaExport.x3d"; 
                String filenameX3DV = "Geospatial/KmlPrototypes_JavaExport.x3dv"; 
                String filenameJSON = "Geospatial/KmlPrototypes_JavaExport.json";
                thisExampleX3dModel.toFileX3D        (filenameX3D);
                thisExampleX3dModel.toFileClassicVRML(filenameX3DV);
// TODO         thisExampleX3dModel.toFileJSON       (filenameJSON);
        }
    }
}
</pre></body></html>