[x3d-public] initial release: X3D to Java translations, javadoc in X3D ExamplesArchives

[yottzumm at gmail.com]

As far as I can tell, that code does not return anything.  There are two unrelated variables.

John

Sent from Mail for Windows 10

From: Don Brutzman
Sent: Monday, April 3, 2017 12:39 PM
To: John Carlson; Alex Kern; Roy Walmsley
Cc: X3D Graphics public mailing list
Subject: initial release: X3D to Java translations, javadoc in X3D ExamplesArchives

Am happy to report that initial release of 250 Java translations for X3D programs in the Web3D Example Archives is now online.

Initial releases include X3dForWebAuthors and X3dForAdvancedModeling.

	http://x3dgraphics.com/examples/X3dForWebAuthors
	http://x3dgraphics.com/examples/X3dForWebAuthors/javadoc

	http://x3dgraphics.com/examples/X3dForAdvancedModeling
	http://x3dgraphics.com/examples/X3dForAdvancedModeling/javadoc

As described in the docs, this uses the X3dToJava.xslt stylesheet for conversions.  Each index page for each example model has links to corresponding java and javadoc (as well as .x3d .x3dv .json x3dom cobweb html etc. of course) for comparison.

John, this should really help us with ongoing testing and improvement of X3DJSAIL API and X3D Java programs.  Thanks for your patience with the short hiatus for this important unit-testing milestone.  It is pretty exciting actually since it lets us compare java-to-java code patterns and also can make the API even better.

	X3D Java Scene Access Interface Library (X3DJSAIL)
	http://www.web3d.org/specifications/java/X3DJSAIL.html

Let's pick one model as an example.  How about BoxSwitch.x3d scene:

	http://x3dgraphics.com/examples/X3dForAdvancedModeling/Animation/BoxSwitchIndex.html

	http://x3dgraphics.com/examples/X3dForAdvancedModeling/Animation/BoxSwitch.java
	http://x3dgraphics.com/examples/X3dForAdvancedModeling/javadoc/index.html?X3dForAdvancedModeling/Animation/BoxSwitch.html

	http://x3dgraphics.com/examples/X3dForAdvancedModeling/Animation/BoxSwitch.json

John, please skip past the header and javadoc business and look closely at the java/json source below.  This will also help us debug and improve the .json converters at the same time.  How do these versions look?  Improvements and conundrums welcome...  Files also attached "for the official record."  8)

The challenge encountered during this process was the need to rename directory names and file names to omit hyphen and period characters - those are not allowed as Java package or class names.  A number of rename fixes were made for X3dForAdvancedModeling.  *Hopefully the corresponding online link fixes are satisfactory* - trouble reports welcome.  Next "on deck" is the VRML 2 Sourcebook, lots of renaming is necessary for this to work.  Naming conventions can be found in the X3D Scene Authoring Hints at

	http://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#NamingConventions

As an example of debugging strength, this publishing process revealed a number of conversion problems for MFDouble, SFImage, field/fieldValue.addChild invocations, etc.  All discovered deficiencies fixed in the converter, no new bugs found on X3DJSAIL, changes checked in steadily, continued progress expected.

So, onward we go.  Have fun with X3D Java!  8)

all the best, Don
-- 
Don Brutzman  Naval Postgraduate School, Code USW/Br       brutzman at nps.edu
Watkins 270,  MOVES Institute, Monterey CA 93943-5000 USA   +1.831.656.2149
X3D graphics, virtual worlds, navy robotics http://faculty.nps.edu/brutzman

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20170403/68bfdacb/attachment.html>