[x3d-public] announce: X3D Java Scene Authoring Interface (SAI)open source, initial review release

yottzumm at gmail.com yottzumm at gmail.com
Tue Nov 29 20:22:26 PST 2016

Waiting for instructions on how to use IS/ISObject/IS statements.  I’m not sure how to hook them under material, etc.



Sent from Mail for Windows 10

From: Don Brutzman
Sent: Tuesday, November 29, 2016 12:04 PM
To: X3D Graphics public mailing list
Cc: SAVAGE Research Group
Subject: Re: [x3d-public] announce: X3D Java Scene Authoring Interface (SAI)open source, initial review release

Another significant release has been deployed today:

- Support for prototypes: ProtoDeclare, ProtoInterface/ProtoBody, ExternProtoDeclare, ProtoInstance.
- Further validation checks, making it hard for programmers to create a broken scene graph.
- Support for X3D, ClassicVRML and VRML97 file export (.x3d .x3dv .wrl)
- "Principle of least surprise" when null values are encountered from author (e.g. clear a field, etc.)
- Further unit tests in example program to confirm proper operation of correct and incorrect constructs.
- Internal package refactoring to improve inheritance, leaving exposed programming API unchanged.
- Performance looks great, despite complexity am unable to get execution time above "O seconds" - deserves profiling on large models.

Key links:



Test reports and improvement suggestions welcome.  Have fun with X3D Java!

On 10/21/2016 8:19 AM, Don Brutzman wrote:
> Second release is out, the X3D Java SAI Library is now in beta.
> Latest release include autogeneration of concrete classes for field types.  Quite a tricky business because a number of specification definitions are contradictory or simply missing, because the published Java SAI specification was based on X3D v3.0 capabilities.
> Still in collection mode, but have started a text document listing specification problems and potential improvements.
>     http://www.web3d.org/specifications/java/X3dJavaSpecificationChangesAndIssues.txt
> Active TODO list, more to follow:
> * In progress. Test concrete field-type classes for SFBool/MFBool through SFNode/MFNode to support value instantiation, including creation of type-checked new values from strings. A number of new data types have been added since X3D version 3.0, extra attention is needed to ensure that new classes and methods consistently support new specification additions. Method stubs need to be implemented (typically adapting source code from the Xj3D implementation).
> * In progress. Confirm generation of default attribute values and constructors.
> * In progress. Continue testing concrete classes for X3D statements, also confirming that attributes are properly reflected as fields.
> * In progress. Add support for persistent scene-graph comments and comment blocks.
> Initial testing: HelloWorldProgram.java model, online at
>     http://www.web3d.org/specifications/java/examples/HelloWorldProgram.java
> The X3D Object Model is looking very solid.  Changes to X3D specification and schema are automatically integrated in this codebase.  When complete, this will be a big step forward for rigourously maintaining all X3D specifications, quality assurance tools and Web3D Consortium resources completely correct and in synch.  I expect it will be especially helpful when we get to the stage of experimentation with X3D version 4.
> Scrutiny by Java experts on the class structures and design patterns is appreciated.  More work to follow on X3D Java SAI Library, of course, but it looks like all the major building blocks are now in place.  Incremental implementation improvements and TODO capability addition can now proceed.
> As ever, all feedback and comments are welcome.  Have fun with X3D Java!
> ==================================================================================
> On 6/27/2016 8:03 AM, Don Brutzman wrote:
> Now available for review: X3D Java Scene Authoring Interface (SAI) Library.
>     http://www.web3d.org/x3d/stylesheets/java/X3dJavaSceneAuthoringInterface.html
> The X3D Java Scene Access Interface (SAI) is a strongly typed Java library that provides access to a browser and its contained scene graph. This package contains X3D SAI interfaces that support the X3D Specifications.
> Available products include javadoc, source code, build classes and draft specification annexes.
>     http://www.web3d.org/x3d/stylesheets/java/javadoc/index.html
>     http://www.web3d.org/x3d/stylesheets/java/source/org/web3d/x3d/sai
>     http://www.web3d.org/x3d/stylesheets/java/build/org/web3d/x3d/sai
>     http://www.web3d.org/x3d/stylesheets/java/draftJavaLanguageBindingAnnexes/Part2/nodeTypeInterfaces.html
>     http://www.web3d.org/x3d/stylesheets/java/draftJavaLanguageBindingAnnexes/Part2/nodeInterfaces.html
> Intended uses include
> * Current: compiling Java source code for an X3D Script node.
> * Future: support creation of standalone Java applications by providing a Plain Old Java Object (POJO) implementation for X3D.
> * Future: serve as a design template for future autogeneration of similar codebases for ECMAScript, C++/C# and Python.
> Special thanks to Roy Walmsley for X3D Object Model creation and ongoing design discussions.  Further notes about API Codebase Production autogeneration and design considerations appear on the topmost page listed above.
> Work continues on matching autogenerated interfaces to the specification, noting corrections, and testing actual Script code in Java.
> Comments are always welcome.  Have fun with X3D using Java!
> ==================================================================================

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

x3d-public mailing list
x3d-public at web3d.org

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20161129/73d99cab/attachment-0001.html>

More information about the x3d-public mailing list