package Savage.Tools.Animation;

import org.web3d.x3d.jsail.Core.*;
import org.web3d.x3d.jsail.EventUtilities.*;
import org.web3d.x3d.jsail.fields.*;
import org.web3d.x3d.jsail.Geometry3D.*;
import org.web3d.x3d.jsail.Grouping.*;
import org.web3d.x3d.jsail.Navigation.*;
import org.web3d.x3d.jsail.PointingDeviceSensor.*;
import org.web3d.x3d.jsail.Scripting.*;
import org.web3d.x3d.jsail.Shape.*;
import org.web3d.x3d.jsail.Text.*;
import org.web3d.x3d.jsail.Time.*;

// Javadoc metadata annotations follow, see below for X3DJSAIL Java source code.
/**
 * <p> Example for toggle-able Material node that can choose among an array of material nodes, and is switchable at run time. </p>
 <p> Related links: Catalog page <a href="../../../../Tools/Animation/MaterialChoiceExampleIndex.html" target="_blank">MaterialChoiceExample</a>,  source <a href="../../../../Tools/Animation/MaterialChoiceExample.java">MaterialChoiceExample.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="../../../../Tools/Animation/MaterialChoiceExample.x3d">MaterialChoiceExample.x3d</a> </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> description </i> </td>
			<td> Example for toggle-able Material node that can choose among an array of material nodes, and is switchable at run time. </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> creator </i> </td>
			<td> Don Brutzman and MV4205 class </td>
		</tr>
		<tr>
			<td style="text-align:right; vertical-align: text-top;"> <i> created </i> </td>
			<td> 2 May 2004 </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> reference </i> </td>
			<td> <a href="../../../../Tools/Animation/MaterialChoicePrototype.x3d">MaterialChoicePrototype.x3d</a> </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/Tools/Animation/MaterialChoiceExample.x3d" target="_blank">https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/MaterialChoiceExample.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="../../../../Tools/Animation/../../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 Don Brutzman and MV4205 class
 */

