[x3d-public] announce: X3D XML schema updates for shaders and metadata, DTD updates for pick sensors

[Don Brutzman]

Summary: performed a number of refactorizations for consistency that appear to have sorted out several issues for nodes in the Programmable Shaders component.

Summary of specification requirements for content models:

a.  field: Script, ShaderProgram, ComposedShader, PackagedShader
b. source: Script, ShaderProgram, ShaderPart

Each node now appears to have consistent syntax with Script node, subsetted as appropriate.
Further testing and issue reports on example scenes containing Shader nodes is welcome.

In general this change will have little or no effect on existing .x3d files.
Shader nodes now have ordering of contained <field>, IS/connect and CDATA source-code
definitions fully consistent with Script node.

=============================================================================
x3d-schema-changelog.txt

X3D Schema update activity:

1 March 2017 brutzman
- Allow field declarations within PackagedShader and ShaderProgram, also made other
   content-model and inputOnly/outputOnly definitions more consistent for Shaders component.
- All Metadata* node interface annotations now include X3DNode.

31 January 2016 sanden, brutzman (still pending)
- TODO: refactor various enumeration values for X3DPickSensorNode to allow independent
   referencing in X3D Object Model

TODO: add regular expressions (regexes) for further validation of field content for each data type.

=============================================================================
x3d-dtd-changelog.txt

X3D DTD update activity:

1 March 2017, danek, brutzman, walmsley
- include pickingTarget %ShapeNodes% as part of content model for *PickSensor nodes

=============================================================================

Numerous related assets follow.

X3D Object Model is autogenerated from X3D XML Schema, and in turn is being used to autogenerate other products
such as X3D Java Scene Access Interface Library (X3DJSAIL).

     http://www.web3d.org/specifications/X3DObjectModel-3.3.xml

These changes on Metadata nodes, contained field definitions and contained source were tested in X3DJSAIL.

     http://www.web3d.org/specifications/java/X3DJSAIL.html
     http://www.web3d.org/specifications/java/javadoc

Design note: testing all the way through object model and X3DJSAIL was definitely of value
when debugging and verifying proper X3D XML schema definitions.

=============================================================================

These assets can be found on the X3D Specifications: XML Schema and DOCTYPE Validation page.

           http://www.web3d.org/specifications

Full documentation updates have been autogenerated for the XML Schema and DOCTYPE, available for X3D versions 3.0 through 3.3 plus experimental 4.0.  Recommended X3D version is 3.3.

       http://www.web3d.org/specifications/X3dSchemaDocumentation3.3/x3d-3.3.html
       http://www.web3d.org/specifications/X3dDoctypeDocumentation3.3.html

Corresponding updated assets: lists of all X3D elements and attributes, with default values, autogenerated from X3D XML Schema.

      http://www.web3d.org/specifications/AllX3dElementsAttributes3.3.txt
      http://www.web3d.org/specifications/AllX3dElementsAttributes3.3.xml

Additional updated assets: X3D JSON Schema (manual) and X3D Object Model (autogenerated) by Roy Walmsley.

      http://www.web3d.org/specifications/x3d-3.3-JSONSchema.json (experimental)
      http://www.web3d.org/specifications/X3dJsonSchemaDocumentation3.3/x3d-3.3-JSONSchema.html

      http://www.web3d.org/specifications/X3DObjectModel-3.3.xml  (experimental)

X3D Schematron Validation and Quality Assurance (QA) rules are also regularly updated in concert with these changes.

       http://www.web3d.org/x3d/tools/schematron/X3dSchematron.html

The X3D Working Group also maintains the X3D Graphics Standards: Specification Relationships diagram up to date, showing the roadmap for all major planned work.

       http://www.web3d.org/specifications/X3dSpecificationRelationships.png
       http://www.web3d.org/specifications/X3dSpecificationRelationships.pdf

Please note that X3D version 4.0 Schema and DTD are experimental and support specification development.

All versions of these assets are maintained under open-source version control at

       https://sourceforge.net/p/x3d/code/HEAD/tree/www.web3d.org/specifications

Changes are tested through validation regression testing of 3800+ open-source X3D scenes.

       X3D Resources: Examples
       http://www.web3d.org/x3d/content/examples/X3dResources.html#Examples

       X3D Resources: Quality Assurance (QA)
       http://www.web3d.org/x3d/content/examples/X3dResources.html#QualityAssurance

Corresponding updates are also regularly released in the following public assets:

       X3D Tooltips
       http://www.web3d.org/x3d/content/examples/X3dResources.html#Tooltips

       X3D Validator
       https://savage.nps.edu/X3dValidator

       X3D-Edit Authoring Tool
       https://savage.nps.edu/X3D-Edit

You can comment on the X3D Specifications in multiple ways.  All feedback gets considered.

       mailto:x3d-public at web3d.org
       http://www.web3d.org/x3d/content/examples/X3dResources.html#Feedback
       http://www.web3d.org/content/web3d-standards-comment-form

Feedback is always welcome.  Thanks for all test reports and idea contributions.

Want to help support this work building the future Web?  The value of membership in the Web3D Consortium continues to steadily grow.  Your engagement can definitely help, there are lots of cool challenges to pursue.  Please consider joining as a company, institution or individual to participate.

      http://www.web3d.org/join

      http://www.web3d.org/projects/wish-list

=============================================================================

Have fun with X3D!   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