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

[Don Brutzman]

On 4/3/2017 7:06 PM, yottzumm at gmail.com wrote:
> As far as I can tell, that code does not return anything.  There are two unrelated variables.

Correct.  Time for another step forward!  8)

Each converted result can provide an X3DObject back to an invoking program.  So anyone can use them programmatically now.

We might also provide methods to further facilitate testing.  Wondering what default methods we might want to add to such .x3d -> .java conversions?

BoxSwitch (linked below) might be a good exemplar to build on.  Suggested additions welcome.



> *From: *Don Brutzman <mailto:brutzman at nps.edu>
> *Sent: *Monday, April 3, 2017 12:39 PM
> *To: *John Carlson <mailto:yottzumm at gmail.com>; Alex Kern <mailto:Job at alexkern.de>; Roy Walmsley <mailto:roy.walmsley at ntlworld.com>
> *Cc: *X3D Graphics public mailing list <mailto:x3d-public at web3d.org>
> *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
>
>
>


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