[X3D-Public] Find minimum X3D version for specific nodes?

[Don Brutzman]

Hi Max, excellent question.  The X3D Abstract Specification includes this information for all nodes and abstract types:

Annex Z (normative) Version content
http://www.web3d.org/files/specifications/19775-1/V3.3/Part01/versionContent.html

Example:

Node 	Fields 	3.0 	3.1 	3.2 	3.3
Anchor
addChildren 	X	X	X	X
removeChildren 	X	X	X	X
children 	X	X	X	X
description 	X	X	X	X
metadata 	X	X	X	X
parameter 	X	X	X	X
url 		X	X	X	X
bboxCenter 	X	X	X	X
bboxSize 	X	X	X	X

The node name "Anchor" there in turn links directly to the specification paragraph:
http://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/networking.html#Anchor

Of related interest: this table "Annex Z Version Content" is what the X3D Tooltips entry for each node is linked to.  Additional cross-reference links to X3D Schema and DTD documentation are also provided.

Example:
http://www.web3d.org/x3d/content/X3dTooltips.html#Anchor
http://www.web3d.org/files/specifications/19775-1/V3.3/Part01/versionContent.html#Anchor
http://www.web3d.org/specifications/X3dSchemaDocumentation3.3/x3d-3.3_Anchor.html
http://www.web3d.org/specifications/X3dDoctypeDocumentation3.3.html#Anchor

In general these links can all be found listed together under X3D Resources: Authoring Support.
http://www.web3d.org/x3d/content/examples/X3dResources.html#AuthoringSupport

... and under the assumption "you can never have too much of a good thing!" I'm maintaining a spreadsheet inventory of node-by-node coverage for  X3D Abstract Specification, X3D Schema, X3D DOCTYPE, X3D-Edit, X3DOM, and VRML97 node sets.

X3D Specifications: DOCTYPE and Schema Validation
http://www.web3d.org/specifications

X3D Node Inventory Comparison
http://www.web3d.org/specifications/X3dNodeInventoryComparison.xlsx
http://www.web3d.org/specifications/X3dNodeInventoryComparison.pdf

This was the exact topic of discussion during our X3D Working Group teleconference last week.  You are welcome to join us sometime, Wednesdays at 0800 pacific.

Please advise if there are better cross-reference links for X3DOM, and if you notice any nodes missing.  Your email is great - it will be really helpful when your documentation lists when a supported node was a Fraunhofer/X3DOM extension (rather than standardized X3D) so that we might diligently consider them as potential additions to X3D v3.4 and v4.0.

Updates, corrections, questions and improvements are always welcome.  Thanks for all efforts.


On 2/21/2014 4:13 AM, Limper, Max wrote:
> Dear all,
> 
>  
> 
> I was wondering whether there is any way to find out in which version of X3D a specific node was introduced?
> 
>  
> 
> Background: We’re currently writing some documentation for X3DOM, and we want to show, for each node, whether it is standardized (X3D) or not (X3DOM only). Additionally, one could then specify with which version of X3D a node was introduced. Of course, this is just a nice-to-have feature ;-)
> 
>  
> 
> Best Regards,
> 
> 
> Max
> 
>  
> 
>  
> 
> --
> 
> Dipl.-Inform. Max Limper
> 
> Visual Computing System Technologies
> 
> Fraunhofer-Institut für Graphische Datenverarbeitung IGD
> 
> Fraunhoferstraße 5 | 64283 Darmstadt
> 
> Telefon +49 6151 155-554 |Fax -196
> 
> max.limper at igd.fraunhofer.de

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