[x3d-public] announce: X3D Java Scene Authoring Interface (SAI)open source, initial review release
Don Brutzman
brutzman at nps.edu
Tue Nov 29 11:03:20 PST 2016
This bug emerged and was fixed over last few days as part of O-O refactoring. It also involved an XML Schema and X3D Object Model change, might not be fully propagated yet... I just checked in those mods to XML schema and X3D Object Model.
Not 100% sure if the deployment upload was 100% complete. We are having difficulties with uploading. Latest date is always visible at bottom of the X3D Java SAI Library page and in version control, am careful to only check in successfully compiling/running builds.
http://www.web3d.org/specifications/java/X3dJavaSceneAuthoringInterface.html
https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/x3d/stylesheets/java/
Recommendation #1: use version control if you want to build the code, am typically checking in daily improvements.
Recommendation #2: use the .jar to run the example code.
http://www.web3d.org/specifications/java/jars/X3dJavaSceneAccessInterface3.3.full.jar
Thanks for trying this out... looking forward to fixing any blockers.
On 11/29/2016 10:35 AM, yottzumm at gmail.com wrote:
> Don,
>
>
>
> I tried to contact you through Skype. I don’t see how to fix this error, since I don’t know where it’s generated from:
>
>
>
> $ ant CreateX3dSceneAccessInterfaceJava
>
> …
>
> [echo] Compiling classes
>
> [javac] Compiling 381 source files to C:\x3d-code\www.web3d.org\x3d\stylesheets\java\classes
>
> [javac] Compiling 302 source files to C:\x3d-code\www.web3d.org\x3d\stylesheets\java\classes
>
> [javac] C:\x3d-code\www.web3d.org\x3d\stylesheets\java\src\org\web3d\x3d\java\Core\ProtoBodyObject.java:254: error: no suitable method found for add(X3DNode)
>
> [javac] children.add((X3DNode)newValue);
>
> [javac] ^
>
> [javac] method Collection.add(X3DChildNode) is not applicable
>
> [javac] (argument mismatch; X3DNode cannot be converted to X3DChildNode)
>
> [javac] method List.add(X3DChildNode) is not applicable
>
> [javac] (argument mismatch; X3DNode cannot be converted to X3DChildNode)
>
> [javac] method AbstractCollection.add(X3DChildNode) is not applicable
>
> [javac] (argument mismatch; X3DNode cannot be converted to X3DChildNode)
>
> [javac] method AbstractList.add(X3DChildNode) is not applicable
>
> [javac] (argument mismatch; X3DNode cannot be converted to X3DChildNode)
>
> [javac] method ArrayList.add(X3DChildNode) is not applicable
>
> [javac] (argument mismatch; X3DNode cannot be converted to X3DChildNode)
>
> [javac] Note: Some messages have been simplified; recompile with -Xdiags:verbose to get full output
>
> [javac] 1 error
>
>
>
> BUILD FAILED
>
> C:\x3d-code\www.web3d.org\x3d\stylesheets\build.xml:245: Compile failed; see the compiler error output for details.
>
>
>
> Total time: 16 seconds
>
>
>
> Sent from Mail <https://go.microsoft.com/fwlink/?LinkId=550986> for Windows 10
>
>
>
> *From: *Don Brutzman <mailto:brutzman at nps.edu>
> *Sent: *Tuesday, November 29, 2016 12:04 PM
> *To: *X3D Graphics public mailing list <mailto:x3d-public at web3d.org>
> *Cc: *SAVAGE Research Group <mailto:savage at nps.edu>
> *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:
>
>
>
> http://www.web3d.org/specifications/java/X3dJavaSceneAuthoringInterface.html
>
>
>
> http://www.web3d.org/specifications/java/examples
>
>
>
> http://www.web3d.org/specifications/java/javadoc
>
>
>
> 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
>
> http://web3d.org/mailman/listinfo/x3d-public_web3d.org
>
>
>
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
More information about the x3d-public
mailing list