public class MaterialChoiceExample
{
	/** Default constructor to create this object. */
	public MaterialChoiceExample ()
	{
	  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("MaterialChoiceExample.x3d"))
    .addMeta(new meta().setName(meta.NAME_DESCRIPTION).setContent("Example for toggle-able Material node that can choose among an array of material nodes, and is switchable at run time."))
    .addMeta(new meta().setName(meta.NAME_CREATOR    ).setContent("Don Brutzman and MV4205 class"))
    .addMeta(new meta().setName(meta.NAME_CREATED    ).setContent("2 May 2004"))
    .addMeta(new meta().setName(meta.NAME_MODIFIED   ).setContent("28 November 2019"))
    .addMeta(new meta().setName(meta.NAME_REFERENCE  ).setContent("MaterialChoicePrototype.x3d"))
    .addMeta(new meta().setName(meta.NAME_IDENTIFIER ).setContent("https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/MaterialChoiceExample.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("MaterialChoiceExample.x3d"))
    .addChild(new ExternProtoDeclare("MaterialChoice").setName("MaterialChoice").setUrl(new String[] {"MaterialChoicePrototype.x3d#MaterialChoice","https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/MaterialChoicePrototype.x3d#MaterialChoice","MaterialChoicePrototype.wrl#MaterialChoice","https://www.web3d.org/x3d/content/examples/Savage/Tools/Animation/MaterialChoicePrototype.wrl#MaterialChoice"})
      .addField(new field().setName("set_index").setType(field.TYPE_SFINT32).setAccessType(field.ACCESSTYPE_INPUTONLY))
      .addField(new field().setName("index").setType(field.TYPE_SFINT32).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setAppinfo("which Material node is chosen, with array index starting at 0"))
      .addField(new field().setName("index_changed").setType(field.TYPE_SFINT32).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
      .addField(new field().setName("set_fraction").setType(field.TYPE_SFFLOAT).setAccessType(field.ACCESSTYPE_INPUTONLY))
      .addField(new field().setName("fraction").setType(field.TYPE_SFFLOAT).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setAppinfo("fraction to interpolate between current and next Material node (if any) across all field values."))
      .addField(new field().setName("next").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INPUTONLY))
      .addField(new field().setName("previous").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INPUTONLY))
      .addField(new field().setName("materials").setType(field.TYPE_MFNODE).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setAppinfo("array of available Material nodes defaults to zeroth Material"))
      .addField(new field().setName("appendMaterial").setType(field.TYPE_SFNODE).setAccessType(field.ACCESSTYPE_INPUTONLY).setAppinfo("append another Material node to materials array"))
      .addField(new field().setName("deleteMaterial").setType(field.TYPE_SFINT32).setAccessType(field.ACCESSTYPE_INPUTONLY).setAppinfo("delete Material node indicated by input index value"))
      .addField(new field().setName("deleteAllMaterials").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INPUTONLY).setAppinfo("deletes all Material nodes resets scene to default Material values defined in X3D Specification")))
    .addComments(" ==================== ")
    .addChild(new Viewpoint().setDescription("MaterialChoice index is sequenced to change selected Material value").setPosition(0.0,0.0,6.0))
    .addChild(new Transform("RotateBox").setRotation(1.0,0.0,0.0,0.79)
      .addChild(new Transform().setRotation(0.0,1.0,0.0,0.79)
        .addChild(new Shape()
          .setGeometry(new Box())
          .setAppearance(new Appearance()
            .setMaterial(new ProtoInstance("MaterialChoice", "MC").setContainerField("material")
              .addFieldValue(new fieldValue().setName("index").setValue(0))
              .addFieldValue(new fieldValue().setName("fraction").setValue(0.0))
              .addFieldValue(new fieldValue().setName("materials")
                .addChild(new Material().setAmbientIntensity(0.24).setDiffuseColor(1.0,0.452381,0.40339).setShininess(0.9).setSpecularColor(0.686486,0.396903,0.419275)
                  .addComments(" Universal Media Library: ArtDeco 3 "))
                .addChild(new Material().setAmbientIntensity(0.24).setDiffuseColor(0.330519,0.3389,0.6).setShininess(0.78).setSpecularColor(0.290909,0.290909,0.290909)
                  .addComments(" Universal Media Library: ArtDeco 8 "))
                .addChild(new Material().setAmbientIntensity(0.25).setDiffuseColor(0.0,0.251004,0.239248).setShininess(0.06).setSpecularColor(0.177935,0.249369,0.229278)
                  .addComments(" Universal Media Library: ArtDeco 19 "))))))))
    .addComments(" other tests ")
    .addChild(new Group("AnimationGroup")
      .addComments(" Animate the MaterialChoice automatically ")
      .addChild(new TimeSensor("Clock").setCycleInterval(2).setEnabled(false).setLoop(true))
      .addChild(new BooleanTrigger("TriggerNext"))
      .addChild(new ROUTE().setFromNode("Clock").setFromField("cycleTime").setToNode("TriggerNext").setToField("set_triggerTime"))
      .addChild(new ROUTE().setFromNode("TriggerNext").setFromField("triggerTrue").setToNode("MC").setToField("next"))
      .addComments(" iff another action starts (i.e. touch true), then negate value and stop clock ")
      .addChild(new BooleanFilter("ClockStopper"))
      .addChild(new BooleanFilter("ClockStopperFilter"))
      .addChild(new ROUTE().setFromNode("ClockStopper").setFromField("inputTrue").setToNode("ClockStopperFilter").setToField("set_boolean"))
      .addChild(new ROUTE().setFromNode("ClockStopperFilter").setFromField("inputNegate").setToNode("Clock").setToField("enabled")))
    .addChild(new Transform("TestNext").setTranslation(-2.5,2.0,0.0)
      .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
        .addChild(new Shape()
          .setGeometry(new Text().setString(new String[] {"next"})
            .setFontStyle(new FontStyle("FS").setSize(0.6)))
          .setAppearance(new Appearance()
            .setMaterial(new Material().setDiffuseColor(0.0,0.9,0.0))))
        .addChild(new TouchSensor("TouchNext").setDescription("touch for next Material"))
        .addChild(new ROUTE().setFromNode("TouchNext").setFromField("isActive").setToNode("ClockStopper").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchNext").setFromField("isActive").setToNode("MC").setToField("next"))))
    .addChild(new Transform("TestPrevious").setTranslation(1.0,2.0,0.0)
      .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
        .addChild(new Shape()
          .setGeometry(new Text().setString(new String[] {"previous"})
            .setFontStyle(new FontStyle().setUSE("FS")))
          .setAppearance(new Appearance()
            .setMaterial(new Material().setDiffuseColor(0.9,0.0,0.0))))
        .addChild(new TouchSensor("TouchPrevious").setDescription("touch for previous Material"))
        .addChild(new ROUTE().setFromNode("TouchPrevious").setFromField("isActive").setToNode("ClockStopper").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchPrevious").setFromField("isActive").setToNode("MC").setToField("previous"))))
    .addChild(new Transform("TestLoop").setTranslation(-3.0,-2.0,0.0)
      .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
        .addChild(new Shape()
          .setGeometry(new Text().setString(new String[] {"loop"})
            .setFontStyle(new FontStyle().setUSE("FS")))
          .setAppearance(new Appearance()
            .setMaterial(new Material().setDiffuseColor(0.0,0.0,0.9))))
        .addChild(new TouchSensor("TouchLoop").setDescription("touch to loop through Materials"))
        .addChild(new BooleanToggle("ToggleLoop"))
        .addChild(new ROUTE().setFromNode("TouchLoop").setFromField("isActive").setToNode("ToggleLoop").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("ToggleLoop").setFromField("toggle_changed").setToNode("Clock").setToField("enabled"))))
    .addChild(new Transform("TestAppend").setTranslation(1.0,-2.0,0.0)
      .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
        .addChild(new Shape()
          .setGeometry(new Text().setString(new String[] {"append"})
            .setFontStyle(new FontStyle().setUSE("FS")))
          .setAppearance(new Appearance()
            .setMaterial(new Material().setDiffuseColor(0.6,0.6,0.0))))
        .addChild(new TouchSensor("TouchAppend").setDescription("touch to add a new Material"))
        .addChild(new Script("AddNewMaterialScript").setDirectOutput(true).setSourceCode("""
ecmascript:

function initialize ()
{
	if (traceEnabled) Browser.println ('[ MaterialChoiceExample ] AddNewMaterialScript.initialize()');
}

function generateAndAppendMaterial(trigger, timestamp)
{
   if (trigger == true)
   {
	if (traceEnabled) Browser.println ('[MaterialChoiceExample AddNewMaterialScript] generateAndAppendMaterial(' + trigger + ')');
	newColor = new SFColor (Math.random(), Math.random(), Math.random());
	defaultMaterial.diffuseColor = newColor;
	newMaterial = defaultMaterial;
	if (traceEnabled) Browser.println ('[ MaterialChoiceExample AddNewMaterialScript] append Material with diffuseColor (' + newColor + ')');
   }
}
""")
          .addField(new field().setName("generateAndAppendMaterial").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INPUTONLY))
          .addField(new field().setName("newMaterial").setType(field.TYPE_SFNODE).setAccessType(field.ACCESSTYPE_OUTPUTONLY))
          .addField(new field().setName("defaultMaterial").setType(field.TYPE_SFNODE).setAccessType(field.ACCESSTYPE_INITIALIZEONLY)
            .addChild(new Material()))
          .addField(new field().setName("traceEnabled").setType(field.TYPE_SFBOOL).setAccessType(field.ACCESSTYPE_INITIALIZEONLY).setValue(false)))
        .addChild(new ROUTE().setFromNode("TouchAppend").setFromField("isActive").setToNode("ClockStopper").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchAppend").setFromField("isActive").setToNode("AddNewMaterialScript").setToField("generateAndAppendMaterial"))
        .addChild(new ROUTE().setFromNode("AddNewMaterialScript").setFromField("newMaterial").setToNode("MC").setToField("appendMaterial"))))
    .addChild(new Transform("TestDeleteOne").setTranslation(-3.0,0.0,0.0)
      .addChild(new Transform()
        .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
          .addChild(new Shape()
            .setGeometry(new Text().setString(new String[] {"delete"})
              .setFontStyle(new FontStyle().setUSE("FS")))
            .setAppearance(new Appearance()
              .setMaterial(new Material())))))
      .addChild(new Transform("TestDelete0").setTranslation(0.0,-0.5,0.0)
        .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
          .addChild(new Shape()
            .setGeometry(new Text().setString(new String[] {"0"})
              .setFontStyle(new FontStyle().setUSE("FS")))
            .setAppearance(new Appearance()
              .setMaterial(new Material()))))
        .addChild(new TouchSensor("TouchDelete0").setDescription("touch to delete Material[0]"))
        .addChild(new IntegerTrigger("TouchDelete0Trigger").setIntegerKey(0))
        .addChild(new ROUTE().setFromNode("TouchDelete0").setFromField("isActive").setToNode("ClockStopper").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchDelete0").setFromField("isActive").setToNode("TouchDelete0Trigger").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchDelete0Trigger").setFromField("triggerValue").setToNode("MC").setToField("deleteMaterial")))
      .addChild(new Transform("TestDelete1").setTranslation(0.5,-0.5,0.0)
        .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
          .addChild(new Shape()
            .setGeometry(new Text().setString(new String[] {"1"})
              .setFontStyle(new FontStyle().setUSE("FS")))
            .setAppearance(new Appearance()
              .setMaterial(new Material()))))
        .addChild(new TouchSensor("TouchDelete2").setDescription("touch to delete Material[1]"))
        .addChild(new IntegerTrigger("TouchDelete2Trigger").setIntegerKey(1))
        .addChild(new ROUTE().setFromNode("TouchDelete2").setFromField("isActive").setToNode("ClockStopper").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchDelete2").setFromField("isActive").setToNode("TouchDelete2Trigger").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchDelete2Trigger").setFromField("triggerValue").setToNode("MC").setToField("deleteMaterial")))
      .addChild(new Transform("TestDelete2").setTranslation(1.0,-0.5,0.0)
        .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
          .addChild(new Shape()
            .setGeometry(new Text().setString(new String[] {"2"})
              .setFontStyle(new FontStyle().setUSE("FS")))
            .setAppearance(new Appearance()
              .setMaterial(new Material()))))
        .addChild(new TouchSensor("TouchDelete1").setDescription("touch to delete Material[2]"))
        .addChild(new IntegerTrigger("TouchDelete1Trigger").setIntegerKey(1))
        .addChild(new ROUTE().setFromNode("TouchDelete1").setFromField("isActive").setToNode("ClockStopper").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchDelete1").setFromField("isActive").setToNode("TouchDelete1Trigger").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchDelete1Trigger").setFromField("triggerValue").setToNode("MC").setToField("deleteMaterial"))))
    .addChild(new Transform("TestDeleteAll").setTranslation(1.8,0.0,0.0)
      .addChild(new Billboard().setAxisOfRotation(0.0,0.0,0.0)
        .addChild(new Shape()
          .setGeometry(new Text().setString(new String[] {"delete"," all"})
            .setFontStyle(new FontStyle().setUSE("FS")))
          .setAppearance(new Appearance()
            .setMaterial(new Material())))
        .addChild(new TouchSensor("TouchDeleteAll").setDescription("touch to delete all Materials"))
        .addChild(new ROUTE().setFromNode("TouchDeleteAll").setFromField("isActive").setToNode("ClockStopper").setToField("set_boolean"))
        .addChild(new ROUTE().setFromNode("TouchDeleteAll").setFromField("isActive").setToNode("MC").setToField("deleteAllMaterials")))));
            }
            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 MaterialChoiceExample 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 MaterialChoiceExample().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.Tools.Animation.MaterialChoiceExample\" 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.Tools.Animation.MaterialChoiceExample self-validation test confirmation: ");
                if (!validationResults.equals("success"))
                    System.out.println();
                System.out.println(validationResults.trim());

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