package Savage.Weapons.Guns;

import org.web3d.x3d.jsail.Core.*;
import org.web3d.x3d.jsail.EnvironmentalEffects.*;
import org.web3d.x3d.jsail.fields.*;
import org.web3d.x3d.jsail.Geometry3D.*;
import org.web3d.x3d.jsail.Grouping.*;
import org.web3d.x3d.jsail.Interpolation.*;
import org.web3d.x3d.jsail.Navigation.*;
import org.web3d.x3d.jsail.PointingDeviceSensor.*;
import org.web3d.x3d.jsail.Rendering.*;
import org.web3d.x3d.jsail.Shape.*;
import org.web3d.x3d.jsail.Texturing.*;
import org.web3d.x3d.jsail.Time.*;

// Javadoc metadata annotations follow, see below for X3DJSAIL Java source code.
/**
 * <p> Simple model that depicts small boat launched net entanglement system. </p>
 <p> Related links: Catalog page <a href="../../../../Weapons/Guns/NonLethalNetLauncherPrototypeIndex.html" target="_blank">NonLethalNetLauncherPrototype</a>,  source <a href="../../../../Weapons/Guns/NonLethalNetLauncherPrototype.java">NonLethalNetLauncherPrototype.java</a>, <a href="https://www.web3d.org/x3d/content/examples/X3dResources.html" target="_blank">X3D Resources</a>, <a href="https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html" target="_blank">X3D Scene Authoring Hints</a>, and <a href="https://www.web3d.org/x3d/content/X3dTooltips.html" target="_blank">X3D Tooltips</a>. </p>
	<table style="color:black; border:0px solid; border-spacing:10px 0px;">
        <caption>Scene Meta Information</caption>
		<tr style="background-color:silver; border-color:silver;">
			<td style="text-align:center; padding:10px 0px;"><i>meta tags</i></td>
			<td style="text-align:left;   padding:10px 0px;">&nbsp; Document Metadata </td>
		</tr>

		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> title </i> </td>
			<td> <a href="../../../../Weapons/Guns/NonLethalNetLauncherPrototype.x3d">NonLethalNetLauncherPrototype.x3d</a> </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> description </i> </td>
			<td> Simple model that depicts small boat launched net entanglement system. </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> creator </i> </td>
			<td> James Harney </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> created </i> </td>
			<td> 14 March 2002 </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> modified </i> </td>
			<td> 28 November 2019 </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> identifier </i> </td>
			<td> <a href="https://www.web3d.org/x3d/content/examples/Savage/Weapons/Guns/NonLethalNetLauncherPrototype.x3d" target="_blank">https://www.web3d.org/x3d/content/examples/Savage/Weapons/Guns/NonLethalNetLauncherPrototype.x3d</a> </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> generator </i> </td>
			<td> X3D-Edit 3.2, <a href="https://www.web3d.org/x3d/tools/X3D-Edit" target="_blank">https://www.web3d.org/x3d/tools/X3D-Edit</a> </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> license </i> </td>
			<td> <a href="../../../../Weapons/Guns/../../license.html">../../license.html</a> </td>
		</tr>
		<tr style="background-color:silver; border-color:silver;">
			<td style="text-align:center;" colspan="2">  &nbsp; </td>
		</tr>
	</table>

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

	* @author James Harney
 */

