package X3dForWebAuthors.Chapter01TechnicalOverview;
import org.web3d.x3d.jsail.Core.*;
import org.web3d.x3d.jsail.fields.*;
// Javadoc metadata annotations follow, see below for X3DJSAIL Java source code.
/**
* Illustrate a minimalist scene using only Core profile nodes. Root nodes must either be allowed children nodes of a Grouping node, or a LayerSet node. Note that DOCTYPE, head/meta and Group/Metadata* elements can be deleted without losing scene validity.
Related links: Catalog page EmptySceneCoreProfile, source EmptySceneCoreProfile.java, X3D Resources, X3D Scene Authoring Hints, and X3D Tooltips.
Scene Meta Information
| meta tags |
Document Metadata |
| title |
EmptySceneCoreProfile.x3d |
| description |
Illustrate a minimalist scene using only Core profile nodes. Root nodes must either be allowed children nodes of a Grouping node, or a LayerSet node. Note that DOCTYPE, head/meta and Group/Metadata* elements can be deleted without losing scene validity. |
| creator |
Leonard Daly, Don Brutzman |
| created |
24 February 2014 |
| modified |
3 August 2024 |
| reference |
EmptyScene.x3d |
| TODO |
should Metadata nodes inherit from X3DNode or X3DChildNode? |
| info |
WorldInfo is in Core Profile or higher |
| TODO |
ProtoInstance requires Core component level 1, complete prototype support requires Core component level 2 (or is optional in level 1) |
| specificationSection |
X3D 4.0 Architecture, ISO/IEC 19775-1:2023, 7 Core Component, Table 7.2 — Core component support levels |
| specificationUrl |
https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/components/core.html#t-CoresupportLevels |
| TODO |
Mantis issue 1448 https://www.web3d.org/member-only/mantis/view.php?id=1448 |
| specificationSection |
X3D 4.0 Architecture, ISO/IEC 19775-1:2023, Annex A Core Profile, Table A.3 — Nodes for conforming to the Core profile |
| specificationUrl |
https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/coreprofile.html#t-NodesForConformingToCoreProfile |
| reference |
https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/concepts.html#Rootnodes |
| info |
Increase X3D profile (or add component statements) to match if any other X3D nodes are added to this scene. |
| identifier |
https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter01TechnicalOverview/EmptySceneCoreProfile.x3d |
| reference |
https://x3dgraphics.com/chapters/Chapter15MetadataInformation.html |
| reference |
https://X3dGraphics.com |
| generator |
X3D-Edit 4.0, https://savage.nps.edu/X3D-Edit |
| license |
../license.html |
| |
This program uses the
X3D Java Scene Access Interface Library (X3DJSAIL).
It has been produced using the
X3dToJava.xslt
stylesheet
(version control)
which is used to create Java source code from an original .x3d model.
* @author Leonard Daly, Don Brutzman
*/
public class EmptySceneCoreProfile
{
/** Default constructor to create this object. */
public EmptySceneCoreProfile ()
{
initialize();
}
/** Create and initialize the X3D model for this object. */
public final void initialize()
{
try { // catch-all
x3dModel = new X3D().setProfile(X3D.PROFILE_CORE).setVersion(X3D.VERSION_4_0)
.setHead(new head()
.addMeta(new meta().setName(meta.NAME_TITLE ).setContent("EmptySceneCoreProfile.x3d"))
.addMeta(new meta().setName(meta.NAME_DESCRIPTION).setContent("Illustrate a minimalist scene using only Core profile nodes. Root nodes must either be allowed children nodes of a Grouping node, or a LayerSet node. Note that DOCTYPE, head/meta and Group/Metadata* elements can be deleted without losing scene validity."))
.addMeta(new meta().setName(meta.NAME_CREATOR ).setContent("Leonard Daly, Don Brutzman"))
.addMeta(new meta().setName(meta.NAME_CREATED ).setContent("24 February 2014"))
.addMeta(new meta().setName(meta.NAME_MODIFIED ).setContent("3 August 2024"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("EmptyScene.x3d"))
.addMeta(new meta().setName(meta.NAME_TODO ).setContent("should Metadata nodes inherit from X3DNode or X3DChildNode?"))
.addMeta(new meta().setName(meta.NAME_INFO ).setContent("WorldInfo is in Core Profile or higher"))
.addMeta(new meta().setName(meta.NAME_TODO ).setContent("ProtoInstance requires Core component level 1, complete prototype support requires Core component level 2 (or is optional in level 1)"))
.addMeta(new meta().setName(meta.NAME_SPECIFICATIONSECTION).setContent("X3D 4.0 Architecture, ISO/IEC 19775-1:2023, 7 Core Component, Table 7.2 — Core component support levels"))
.addMeta(new meta().setName(meta.NAME_SPECIFICATIONURL).setContent("https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/components/core.html#t-CoresupportLevels"))
.addMeta(new meta().setName(meta.NAME_TODO ).setContent("Mantis issue 1448 https://www.web3d.org/member-only/mantis/view.php?id=1448"))
.addMeta(new meta().setName(meta.NAME_SPECIFICATIONSECTION).setContent("X3D 4.0 Architecture, ISO/IEC 19775-1:2023, Annex A Core Profile, Table A.3 — Nodes for conforming to the Core profile"))
.addMeta(new meta().setName(meta.NAME_SPECIFICATIONURL).setContent("https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/coreprofile.html#t-NodesForConformingToCoreProfile"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("https://www.web3d.org/specifications/X3Dv4/ISO-IEC19775-1v4-IS/Part01/concepts.html#Rootnodes"))
.addMeta(new meta().setName(meta.NAME_INFO ).setContent("Increase X3D profile (or add component statements) to match if any other X3D nodes are added to this scene."))
.addMeta(new meta().setName(meta.NAME_IDENTIFIER ).setContent("https://www.web3d.org/x3d/content/examples/X3dForWebAuthors/Chapter01TechnicalOverview/EmptySceneCoreProfile.x3d"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("https://x3dgraphics.com/chapters/Chapter15MetadataInformation.html"))
.addMeta(new meta().setName(meta.NAME_REFERENCE ).setContent("https://X3dGraphics.com"))
.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()
.addComments(" Core profile can only contain WorldInfo and Metadata nodes. ")
.addChild(new WorldInfo().setTitle("EmptySceneCoreProfile.x3d"))
.addChild(new WorldInfo()
.setMetadata(new MetadataSet().setName("NodeSet")
.setMetadata(new MetadataBoolean().setName("BooleanData").setValue(new boolean[] {true,false}))
.setMetadata(new MetadataDouble().setName("DoubleData").setValue(new double[] {1.0,2.0,3.0}))
.setMetadata(new MetadataFloat().setName("FloatData").setValue(new double[] {4.0,5.0,6.0}))
.setMetadata(new MetadataInteger().setName("IntegerData").setValue(new int[] {7,8,9}))
.setMetadata(new MetadataString().setName("StringData").setValue(new String[] {"Empty Scene","Core Profile"})))));
}
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
* shallow copy
* of the X3D model.
* @see X3D
* @return EmptySceneCoreProfile 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 X3D.handleArguments(args)
* @see X3D.validationReport()
* @see CommandLine
* @see CommandLine.USAGE
* @see ConfigurationProperties
*/
public static void main(String args[])
{
System.out.println("Build this X3D model, showing validation diagnostics...");
X3D thisExampleX3dModel = new EmptySceneCoreProfile().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: \"X3dForWebAuthors.Chapter01TechnicalOverview.EmptySceneCoreProfile\" 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("X3dForWebAuthors.Chapter01TechnicalOverview.EmptySceneCoreProfile self-validation test confirmation: ");
if (!validationResults.equals("success"))
System.out.println();
System.out.println(validationResults.trim());
// experimental: test X3DJSAIL output files
// Chapter01TechnicalOverview/EmptySceneCoreProfile_JavaExport.* file validation is checked when building X3D Example Archives
String filenameX3D = "Chapter01TechnicalOverview/EmptySceneCoreProfile_JavaExport.x3d";
String filenameX3DV = "Chapter01TechnicalOverview/EmptySceneCoreProfile_JavaExport.x3dv";
String filenameJSON = "Chapter01TechnicalOverview/EmptySceneCoreProfile_JavaExport.json";
thisExampleX3dModel.toFileX3D (filenameX3D);
thisExampleX3dModel.toFileClassicVRML(filenameX3DV);
// TODO thisExampleX3dModel.toFileJSON (filenameJSON);
}
}
}