package X3dForAdvancedModeling.Animation;
import org.web3d.x3d.jsail.Core.*;
import org.web3d.x3d.jsail.EnvironmentalEffects.*;
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.Interpolation.*;
import org.web3d.x3d.jsail.Navigation.*;
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> Demonstrate simple Switch animation by sequencing through a set of Box nodes that are each covered by a different ImageTexture. </p>
<p> Related links: Catalog page <a href="../../../Animation/BoxSwitchIndex.html" target="_blank">BoxSwitch</a>, source <a href="../../../Animation/BoxSwitch.java">BoxSwitch.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;"> Document Metadata </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> title </i> </td>
<td> <a href="../../../Animation/BoxSwitch.x3d">BoxSwitch.x3d</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> creator </i> </td>
<td> Don Brutzman </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> created </i> </td>
<td> 30 December 2015 </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> modified </i> </td>
<td> 14 July 2025 </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> description </i> </td>
<td> Demonstrate simple Switch animation by sequencing through a set of Box nodes that are each covered by a different ImageTexture. </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> Image </i> </td>
<td> <a href="../../../Animation/CubeWithLabeledSidesViewpointSequencer.png">CubeWithLabeledSidesViewpointSequencer.png</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> MovingImage </i> </td>
<td> <a href="../../../Animation/BoxSwitch.mp4">BoxSwitch.mp4</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> reference </i> </td>
<td> <a href="../../../Animation/CubeWithLabeledSides.x3d">CubeWithLabeledSides.x3d</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> drawing </i> </td>
<td> <a href="../../../Animation/images/CubeSideImages.pdf">images/CubeSideImages.pdf</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> drawing </i> </td>
<td> <a href="../../../Animation/images/CubeSideImages.vsd">images/CubeSideImages.vsd</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/X3dForAdvancedModeling/Animation/BoxSwitch.x3d" target="_blank">https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Animation/BoxSwitch.x3d</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> generator </i> </td>
<td> X3D-Edit 4.0, <a href="https://savage.nps.edu/X3D-Edit" target="_blank">https://savage.nps.edu/X3D-Edit</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> license </i> </td>
<td> <a href="../../../Animation/../license.html">../license.html</a> </td>
</tr>
<tr style="background-color:silver; border-color:silver;">
<td style="text-align:center;" colspan="2"> </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
*/
public class BoxSwitch
{
/** Default constructor to create this object. */
public BoxSwitch ()
{
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()
.addMeta(new meta().setName(meta.NAME_TITLE ).setContent("BoxSwitch.x3d"))
.addMeta(new meta().setName(meta.NAME_CREATOR ).setContent("Don Brutzman"))
.addMeta(new meta().setName(meta.NAME_CREATED ).setContent("30 December 2015"))
.addMeta(new meta().setName(meta.NAME_MODIFIED ).setContent("14 July 2025"))
.addMeta(new meta().setName(meta.NAME_DESCRIPTION).setContent("Demonstrate simple Switch animation by sequencing through a set of Box nodes that are each covered by a different ImageTexture."))
.addMeta(new meta().setName(meta.NAME_IMAGE ).setContent("CubeWithLabeledSidesViewpointSequencer.png"))
.addMeta(new meta().setName(meta.NAME_MOVINGIMAGE).setContent("BoxSwitch.mp4"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("CubeWithLabeledSides.x3d"))
.addMeta(new meta().setName(meta.NAME_DRAWING ).setContent("images/CubeSideImages.pdf"))
.addMeta(new meta().setName(meta.NAME_DRAWING ).setContent("images/CubeSideImages.vsd"))
.addMeta(new meta().setName(meta.NAME_IDENTIFIER ).setContent("https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Animation/BoxSwitch.x3d"))
.addMeta(new meta().setName(meta.NAME_GENERATOR ).setContent("X3D-Edit 4.0, https://savage.nps.edu/X3D-Edit"))
.addMeta(new meta().setName(meta.NAME_LICENSE ).setContent("../license.html")))
.setScene(new Scene()
.addChild(new WorldInfo().setTitle("BoxSwitch.x3d"))
.addChild(new Background().setSkyColor(new MFColor(new double[] {0.8,0.8,0.9})))
.addChild(new NavigationInfo())
.addChild(new Switch("BoxSwitcher").setWhichChoice(-1)
.addChild(new Shape()
.setGeometry(new Box("UnitBox"))
.setAppearance(new Appearance()
.setTexture(new ImageTexture().setUrl(new String[] {"images/RedImage.png","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/GeometricShapes/images/RedImage.png"}))))
.addChild(new Shape()
.setGeometry(new Box().setUSE("UnitBox"))
.setAppearance(new Appearance()
.setTexture(new ImageTexture().setUrl(new String[] {"images/GreenImage.png","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/GeometricShapes/images/GreenImage.png"}))))
.addChild(new Shape()
.setGeometry(new Box().setUSE("UnitBox"))
.setAppearance(new Appearance()
.setTexture(new ImageTexture().setUrl(new String[] {"images/TurquoiseImage.png","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/GeometricShapes/images/TurquoiseImage.png"}))))
.addChild(new Shape()
.setGeometry(new Box().setUSE("UnitBox"))
.setAppearance(new Appearance()
.setTexture(new ImageTexture().setUrl(new String[] {"images/YellowImage.png","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/GeometricShapes/images/YellowImage.png"}))))
.addChild(new Shape()
.setGeometry(new Box().setUSE("UnitBox"))
.setAppearance(new Appearance()
.setTexture(new ImageTexture().setUrl(new String[] {"images/WhiteImage.png","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/GeometricShapes/images/WhiteImage.png"}))))
.addChild(new Shape()
.setGeometry(new Box().setUSE("UnitBox"))
.setAppearance(new Appearance()
.setTexture(new ImageTexture().setUrl(new String[] {"images/GreyImage.png","https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/GeometricShapes/images/GreyImage.png"})))))
.addComments(" Animated Box ")
.addChild(new TimeSensor("Clock").setCycleInterval(12).setLoop(true))
.addChild(new IntegerSequencer("Sequencer").setKey(new double[] {0.0,0.1667,0.3333,0.5,0.6667,0.8333,1.0}).setKeyValue(new int[] {0,1,2,3,4,5,0}))
.addChild(new ROUTE().setFromNode("Clock").setFromField("fraction_changed").setToNode("Sequencer").setToField("set_fraction"))
.addChild(new ROUTE().setFromNode("Sequencer").setFromField("value_changed").setToNode("BoxSwitcher").setToField("whichChoice"))
.addChild(new Viewpoint("OrbitingView").setDescription("Orbiting view").setOrientation(0.0,1.0,0.0,-1.57).setPosition(-8.0,0.0,0.0))
.addComments(" Animated Viewpoint, orbiting about the origin ")
.addChild(new PositionInterpolator("CircularPathPositionInterpolator").setKey(new double[] {0.0,0.02778,0.05556,0.08333,0.11111,0.13889,0.16667,0.19444,0.22222,0.25,0.27778,0.30556,0.33333,0.36111,0.38889,0.41667,0.44444,0.47222,0.5,0.52778,0.55556,0.58333,0.61111,0.63889,0.66667,0.69444,0.72222,0.75,0.77778,0.80556,0.83333,0.86111,0.88889,0.91667,0.94444,0.97222,1.0}).setKeyValue(new MFVec3f(new double[] {0.0,0.0,8.0,1.389,0.0,7.878,2.736,0.0,7.518,4.0,0.0,6.928,5.142,0.0,6.128,6.128,0.0,5.142,6.928,0.0,4.0,7.518,0.0,2.736,7.878,0.0,1.389,8.0,0.0,0.0,7.878,0.0,-1.389,7.518,0.0,-2.736,6.928,0.0,-4.0,6.128,0.0,-5.142,5.142,0.0,-6.128,4.0,0.0,-6.928,2.736,0.0,-7.518,1.389,0.0,-7.878,0.0,0.0,-8.0,-1.389,0.0,-7.878,-2.736,0.0,-7.518,-4.0,0.0,-6.928,-5.142,0.0,-6.128,-6.128,0.0,-5.142,-6.928,0.0,-4.0,-7.518,0.0,-2.736,-7.878,0.0,-1.389,-8.0,0.0,-0.0,-7.878,0.0,1.389,-7.518,0.0,2.736,-6.928,0.0,4.0,-6.128,0.0,5.142,-5.142,0.0,6.128,-4.0,0.0,6.928,-2.736,0.0,7.518,-1.389,0.0,7.878,0.0,0.0,8.0})))
.addChild(new ROUTE().setFromNode("Clock").setFromField("fraction_changed").setToNode("CircularPathPositionInterpolator").setToField("set_fraction"))
.addChild(new ROUTE().setFromNode("CircularPathPositionInterpolator").setFromField("value_changed").setToNode("OrbitingView").setToField("position"))
.addChild(new OrientationInterpolator("CenterFacingOrientationInterpolator").setKey(new double[] {0.0,0.3333,0.6667,1.0}).setKeyValue(new MFRotation(new double[] {0.0,1.0,0.0,0.0,0.0,1.0,0.0,2.094395,0.0,1.0,0.0,4.18879,0.0,1.0,0.0,0.0})))
.addChild(new ROUTE().setFromNode("Clock").setFromField("fraction_changed").setToNode("CenterFacingOrientationInterpolator").setToField("set_fraction"))
.addChild(new ROUTE().setFromNode("CenterFacingOrientationInterpolator").setFromField("value_changed").setToNode("OrbitingView").setToField("orientation"))
.addComments(" Additional Viewpoints ")
.addChild(new Viewpoint().setDescription("Front view").setOrientation(0.0,1.0,0.0,1.57).setPosition(8.0,0.0,0.0))
.addChild(new Viewpoint().setDescription("Back view").setOrientation(0.0,1.0,0.0,-1.57).setPosition(-8.0,0.0,0.0))
.addChild(new Viewpoint().setDescription("Left view").setPosition(0.0,0.0,8.0))
.addChild(new Viewpoint().setDescription("Right view").setOrientation(0.0,1.0,0.0,3.1416).setPosition(0.0,0.0,-8.0))
.addChild(new Viewpoint().setDescription("Top view").setOrientation(1.0,0.0,0.0,-1.57).setPosition(0.0,8.0,0.0))
.addChild(new Viewpoint().setDescription("Bottom view").setOrientation(1.0,0.0,0.0,1.57).setPosition(0.0,-8.0,0.0)));
}
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 BoxSwitch 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 BoxSwitch().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: \"X3dForAdvancedModeling.Animation.BoxSwitch\" 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("X3dForAdvancedModeling.Animation.BoxSwitch self-validation test confirmation: ");
if (!validationResults.equals("success"))
System.out.println();
System.out.println(validationResults.trim());
// experimental: test X3DJSAIL output files
// Animation/BoxSwitch_JavaExport.* file validation is checked when building X3D Example Archives
String filenameX3D = "Animation/BoxSwitch_JavaExport.x3d";
String filenameX3DV = "Animation/BoxSwitch_JavaExport.x3dv";
String filenameJSON = "Animation/BoxSwitch_JavaExport.json";
thisExampleX3dModel.toFileX3D (filenameX3D);
thisExampleX3dModel.toFileClassicVRML(filenameX3DV);
// TODO thisExampleX3dModel.toFileJSON (filenameJSON);
}
}
}