public class NonLethalNetLauncherPrototype
{
	/** Default constructor to create this object. */
	public NonLethalNetLauncherPrototype ()
	{
	  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_0)
  .setHead(new head()
    .addMeta(new meta().setName(meta.NAME_TITLE      ).setContent("NonLethalNetLauncherPrototype.x3d"))
    .addMeta(new meta().setName(meta.NAME_DESCRIPTION).setContent("Simple model that depicts small boat launched net entanglement system."))
    .addMeta(new meta().setName(meta.NAME_CREATOR    ).setContent("James Harney"))
    .addMeta(new meta().setName(meta.NAME_CREATED    ).setContent("14 March 2002"))
    .addMeta(new meta().setName(meta.NAME_MODIFIED   ).setContent("28 November 2019"))
    .addMeta(new meta().setName(meta.NAME_IDENTIFIER ).setContent("https://www.web3d.org/x3d/content/examples/Savage/Weapons/Guns/NonLethalNetLauncherPrototype.x3d"))
    .addMeta(new meta().setName(meta.NAME_GENERATOR  ).setContent("X3D-Edit 3.2, https://www.web3d.org/x3d/tools/X3D-Edit"))
    .addMeta(new meta().setName(meta.NAME_LICENSE    ).setContent("../../license.html")))
  .setScene(new Scene()
    .addChild(new WorldInfo().setTitle("NonLethalNetLauncherPrototype.x3d"))
    .addChild(new NavigationInfo().setSpeed(10))
    .addChild(new ProtoDeclare("NetLauncher").setName("NetLauncher").setAppinfo("Nonlethal Net Launcher to repel boarders")
      .setProtoInterface(new ProtoInterface()
        .addField(new field().setName("startLaunchToStbd").setType(field.TYPE_SFTIME).setAccessType(field.ACCESSTYPE_INPUTONLY))
        .addField(new field().setName("startLaunchToPort").setType(field.TYPE_SFTIME).setAccessType(field.ACCESSTYPE_INPUTONLY))
        .addField(new field().setName("netTranslation").setType(field.TYPE_SFVEC3F).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
        .addField(new field().setName("netScale").setType(field.TYPE_SFVEC3F).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
        .addField(new field().setName("netOrientation").setType(field.TYPE_SFROTATION).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
        .addField(new field().setName("nettingScale").setType(field.TYPE_SFVEC3F).setAccessType(field.ACCESSTYPE_OUTPUTONLY)))
      .setProtoBody(new ProtoBody()
        .addChild(new Group()
          .addChild(new Background().setGroundAngle(new double[] {1.309,1.570796}).setGroundColor(new MFColor(new double[] {0.1,0.1,0.0,0.4,0.25,0.2,0.6,0.6,0.6})).setSkyAngle(new double[] {1.309,1.571}).setSkyColor(new MFColor(new double[] {0.0,0.2,0.7,0.0,0.5,1.0,1.0,1.0,1.0})))
          .addComments(" Note that the term stbd refers to the position of the launcher tube and is 180 the direction of launch ")
          .addChild(new Transform()
            .addChild(new Viewpoint("STBD").setDescription("Net Launcher stbd View").setJump(false).setOrientation(1.0,0.0,0.0,-.2).setPosition(0.0,5.0,12.0))
            .addChild(new Viewpoint("FRONT").setDescription("Net Launcher Front View").setOrientation(0.0,1.0,0.0,1.57).setPosition(12.0,3.0,0.0))
            .addChild(new Viewpoint("PORT").setDescription("Net Launcher Port View").setJump(false).setOrientation(0.0,1.0,0.0,3.14).setPosition(0.0,3.0,-12.0))
            .addChild(new Viewpoint("REAR").setDescription("Net Launcher Rear View").setOrientation(0.0,1.0,0.0,-1.57).setPosition(-12.0,3.0,0.0)))
          .addChild(new TimeSensor("NetPositClock").setCycleInterval(3)
            .setIS(new IS()
              .addConnect(new connect().setNodeField("startTime").setProtoField("startLaunchToStbd"))))
          .addChild(new TimeSensor("NetPositClockStbd").setCycleInterval(3)
            .setIS(new IS()
              .addConnect(new connect().setNodeField("startTime").setProtoField("startLaunchToPort"))))
          .addChild(new PositionInterpolator("NetPositInterp").setKey(new double[] {0.0,.5,1.0}).setKeyValue(new MFVec3f(new double[] {0.0,0.0,0.0,0.0,25.0,10.0,0.0,7.5,21.0}))
            .setIS(new IS()
              .addConnect(new connect().setNodeField("value_changed").setProtoField("netTranslation"))))
          .addChild(new PositionInterpolator("NetPositInterpStbd").setKey(new double[] {0.0,.5,1.0}).setKeyValue(new MFVec3f(new double[] {0.0,0.0,0.0,0.0,25.0,-10.0,0.0,7.5,-21.0})))
          .addChild(new PositionInterpolator("NetPositScale").setKey(new double[] {.1,1.0}).setKeyValue(new MFVec3f(new double[] {1.0,1.0,1.0,1.0,8.0,1.0})))
          .addChild(new PositionInterpolator("NetPositScaleStbd").setKey(new double[] {.1,1.0}).setKeyValue(new MFVec3f(new double[] {1.0,1.0,1.0,1.0,8.0,1.0})))
          .addChild(new PositionInterpolator("NettingScale").setKey(new double[] {.3,1.0}).setKeyValue(new MFVec3f(new double[] {.01,.01,.01,1.0,2.0,1.0})))
          .addChild(new PositionInterpolator("NettingScaleStbd").setKey(new double[] {.3,1.0}).setKeyValue(new MFVec3f(new double[] {.01,.01,.01,1.0,2.0,1.0})))
          .addChild(new OrientationInterpolator("NetOrientInterp").setKey(new double[] {0.0,.5,.9,1.0}).setKeyValue(new MFRotation(new double[] {1.0,0.0,0.0,0.0,1.0,0.0,0.0,.78,1.0,0.0,0.0,1.0,1.0,0.0,0.0,.78})))
          .addChild(new OrientationInterpolator("NetOrientInterpStbd").setKey(new double[] {0.0,.5,.9,1.0}).setKeyValue(new MFRotation(new double[] {1.0,0.0,0.0,0.0,1.0,0.0,0.0,-.78,1.0,0.0,0.0,-1.0,1.0,0.0,0.0,-.78})))
          .addChild(new Transform("TubeTransform")
            .addChild(new Transform("PortTubeTransform").setRotation(1.0,0.0,0.0,.78)
              .addChild(new Shape()
                .setAppearance(new Appearance()
                  .setMaterial(new Material().setDiffuseColor(.9,.9,.9).setShininess(1)))
                .setGeometry(new Cylinder().setHeight(1.5).setRadius(.15)))
              .addChild(new Transform().setRotation(1.0,0.0,0.0,1.57).setTranslation(0.0,-.75,0.0)
                .addChild(new Shape()
                  .setGeometry(new Box().setSize(.5,.5,.01))
                  .setAppearance(new Appearance()
                    .setMaterial(new Material().setDiffuseColor(.9,.9,.9).setShininess(1)))))
              .addChild(new Transform("NetTransform")
                .setIS(new IS()
                  .addConnect(new connect().setNodeField("scale").setProtoField("netScale"))
                  .addConnect(new connect().setNodeField("rotation").setProtoField("netOrientation")))
                .addChild(new Transform("NettingTransform").setRotation(0.0,1.0,0.0,1.57).setScale(.01,.01,.01).setTranslation(0.0,0.0,1.0)
                  .setIS(new IS()
                    .addConnect(new connect().setNodeField("scale").setProtoField("nettingScale"))))))
            .addChild(new Transform("StbdTubeTransform").setTranslation(-.3,0.0,0.0)
              .addChild(new Transform().setRotation(1.0,0.0,0.0,-.78)
                .addChild(new Shape()
                  .setAppearance(new Appearance()
                    .setMaterial(new Material().setDiffuseColor(.9,.9,.9).setShininess(1)))
                  .setGeometry(new Cylinder().setHeight(1.5).setRadius(.15)))
                .addChild(new Transform().setRotation(1.0,0.0,0.0,-1.57).setTranslation(0.0,-.75,0.0)
                  .addChild(new Shape()
                    .setAppearance(new Appearance()
                      .setMaterial(new Material().setDiffuseColor(.9,.9,.9).setShininess(1)))
                    .setGeometry(new Box().setSize(.5,.5,.01))))
                .addChild(new Transform("NetTransformStbd")
                  .addChild(new Shape()
                    .setAppearance(new Appearance()
                      .setMaterial(new Material().setDiffuseColor(1.0,0.0,0.0).setShininess(1)))
                    .setGeometry(new Cylinder().setHeight(1.4).setRadius(.12)))
                  .addChild(new Transform("NettingTransformStbd").setRotation(0.0,1.0,0.0,1.57).setScale(.01,.01,.01).setTranslation(0.0,0.0,-1.0)
                    .addChild(new Shape("NETTING")
                      .setAppearance(new Appearance()
                        .setMaterial(new Material())
                        .setTexture(new ImageTexture("grill").setUrl(new String[] {"grill.png","../../Weapons/Guns/grill.png","../../../Weapons/Guns/grill.png","https://www.web3d.org/x3d/content/examples/Vrml2Sourcebook/Chapter18-TextureMapping/grill.png"}))
                        .setTextureTransform(new TextureTransform().setCenter(0.5,0.5).setScale(32.0,8.0)))
                      .setGeometry(new IndexedFaceSet("Screen").setDEF("Screen").setSolid(false).setCoordIndex(new int[] {0,1,2,3}).setTexCoordIndex(new int[] {0,1,2,3})
                        .setCoord(new Coordinate().setPoint(new MFVec3f(new double[] {-1.0,-.4,0.1,1.0,-.4,0.1,1.0,.4,.1,-1.0,.4,.1})))
                        .setTexCoord(new TextureCoordinate().setPoint(new MFVec2f(new double[] {0.0,0.0,1.0,0.0,1.0,1.0,0.0,1.0})))))))))
            .addChild(new Transform().setTranslation(-.2,-.75,0.0)
              .addChild(new Shape()
                .setGeometry(new Box().setSize(1.5,.2,1.5))
                .setAppearance(new Appearance()
                  .setMaterial(new Material().setDiffuseColor(.4,.4,.4).setShininess(1))))))
          .addChild(new ROUTE().setFromNode("NetPositClock").setFromField("fraction_changed").setToNode("NetPositInterp").setToField("set_fraction"))
          .addChild(new ROUTE().setFromNode("NetPositClock").setFromField("fraction_changed").setToNode("NetOrientInterp").setToField("set_fraction"))
          .addChild(new ROUTE().setFromNode("NetPositClock").setFromField("fraction_changed").setToNode("NetPositScale").setToField("set_fraction"))
          .addChild(new ROUTE().setFromNode("NetPositClock").setFromField("fraction_changed").setToNode("NettingScale").setToField("set_fraction"))
          .addChild(new ROUTE().setFromNode("NetPositClockStbd").setFromField("fraction_changed").setToNode("NetPositScaleStbd").setToField("set_fraction"))
          .addChild(new ROUTE().setFromNode("NetPositClockStbd").setFromField("fraction_changed").setToNode("NetPositInterpStbd").setToField("set_fraction"))
          .addChild(new ROUTE().setFromNode("NetPositClockStbd").setFromField("fraction_changed").setToNode("NetOrientInterpStbd").setToField("set_fraction"))
          .addChild(new ROUTE().setFromNode("NetPositClockStbd").setFromField("fraction_changed").setToNode("NettingScaleStbd").setToField("set_fraction"))
          .addChild(new ROUTE().setFromNode("NetPositInterp").setFromField("value_changed").setToNode("NetTransform").setToField("set_translation"))
          .addChild(new ROUTE().setFromNode("NetOrientInterp").setFromField("value_changed").setToNode("NetTransform").setToField("set_rotation"))
          .addChild(new ROUTE().setFromNode("NetPositScale").setFromField("value_changed").setToNode("NetTransform").setToField("scale"))
          .addChild(new ROUTE().setFromNode("NettingScale").setFromField("value_changed").setToNode("NettingTransform").setToField("set_scale"))
          .addChild(new ROUTE().setFromNode("NettingScaleStbd").setFromField("value_changed").setToNode("NettingTransformStbd").setToField("set_scale"))
          .addChild(new ROUTE().setFromNode("NetPositInterpStbd").setFromField("value_changed").setToNode("NetTransformStbd").setToField("set_translation"))
          .addChild(new ROUTE().setFromNode("NetOrientInterpStbd").setFromField("value_changed").setToNode("NetTransformStbd").setToField("set_rotation"))
          .addChild(new ROUTE().setFromNode("NetPositScaleStbd").setFromField("value_changed").setToNode("NetTransformStbd").setToField("scale")))))
    .addChild(new ProtoInstance("NetLauncher", "myLauncher").setContainerField("children"))
    .addChild(new TouchSensor("myTouch").setDescription("touch to activate"))
    .addChild(new ROUTE().setFromNode("myTouch").setFromField("touchTime").setToNode("myLauncher").setToField("startLaunchToStbd"))
    .addChild(new Transform().setTranslation(0.0,-1.0,0.0)
      .addChild(new Shape("TestWater")
        .setAppearance(new Appearance()
          .setMaterial(new Material().setDiffuseColor(0.0,0.0,1.0)))
        .setGeometry(new Box().setSize(150.0,.1,150.0))))
    .addChild(new Transform().setRotation(1.0,0.0,0.0,.78)
      .addChild(new Transform("FinalNetTransform").setScale(.01,.01,.01)
        .addChild(new Shape()
          .setAppearance(new Appearance()
            .setMaterial(new Material().setDiffuseColor(1.0,0.0,0.0).setShininess(1)))
          .setGeometry(new Cylinder().setHeight(1.4).setRadius(.12)))
        .addChild(new Transform("FinalNettingTransform").setRotation(0.0,1.0,0.0,1.57).setScale(.01,.01,.01).setTranslation(0.0,0.0,1.0)
          .addComments(" note can't DEF/USE nodes from within ProtoDeclare to parent scene ")
          .addChild(new Shape("FinalNETTING")
            .setAppearance(new Appearance()
              .setMaterial(new Material())
              .setTexture(new ImageTexture().setUrl(new String[] {"grill.png","../../../Weapons/Guns/grill.png","../../Weapons/Guns/grill.png","https://www.web3d.org/x3d/content/examples/Vrml2Sourcebook/Chapter18-TextureMapping/grill.png"}))
              .setTextureTransform(new TextureTransform().setCenter(0.5,0.5).setScale(32.0,8.0)))
            .setGeometry(new IndexedFaceSet("FinalScreen").setDEF("FinalScreen").setSolid(false).setCoordIndex(new int[] {0,1,2,3}).setTexCoordIndex(new int[] {0,1,2,3})
              .setCoord(new Coordinate().setPoint(new MFVec3f(new double[] {-1.0,-.4,0.1,1.0,-.4,0.1,1.0,.4,.1,-1.0,.4,.1})))
              .setTexCoord(new TextureCoordinate().setPoint(new MFVec2f(new double[] {0.0,0.0,1.0,0.0,1.0,1.0,0.0,1.0}))))))))
    .addChild(new ROUTE().setFromNode("myLauncher").setFromField("netTranslation").setToNode("FinalNetTransform").setToField("set_translation"))
    .addChild(new ROUTE().setFromNode("myLauncher").setFromField("netScale").setToNode("FinalNetTransform").setToField("set_scale"))
    .addChild(new ROUTE().setFromNode("myLauncher").setFromField("nettingScale").setToNode("FinalNettingTransform").setToField("set_scale"))
    .addChild(new ROUTE().setFromNode("myLauncher").setFromField("netOrientation").setToNode("FinalNetTransform").setToField("set_rotation")));
            }
            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 
	 * <a href="https://dzone.com/articles/java-copy-shallow-vs-deep-in-which-you-will-swim" target="_blank">shallow copy</a>
	 * of the X3D model.
	 * @see <a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/Core/X3D.html">X3D</a>
	 * @return NonLethalNetLauncherPrototype 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 <a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/Core/X3D.html#handleArguments-java.lang.String:A-">X3D.handleArguments(args)</a>
     * @see <a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/Core/X3D.html#validationReport--">X3D.validationReport()</a>
     * @see <a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/CommandLine.html">CommandLine</a>
     * @see <a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/CommandLine.html#USAGE">CommandLine.USAGE</a>
     * @see <a href="https://www.web3d.org/specifications/java/javadoc/org/web3d/x3d/jsail/ConfigurationProperties.html">ConfigurationProperties</a>
     */
    public static void main(String args[])
    {
        System.out.println("Build this X3D model, showing validation diagnostics...");
        X3D thisExampleX3dModel = new NonLethalNetLauncherPrototype().getX3dModel();
//      System.out.println("X3D model construction complete.");
	
        // next handle command line arguments
        boolean hasArguments = (args != null) && (args.length > 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: \"Savage.Weapons.Guns.NonLethalNetLauncherPrototype\" 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("Savage.Weapons.Guns.NonLethalNetLauncherPrototype self-validation test confirmation: ");
                if (!validationResults.equals("success"))
                    System.out.println();
                System.out.println(validationResults.trim());

                // experimental: test X3DJSAIL output files
                // Weapons/Guns/NonLethalNetLauncherPrototype_JavaExport.* file validation is checked when building X3D Example Archives
                String filenameX3D  = "Weapons/Guns/NonLethalNetLauncherPrototype_JavaExport.x3d"; 
                String filenameX3DV = "Weapons/Guns/NonLethalNetLauncherPrototype_JavaExport.x3dv"; 
                String filenameJSON = "Weapons/Guns/NonLethalNetLauncherPrototype_JavaExport.json";
                thisExampleX3dModel.toFileX3D        (filenameX3D);
                thisExampleX3dModel.toFileClassicVRML(filenameX3DV);
// TODO         thisExampleX3dModel.toFileJSON       (filenameJSON);
        }
    }
}
