[x3d-public] Major Incompatible Revision (not Version) of X3D JSON format, new X3D JSON Loader (Re: X3D JSON encoding: refactoring, simplifying handling of #comment and #ROUTE)

[John Carlson]

The newest X3D JSON format will not be compatible with the old X3DJSON loader, so I am releasing a new version.  You will need to redo your JSON files to accommodate this new loader.  If you don’t want change your JSON, don’t upgrade!  But your JSON probably won’t be compatible with the standard.

Demo is here:  http://coderextreme.net/X3DJSONLD/
Source code is here: https://github.com/coderextreme/X3DJSONLD/

I have started documenting an external API:

https://github.com/coderextreme/X3DJSONLD/README.pdf

I have removed the Prototype expanded examples (forces.json, cobwebs.json, ArchPrototypes.json) for  X3DOM from the demo.  I will probably add them back soon.  Please don’t use them until I do.  You can get new versions by using the prototype expander checkbox and selecting the JSON after loading.

I also need to make sure we are roundtripping correctly.  Can someone suggest a good XML differ?  I can’t get X3D-Edit to diff different files.

John
> On Jan 9, 2016, at 1:55 AM, Don Brutzman <brutzman at nps.edu> wrote:
> 
> 
> 
> 
> -------- Forwarded Message --------
> Subject: Re: X3D JSON encoding: refactoring, simplifying handling of #comment and #ROUTE
> Date: Wed, 6 Jan 2016 12:45:18 -0800
> From: Don Brutzman <brutzman at nps.edu>
> Organization: Naval Postgraduate School
> To: John Carlson <yottzumm at gmail.com>
> CC: Roy Walmsley (roy.walmsley at ntlworld.com) <roy.walmsley at ntlworld.com>, X3D Graphics public mailing list <x3d-public at web3d.org>
> 
> OK.  The suggested changes have been implemented and deployed: #comment and ROUTE statements.
> 
> Since ROUTE is a well-defined statement and being handled similar to other nodes, it no longer seems necessary to include the # symbol.
> 
> ========================================
> The description page prose and examples have been updated to show the new syntax.
> 
> 	X3D to JSON Stylesheet Converter
> 	http://www.web3d.org/x3d/stylesheets/X3dToJson.html
> 
> 	Design Patterns
> 	http://www.web3d.org/x3d/stylesheets/X3dToJson.html#DesignPatterns
> 
> 	Examples
> 	http://www.web3d.org/x3d/stylesheets/X3dToJson.html#Examples
> 
> 	http://www.web3d.org/x3d/stylesheets/X3dToJson.html#HelloWorld.json
> 	http://x3dgraphics.com/examples/X3dForAdvancedModeling/HelloWorldScenes/HelloWorld.json
> 
> 	http://www.web3d.org/x3d/stylesheets/X3dToJson.html#TestJsonEncoding
> 	http://www.web3d.org/x3d/content/examples/Basic/development/TestJsonEncoding.json
> 
> 	http://www.web3d.org/x3d/stylesheets/X3dToJson.html#OrigamiCranes
> 	http://x3dgraphics.com/examples/X3dForAdvancedModeling/Animation/OrigamiCranes.json
> 
> ========================================
> Updated example archives and X3D-Edit integration have been deployed.
> 
> 	X3D Resources: Examples
> 	http://www.web3d.org/x3d/content/examples/X3dResources.html#Examples
> 
> 	Special testing distribution. A comprehensive collection of all JSON example scenes
> 	is available at
> 	http://www.web3d.org/x3d/content/examples/X3dExampleArchivesJsonScenes.zip
> 	http://www.web3d.org/x3d/content/examples/X3dExampleArchivesJsonScenes.zip.MD5
> 	
> 	plus current output from the X3D JSON build process at
> 	http://www.web3d.org/x3d/content/examples/build.json.out
> 
> 	X3D-Edit Authoring Tool for Extensible 3D (X3D) Graphics
> 	https://savage.nps.edu/X3D-Edit
> 	https://savage.nps.edu/X3D-Edit/images/X3D-EditToolbarButtons3.png
> ========================================
> 
> Review and discussion welcome.
> 
> Our remaining list of unfinished encoding issues is getting pretty short:  IMPORT/EXPORT for Inline, and null nodes within an MFNode array.
> 
> 	http://www.web3d.org/x3d/stylesheets/X3dToJson.html#Issues
> 
> On 1/4/2016 5:30 AM, John Carlson wrote:
>> I can report that the new JSON format is better at maintaining order in the roundtrip :) We just need to work on the first leg.
> [...]
> 
> Baton of implementation/evaluation now handed back to you and others John. Have fun with X3D JSON!   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
> 
>