[x3d-public] X3D Examples: addition links on model pages, detection of event loops in HTML documentation

[Brutzman, Donald (Don) (CIV)]

Am happy to report some useful progress.

 

1.	Thanks to suggestions from Nicholas Polys for improving some of the links provided on each index page.

*	Three-column layout for better readability
*	In-browser model editing using X_ITE Playground and X3DOM Editor are top center.
*	html annotated documentation easier to find.
*	Link for reporting comments/problems/improvements to x3d-public mailing list.
*	Link for SourceForge version control and also tickets (i.e. issue list) to facilitate problem reporting.

 

Problem reports, improvements, and candidate additions are welcome.  We are “walking the walk.”

 

2.	X3dToXhtml.xslt stylesheet to produce html annotated documentation can now identify when ROUTE loops occur, which is helpful for improving performance and avoiding errors.  Screenshot attached, example at

*	X3D Example Archives: X3D4AM, X3D for Advanced Modeling, Animation, Event Graph Loop Test
*	Diagnostic scene for tools to test event-graph loop detection
*	https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Animation/EventGraphLoopTestIndex.html
*	https://www.web3d.org/x3d/content/examples/X3dForAdvancedModeling/Animation/EventGraphLoopTest.html#EventGraph

 

3.	It was difficult to get the loop-test working with XSLT recursion, some fine tuning is continuing, hopefully it is now OK.  This updated capability will be included in next release of X3D-Edit.

 

Am thinking it would be a good practice for browsers to report on console the first time an event loop occurs, motivated to assist authors.  This seems like a mostly undetected class of errors since we haven’t had quality assurance tests for these before.

 

4.	These improvements have been applied to all 4000+ X3D Examples Archives, all maintained in public version control under an open-source license.

 

*	X3D Resources, X3D Examples: Scene Archives for X3D
*	The X3D Examples Archives demonstrate how X3D nodes and scenes work. Thousands of scenes are provided in all X3D encodings. You can browse them individually online or download fully complete, separately installable .zip archives.
*	https://www.web3d.org/x3d/content/examples/X3dResources.html#Examples
*	https://www.web3d.org/x3d/content/examples/license.html

 

Have fun with improved X3D4 documentation and diagnostics in HTML!  😊

 

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 https://faculty.nps.edu/brutzman

 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20240216/17708870/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: EventGraphLoopTestIndex.png
Type: image/png
Size: 81973 bytes
Desc: not available
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20240216/17708870/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: EventGraphLoopTestHtmlDiagnostic.png
Type: image/png
Size: 206518 bytes
Desc: not available
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20240216/17708870/attachment-0003.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 5464 bytes
Desc: not available
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20240216/17708870/attachment-0001.p7s>