package X3dForAdvancedModeling.Scanning;
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.Navigation.*;
import org.web3d.x3d.jsail.Rendering.*;
import org.web3d.x3d.jsail.Shape.*;
import org.web3d.x3d.jsail.Text.*;
// Javadoc metadata annotations follow, see below for X3DJSAIL Java source code.
/**
* <p> Candidate design pattern for 3D scanner outputs to consistently define the elements of an X3D mesh. </p>
<p> Related links: Catalog page <a href="../../../Scanning/X3dMeshDesignPatternIndex.html" target="_blank">X3dMeshDesignPattern</a>, source <a href="../../../Scanning/X3dMeshDesignPattern.java">X3dMeshDesignPattern.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="../../../Scanning/X3dMeshDesignPattern.x3d">X3dMeshDesignPattern.x3d</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> description </i> </td>
<td> Candidate design pattern for 3D scanner outputs to consistently define the elements of an X3D mesh. </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> creator </i> </td>
<td> Don Brutzman, Vince Marchetti, Roy Walmsley, Nicholas Polys </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> created </i> </td>
<td> 4 June 2017 </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> modified </i> </td>
<td> 13 October 2023 </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> TODO </i> </td>
<td> Upgrade and verify X3D v4.0 XML DTD and Schema to validate </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> reference </i> </td>
<td> X3dMeshDesignPattern.txt </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> Image </i> </td>
<td> <a href="../../../Scanning/X3dMeshDesignPattern.png">X3dMeshDesignPattern.png</a> </td>
</tr>
<tr style="color:burntorange">
<td style="text-align:right; vertical-align: text-top;"> <i> warning </i> </td>
<td> Under development. Note that proposed design pattern for Normal inside PointSet or LineSet/IndexedLineSet is accepted in X3D 4.0 but is not allowed in X3D v3.3. </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> reference </i> </td>
<td> Web3D 2017 Workshop on 3D Scanning: Use Cases, Workflow and Profile Requirements for X3D </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> reference </i> </td>
<td> <a href="http://web3d2017.web3d.org/program" target="_blank">http://web3d2017.web3d.org/program</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> identifier </i> </td>
<td> <a href="https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Scanning/X3dMeshDesignPattern.x3d" target="_blank">https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Scanning/X3dMeshDesignPattern.x3d</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> license </i> </td>
<td> <a href="../../../Scanning/../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, Vince Marchetti, Roy Walmsley, Nicholas Polys
*/
public class X3dMeshDesignPattern
{
/** Default constructor to create this object. */
public X3dMeshDesignPattern ()
{
initialize();
}
/** Create and initialize the X3D model for this object. */
public final void initialize()
{
try { // catch-all
x3dModel = new X3D().setProfile(X3D.PROFILE_INTERCHANGE).setVersion(X3D.VERSION_4_0)
.setHead(new head()
.addComponent(new component().setName("Text").setLevel(1))
.addComponent(new component().setName("Grouping").setLevel(2))
.addComponent(new component().setName("Navigation").setLevel(3))
.addMeta(new meta().setName(meta.NAME_TITLE ).setContent("X3dMeshDesignPattern.x3d"))
.addMeta(new meta().setName(meta.NAME_DESCRIPTION).setContent("Candidate design pattern for 3D scanner outputs to consistently define the elements of an X3D mesh."))
.addMeta(new meta().setName(meta.NAME_CREATOR ).setContent("Don Brutzman, Vince Marchetti, Roy Walmsley, Nicholas Polys"))
.addMeta(new meta().setName(meta.NAME_CREATED ).setContent("4 June 2017"))
.addMeta(new meta().setName(meta.NAME_MODIFIED ).setContent("13 October 2023"))
.addMeta(new meta().setName(meta.NAME_TODO ).setContent("Upgrade and verify X3D v4.0 XML DTD and Schema to validate"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("X3dMeshDesignPattern.txt"))
.addMeta(new meta().setName(meta.NAME_IMAGE ).setContent("X3dMeshDesignPattern.png"))
.addMeta(new meta().setName(meta.NAME_WARNING ).setContent("Under development. Note that proposed design pattern for Normal inside PointSet or LineSet/IndexedLineSet is accepted in X3D 4.0 but is not allowed in X3D v3.3."))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("Web3D 2017 Workshop on 3D Scanning: Use Cases, Workflow and Profile Requirements for X3D"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("http://web3d2017.web3d.org/program"))
.addMeta(new meta().setName(meta.NAME_GENERATOR ).setContent("X3D-Edit 4.0, https://savage.nps.edu/X3D-Edit"))
.addMeta(new meta().setName(meta.NAME_IDENTIFIER ).setContent("https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Scanning/X3dMeshDesignPattern.x3d"))
.addMeta(new meta().setName(meta.NAME_LICENSE ).setContent("../license.html")))
.setScene(new Scene()
.addChild(new WorldInfo().setTitle("X3dMeshDesignPattern.x3d"))
.addChild(new Group()
.setMetadata(new MetadataSet().setName("X3dMesh")
.addComments(" enter other Metadata nodes and values here, vocabulary TBD "))
.addChild(new Switch().setWhichChoice(2)
.addChild(new Shape()
.setGeometry(new PointSet()
.addComments(" Currently invalid in X3D DTD: Normal node must be first to be allowed inside IndexedLineSet or LineSet ")
.addComments(" Of note: MeshLab allows assigning normals to a point cloud ")
.setNormal(new Normal("VertexNormals"))
.setColor(new Color("VertexColors").setColor(new MFColor(new double[] {1.0,0.0,0.0,0.0,1.0,0.0,0.0,0.0,1.0,1.0,1.0,1.0})))
.setCoord(new Coordinate("VertexValues").setPoint(new MFVec3f(new double[] {1.0,1.0,0.0,1.0,-1.0,0.0,-1.0,-1.0,0.0,-1.0,1.0,0.0})))
.addComments(" Currently invalid in X3D v3.3: Normal node not allowed inside PointSet ")))
.addChild(new Shape()
.setGeometry(new IndexedLineSet().setCoordIndex(new int[] {0,1,2,3,0,-1})
.addComments(" Currently invalid in X3D DTD: Normal node must be first to be allowed inside IndexedLineSet or LineSet ")
.setNormal(new Normal().setUSE("VertexNormals"))
.setCoord(new Coordinate().setUSE("VertexValues"))
.setColor(new Color().setUSE("VertexColors"))))
.addChild(new Shape()
.setGeometry(new IndexedFaceSet().setSolid(false).setCoordIndex(new int[] {0,1,2,3,0,-1})
.setCoord(new Coordinate().setUSE("VertexValues"))
.setColor(new Color().setUSE("VertexColors"))
.setNormal(new Normal().setUSE("VertexNormals")))))
.addChild(new ViewpointGroup().setDescription("Viewpoints at appropriate distance from model")
.addChild(new Viewpoint().setDescription("Front view").setPosition(0.0,0.0,4.0))))
.addComments(" Default scene display ")
.addChild(new Background().setSkyColor(new MFColor(new double[] {1.0,1.0,1.0})))
.addChild(new Transform("AvoidCoplanarAliasing").setTranslation(0.0,0.0,0.1)
.addChild(new Shape()
.setGeometry(new Text().setString(new String[] {"X3D","Mesh","Design","Pattern"})
.setFontStyle(new FontStyle().setFamily(new String[] {"SANS"}).setJustify(FontStyle.JUSTIFY_MIDDLE_MIDDLE).setSize(0.4).setCssStyle("BOLD")))
.setAppearance(new Appearance()
.setMaterial(new Material().setDiffuseColor(0.3,0.7,0.7))))));
}
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 X3dMeshDesignPattern 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 X3dMeshDesignPattern().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.Scanning.X3dMeshDesignPattern\" 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.Scanning.X3dMeshDesignPattern self-validation test confirmation: ");
if (!validationResults.equals("success"))
System.out.println();
System.out.println(validationResults.trim());
// experimental: test X3DJSAIL output files
// Scanning/X3dMeshDesignPattern_JavaExport.* file validation is checked when building X3D Example Archives
String filenameX3D = "Scanning/X3dMeshDesignPattern_JavaExport.x3d";
String filenameX3DV = "Scanning/X3dMeshDesignPattern_JavaExport.x3dv";
String filenameJSON = "Scanning/X3dMeshDesignPattern_JavaExport.json";
thisExampleX3dModel.toFileX3D (filenameX3D);
thisExampleX3dModel.toFileClassicVRML(filenameX3DV);
// TODO thisExampleX3dModel.toFileJSON (filenameJSON);
}
}
}