package X3dForAdvancedModeling.Scanning;
import org.web3d.x3d.jsail.Core.*;
import org.web3d.x3d.jsail.fields.*;
import org.web3d.x3d.jsail.Grouping.*;
import org.web3d.x3d.jsail.Networking.*;
import org.web3d.x3d.jsail.Shape.*;
import org.web3d.x3d.jsail.Text.*;
// Javadoc metadata annotations follow, see below for X3DJSAIL Java source code.
/**
* <p> Embed example metadata associated with a scanned 3D model using X3D version 4. </p>
<p> Related links: Catalog page <a href="../../../Scanning/ScannerMetadataExample4Index.html" target="_blank">ScannerMetadataExample4</a>, source <a href="../../../Scanning/ScannerMetadataExample4.java">ScannerMetadataExample4.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/ScannerMetadataExample4.x3d">ScannerMetadataExample4.x3d</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> description </i> </td>
<td> Embed example metadata associated with a scanned 3D model using X3D version 4. </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> created </i> </td>
<td> 11 November 2019 </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> modified </i> </td>
<td> 20 February 2024 </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> TODO </i> </td>
<td> If approved for X3D4, apply modified containerField=value defaults for Metadata* nodes </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> reference </i> </td>
<td> <a href="https://docs.google.com/spreadsheets/d/1RKvh6oEsyIgEIFfjDQNgu1U6QoAmsduvHx3ki18Z06A/htmlview#" target="_blank">https://docs.google.com/spreadsheets/d/1RKvh6oEsyIgEIFfjDQNgu1U6QoAmsduvHx3ki18Z06A/htmlview#</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> creator </i> </td>
<td> Bill Gutelius, Qntfi <a href="https://www.qntfii.com" target="_blank">https://www.qntfii.com</a> </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> translator </i> </td>
<td> Nicholas Polys, VT </td>
</tr>
<tr>
<td style="text-align:right; vertical-align: text-top;"> <i> reference </i> </td>
<td> <a href="../../../Scanning/ScannerMetadataExample33.x3d">ScannerMetadataExample33.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/X3dForAdvancedModeling/Scanning/ScannerMetadataExample4.x3d" target="_blank">https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Scanning/ScannerMetadataExample4.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 Bill Gutelius, Qntfi https://www.qntfii.com
*/
public class ScannerMetadataExample4
{
/** Default constructor to create this object. */
public ScannerMetadataExample4 ()
{
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_4_0)
.setHead(new head()
.addUnit(new unit().setName("meter").setCategory("length").setConversionFactor(1))
.addMeta(new meta().setName(meta.NAME_TITLE ).setContent("ScannerMetadataExample4.x3d"))
.addMeta(new meta().setName(meta.NAME_DESCRIPTION).setContent("Embed example metadata associated with a scanned 3D model using X3D version 4."))
.addMeta(new meta().setName(meta.NAME_CREATED ).setContent("11 November 2019"))
.addMeta(new meta().setName(meta.NAME_MODIFIED ).setContent("20 February 2024"))
.addMeta(new meta().setName(meta.NAME_TODO ).setContent("If approved for X3D4, apply modified containerField=value defaults for Metadata* nodes"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("https://docs.google.com/spreadsheets/d/1RKvh6oEsyIgEIFfjDQNgu1U6QoAmsduvHx3ki18Z06A/htmlview#"))
.addMeta(new meta().setName(meta.NAME_CREATOR ).setContent("Bill Gutelius, Qntfi https://www.qntfii.com"))
.addMeta(new meta().setName(meta.NAME_TRANSLATOR ).setContent("Nicholas Polys, VT"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("ScannerMetadataExample33.x3d"))
.addMeta(new meta().setName(meta.NAME_IDENTIFIER ).setContent("https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Scanning/ScannerMetadataExample4.x3d"))
.addMeta(new meta().setName(meta.NAME_LICENSE ).setContent("../license.html")))
.setScene(new Scene()
.addChild(new WorldInfo().setTitle("ScannerMetadataExample4.x3d"))
.addMetadata(new MetadataSet().setName("Scan Information").setReference("Web3D proposed vocabulary: version 0.1")
.setMetadata(new MetadataSet().setName("Acquisition").setReference("Hardware")
.setMetadata(new MetadataString().setName("Scanner").setValue(new String[] {"Emesent HOVERMAP"}))
.setMetadata(new MetadataString().setName("ScannerModel").setValue(new String[] {"Model: HF-1"}))
.setMetadata(new MetadataFloat().setName("Pulse rate (kHz)").setValue(new double[] {300.0}))
.setMetadata(new MetadataFloat().setName("Wavelength (nm)").setValue(new double[] {903.0}))
.setMetadata(new MetadataFloat().setName("Max range (m)").setValue(new double[] {100.0})))
.setMetadata(new MetadataSet().setName("Scan Session")
.setMetadata(new MetadataString().setName("acquisition_timestamp").setValue(new String[] {"2019-11-05T10:15:32.3+0500"})))
.setMetadata(new MetadataSet().setName("LAS Fields").setReference("http://www.asprs.org/wp-content/uploads/2019/03/LAS_1_4_r14.pdf")
.setMetadata(new MetadataString().setName("number of points").setValue(new String[] {"18102106"}))
.setMetadata(new MetadataInteger().setName("point_format").setValue(new int[] {1}))
.setMetadata(new MetadataSet().setName("LAS.scalar fields")
.setMetadata(new MetadataInteger().setName("num.fields").setValue(new int[] {3}))
.setMetadata(new MetadataString().setName("scalar1").setValue(new String[] {"Intensity"}))
.setMetadata(new MetadataString().setName("scalar2").setValue(new String[] {"ReturnNumber"}))
.setMetadata(new MetadataString().setName("scalar3").setValue(new String[] {"GpsTime"})))
.addComments(" we should have a double precision version too <MetadataSFVec3f containerField=\"value\" name=\"Global shift\" value='131.45, 91.94, 3.18'/> ")
.setMetadata(new MetadataFloat().setName("LAS.Global_shift.x").setValue(new double[] {131.45}))
.setMetadata(new MetadataFloat().setName("LAS.Global_shift.y").setValue(new double[] {91.94}))
.setMetadata(new MetadataFloat().setName("LAS.Global_shift.z").setValue(new double[] {3.18}))
.setMetadata(new MetadataInteger().setName("Scalar.fields").setValue(new int[] {3}))
.setMetadata(new MetadataInteger().setName("Version.Major").setValue(new int[] {1}))
.setMetadata(new MetadataInteger().setName("Version.Minor").setValue(new int[] {4}))
.setMetadata(new MetadataFloat().setName("LAS.scale.x").setValue(new double[] {2.13564e-7}))
.setMetadata(new MetadataFloat().setName("LAS.scale.y").setValue(new double[] {2.35058e-7}))
.setMetadata(new MetadataFloat().setName("LAS.scale.z").setValue(new double[] {5.6171e-8})))
.setMetadata(new MetadataSet().setName("Scene Provenance")
.setMetadata(new MetadataSet().setName("Provenance")
.addComments(" omitted value=\"this\" ")
.setMetadata(new MetadataSet().setName("this-1")
.setMetadata(new MetadataString().setName("Last Modified").setValue(new String[] {"Jan 1 2019"}))
.setMetadata(new MetadataString().setName("Institution").setValue(new String[] {"Virginia Tech Visionarium"}))
.setMetadata(new MetadataString().setName("Authors").setValue(new String[] {"Nicholas Polys"}))
.setMetadata(new MetadataString().setName("Tools").setValue(new String[] {"LAS2X3D.py"}))
.setMetadata(new MetadataString().setName("Algorithms").setValue(new String[] {"lexical sampling by interval stride"}))))))
.addChild(new Anchor().setDescription("ScannerMetadataExample4 model page").setParameter(new String[] {"target=blank"}).setUrl(new String[] {"https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Scanning/ScannerMetadataExample4Index.html"})
.addChild(new Shape()
.setGeometry(new Text().setString(new String[] {"ScannerMetadataExample4","embed metadata in X3D4"})
.setFontStyle(new FontStyle().setFamily(new String[] {"SANS"}).setJustify(FontStyle.JUSTIFY_MIDDLE_MIDDLE).setSize(0.75).setCssStyle("BOLD")))
.setAppearance(new Appearance()
.setMaterial(new Material().setDiffuseColor(0.0,0.501961,0.109804)))))
.addComments(" NFP: Scene node can also take a MetadataSet (?) ... Here considered as a value-added scene from the acquisition the default containerField='value' ")
.addChild(new Transform().setTranslation(131.45,91.94,3.18)
.addComments(" by global shift value above ")
.addComments(" could be an LOD ")
.addChild(new Switch().setBboxCenter(106.781,117.532,28.0086).setBboxSize(213.564,235.058,56.171).setWhichChoice(0)
.addChild(new Group()
.addChild(new Shape("Highest_Resolution")
.setMetadata(new MetadataSet().setName("holder1")
.setMetadata(new MetadataSet().setName("LAS Fields").setReference("http://www.asprs.org/wp-content/uploads/2019/03/LAS_1_4_r14.pdf")
.setMetadata(new MetadataString().setName("number of points").setValue(new String[] {"1810210"})))
.setMetadata(new MetadataSet().setName("Permissions")
.setMetadata(new MetadataBoolean().setName("recording").setValue(new boolean[] {false}))
.setMetadata(new MetadataBoolean().setName("systematization").setValue(new boolean[] {false}))
.setMetadata(new MetadataBoolean().setName("accumulation").setValue(new boolean[] {false}))))))
.addChild(new Group()
.addChild(new Shape("Medium_Resolution")
.setMetadata(new MetadataSet().setName("holder3")
.setMetadata(new MetadataSet().setName("LAS Fields").setReference("http://www.asprs.org/wp-content/uploads/2019/03/LAS_1_4_r14.pdf")
.setMetadata(new MetadataString().setName("number of points").setValue(new String[] {"181021"})))
.setMetadata(new MetadataSet().setName("Permissions")
.setMetadata(new MetadataBoolean().setName("recording").setValue(new boolean[] {false}))
.setMetadata(new MetadataBoolean().setName("systematization").setValue(new boolean[] {true}))
.setMetadata(new MetadataBoolean().setName("accumulation").setValue(new boolean[] {true}))))))
.addChild(new Group()
.addChild(new Shape("Low_Resolution")
.setMetadata(new MetadataSet().setName("holder3")
.setMetadata(new MetadataSet().setName("LAS Fields").setReference("http://www.asprs.org/wp-content/uploads/2019/03/LAS_1_4_r14.pdf")
.setMetadata(new MetadataString().setName("number of points").setValue(new String[] {"72408"})))
.setMetadata(new MetadataSet().setName("Permissions")
.setMetadata(new MetadataBoolean().setName("recording").setValue(new boolean[] {true}))
.setMetadata(new MetadataBoolean().setName("systematization").setValue(new boolean[] {true}))
.setMetadata(new MetadataBoolean().setName("accumulation").setValue(new boolean[] {true})))))))));
}
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 ScannerMetadataExample4 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 ScannerMetadataExample4().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.ScannerMetadataExample4\" 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.ScannerMetadataExample4 self-validation test confirmation: ");
if (!validationResults.equals("success"))
System.out.println();
System.out.println(validationResults.trim());
// experimental: test X3DJSAIL output files
// Scanning/ScannerMetadataExample4_JavaExport.* file validation is checked when building X3D Example Archives
String filenameX3D = "Scanning/ScannerMetadataExample4_JavaExport.x3d";
String filenameX3DV = "Scanning/ScannerMetadataExample4_JavaExport.x3dv";
String filenameJSON = "Scanning/ScannerMetadataExample4_JavaExport.json";
thisExampleX3dModel.toFileX3D (filenameX3D);
thisExampleX3dModel.toFileClassicVRML(filenameX3DV);
// TODO thisExampleX3dModel.toFileJSON (filenameJSON);
}
}
}