[x3d-public] Metadata tooltips for X3D 4.0

[Brutzman, Donald (Don) (CIV)]

Thanks.  I have updated all six of the Metadata node containerField
tooltips, noting changed default and adding a corresponding warning.

 

*
https://www.web3d.org/x3d/content/X3dTooltips.html#MetadataString.containerF
ield

 


 
<https://www.web3d.org/x3d/content/X3dTooltips.html#MetadataString.container
Field> containerField

[containerField
<https://www.web3d.org/x3d/content/X3dTooltips.html#NMTOKEN> type NMTOKEN
"metadata" is X3D3 default, "value" is X3D4 default]
containerField is a field-label prefix indicating this node's field
relationship to its parent node, for example <Transform><Shape
containerField='children'/></Transform>.
Hint: default containerField values for each node are correct in most cases,
so the need to override default containerField values is rare.
Hint: set containerField="value" when part of a MetadataSet payload,
otherwise use default value "metadata" when providing information about a
parent node itself.
Warning: X3D3 default is 'metadata' while X3D4 default is 'value' in order
to support terseness of MetadataSet collections in X3D4.
Warning: containerField attribute is only part of XML encoding for X3D
scenes, and corresponds to the always-declared field names in the
ClassicVRML and VRML97 file encodings.
Hint: USE node instances are allowed to have a containerField value that is
different than the corresponding DEF declaration of that node.
Hint: X3D Scene Authoring Hints, containerField
<https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#cont
ainerField>
https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#conta
inerField

 

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

 

-----Original Message-----
From: x3d-public <x3d-public-bounces at web3d.org> On Behalf Of Andreas Plesch
Sent: Tuesday, October 31, 2023 9:20 AM
To: X3D Graphics public mailing list <x3d-public at web3d.org>
Subject: [x3d-public] Metadata tooltips for X3D 4.0

 

The tooltips for Metadata nodes mention in a warning that in X3D 4.0 the
default value for the containerField attribute changed to 'value'

but actual description of the attribute still has 'metadata' as the default
value:

 

 
<https://www.web3d.org/x3d/content/X3dTooltips.html#MetadataString.container
Field>
https://www.web3d.org/x3d/content/X3dTooltips.html#MetadataString.containerF
ield

 

is an example but all Metadata node tooltips are affected.

 

-Andreas

 

--

Andreas Plesch

Waltham, MA 02453

 

_______________________________________________

x3d-public mailing list

 <mailto:x3d-public at web3d.org> x3d-public at web3d.org

 <http://web3d.org/mailman/listinfo/x3d-public_web3d.org>
http://web3d.org/mailman/listinfo/x3d-public_web3d.org

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20231031/86ff28c5/attachment-0001.html>
-------------- 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/20231031/86ff28c5/attachment-0001.p7s>