x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/Geometry3D/Cone.md

@@ -1,6 +1,6 @@
 ---
 title: Cone
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geometry3D
 categories: [components, Geometry3D]
 tags: [Cone, Geometry3D]
@@ -15,7 +15,7 @@ tags: [Cone, Geometry3D]
 
 Cone is a geometry node.
 
-The Cone node belongs to the **Geometry3D** component and its default container field is *geometry.* It is available since X3D version 2.0 or later.
+The Cone node belongs to the **Geometry3D** component and its default container field is *geometry.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -29,62 +29,70 @@ The Cone node belongs to the **Geometry3D** component and its default container
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
 
-### SFBool [in, out] **side** TRUE
+#### Hint
 
-Whether to draw sides (other inside faces are not drawn).
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
-#### Warning
+### SFBool [in, out] **side** TRUE
 
-- Cannot be changed after initial creation.
+Whether to draw sides (other inside faces are not drawn).
 
 ### SFBool [in, out] **bottom** TRUE
 
-Whether to draw bottom (other inside faces are not drawn).
-
-#### Warning
-
-- Cannot be changed after initial creation.
+Whether to draw *bottom* (other inside faces are not drawn).
 
 ### SFFloat [ ] **height** 2 <small>(0,∞)</small>
 
 Size in meters.
 
+#### Hint
+
+- For size animation, modify the scale of a parent/ancestor Transform node instead.
+
 #### Warning
 
-- Simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for animation use Transform scale instead.
+- Simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, avoiding the need for potentially expensive tessellation at run time.
 
 ### SFFloat [ ] **bottomRadius** 1 <small>(0,∞)</small>
 
 Size in meters.
 
+#### Hint
+
+- For size animation, modify the scale of a parent/ancestor Transform node instead.
+
 #### Warning
 
-- Simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for animation use Transform scale instead.
+- Simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, avoiding the need for potentially expensive tessellation at run time.
 
 ### SFBool [ ] **solid** TRUE
 
-Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
+Setting *solid* true means draw only one side of polygons (backface culling on), setting *solid* false means draw both sides of polygons (backface culling off).
 
-#### Hint
+#### Hints
 
-- If in doubt, use solid='false' for maximum visibility.
+- Mnemonic "this geometry is *solid* like a brick" (you don't render the inside of a brick).
+- If in doubt, use *solid*='false' for maximum visibility.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and visualization.
 
 #### Warnings
 
-- Default value true can completely hide geometry if viewed from wrong side! Solid false not supported in VRML97.
+- Default value true can completely hide geometry if viewed from wrong side!
+- *solid* false not supported in VRML97.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
+- [Cone](https://en.wikipedia.org/wiki/Cone){:target="_blank"}
 - Insert a Shape node before adding geometry or Appearance.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Geometry3D/Cone/Cone.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of Cone](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geometry3D.html#Cone){:target="_blank"}
+- [X3D Specification of Cone node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geometry3D.html#Cone){:target="_blank"}

package/docs/_posts/components/Geometry3D/Cylinder.md

@@ -1,6 +1,6 @@
 ---
 title: Cylinder
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geometry3D
 categories: [components, Geometry3D]
 tags: [Cylinder, Geometry3D]
@@ -15,7 +15,7 @@ tags: [Cylinder, Geometry3D]
 
 Cylinder is a geometry node.
 
-The Cylinder node belongs to the **Geometry3D** component and its default container field is *geometry.* It is available since X3D version 2.0 or later.
+The Cylinder node belongs to the **Geometry3D** component and its default container field is *geometry.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -29,70 +29,74 @@ The Cylinder node belongs to the **Geometry3D** component and its default contai
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
 
-### SFBool [in, out] **top** TRUE
+#### Hint
 
-Whether to draw top (inside faces are never drawn).
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
-#### Warning
+### SFBool [in, out] **top** TRUE
 
-- Cannot be changed after initial creation.
+Whether to draw *top* (inside faces are never drawn).
 
 ### SFBool [in, out] **side** TRUE
 
 Whether to draw sides (inside faces are never drawn).
 
-#### Warning
-
-- Cannot be changed after initial creation.
-
 ### SFBool [in, out] **bottom** TRUE
 
-Whether to draw bottom (inside faces are never drawn).
-
-#### Warning
-
-- Cannot be changed after initial creation.
+Whether to draw *bottom* (inside faces are never drawn).
 
 ### SFFloat [ ] **height** 2 <small>(0,∞)</small>
 
 Size in meters.
 
+#### Hint
+
+- For size animation, modify the scale of a parent/ancestor Transform node instead.
+
 #### Warning
 
-- Simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for animation use Transform scale instead.
+- Simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, avoiding the need for potentially expensive tessellation at run time.
 
 ### SFFloat [ ] **radius** 1 <small>(0,∞)</small>
 
 Size in meters.
 
+#### Hint
+
+- For size animation, modify the scale of a parent/ancestor Transform node instead.
+
 #### Warning
 
-- Simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, for animation use Transform scale instead.
+- Simple-geometry dimensions are initializeOnly and cannot be changed after initial creation, avoiding the need for potentially expensive tessellation at run time.
 
 ### SFBool [ ] **solid** TRUE
 
-Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
+Setting *solid* true means draw only one side of polygons (backface culling on), setting *solid* false means draw both sides of polygons (backface culling off).
 
-#### Hint
+#### Hints
 
-- If in doubt, use solid='false' for maximum visibility.
+- Mnemonic "this geometry is *solid* like a brick" (you don't render the inside of a brick).
+- If in doubt, use *solid*='false' for maximum visibility.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and visualization.
 
 #### Warnings
 
-- Default value true can completely hide geometry if viewed from wrong side! Solid false not supported in VRML97.
+- Default value true can completely hide geometry if viewed from wrong side!
+- *solid* false not supported in VRML97.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
+- [Cylinder](https://en.wikipedia.org/wiki/Cylinder){:target="_blank"}
 - Insert a Shape node before adding geometry or Appearance.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Geometry3D/Cylinder/Cylinder.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of Cylinder](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geometry3D.html#Cylinder){:target="_blank"}
+- [X3D Specification of Cylinder node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geometry3D.html#Cylinder){:target="_blank"}

package/docs/_posts/components/Geometry3D/ElevationGrid.md

@@ -1,6 +1,6 @@
 ---
 title: ElevationGrid
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Geometry3D
 categories: [components, Geometry3D]
 tags: [ElevationGrid, Geometry3D]
@@ -15,7 +15,7 @@ tags: [ElevationGrid, Geometry3D]
 
 ElevationGrid is a geometry node defining a rectangular height field, with default values for a 1m by 1m square at height 0. Vertices corresponding to ElevationGrid height values define quadrilaterals, which are placed above or below a flat surface.
 
-The ElevationGrid node belongs to the **Geometry3D** component and its default container field is *geometry.* It is available since X3D version 2.0 or later.
+The ElevationGrid node belongs to the **Geometry3D** component and its default container field is *geometry.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -29,31 +29,55 @@ The ElevationGrid node belongs to the **Geometry3D** component and its default c
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### MFFloat [in] **set_height** <small>(-∞,∞)</small>
 
-Grid array of height vertices with upward direction along +Y axis, with xDimension rows and zDimension columns.
+Grid array of *height* vertices with upward direction along +Y axis, with xDimension rows and zDimension columns.
 
 #### Hint
 
-- Height array values are given in row-major order from left to right along X axis, then back to front along Z axis.
+- *height* array values are given in row-major order from left to right along X axis, then back to front along Z axis.
+
+#### Warning
+
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
 ### SFInt32 [ ] **xDimension** 0 <small>[0,∞)</small>
 
 Number of elements in the height array along X direction.
 
+#### Hint
+
+- Total horizontal x-axis distance equals (*xDimension*-1) * xSpacing.
+
+#### Warning
+
+- *xDimension* \< 2 means that ElevationGrid contains no quadrilaterals.
+
 ### SFInt32 [ ] **zDimension** 0 <small>[0,∞)</small>
 
 Number of elements in the height array along Z direction.
 
+#### Hint
+
+- Total horizontal z-axis distance equals (*zDimension*-1) * zSpacing.
+
+#### Warning
+
+- *zDimension* \< 2 means that ElevationGrid contains no quadrilaterals.
+
 ### SFFloat [ ] **xSpacing** 1 <small>(0,∞)</small>
 
 Meters distance between grid-array vertices along X direction.
 
 #### Hint
 
-- Total horizontal x-axis distance equals (xDimension-1) \* xSpacing.
+- Total horizontal x-axis distance equals (xDimension-1) * *xSpacing*.
 
 ### SFFloat [ ] **zSpacing** 1 <small>(0,∞)</small>
 
@@ -61,15 +85,17 @@ Meters distance between grid-array vertices along Z direction.
 
 #### Hint
 
-- Total lateral z-axis distance equals (zDimension-1) \* zSpacing.
+- Total lateral z-axis distance equals (zDimension-1) * *zSpacing*.
 
 ### SFBool [ ] **solid** TRUE
 
-Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
+Setting *solid* true means draw only one side of polygons (backface culling on), setting *solid* false means draw both sides of polygons (backface culling off).
 
-#### Hint
+#### Hints
 
-- If in doubt, use solid='false' for maximum visibility.
+- Mnemonic "this geometry is *solid* like a brick" (you don't render the inside of a brick).
+- If in doubt, use *solid*='false' for maximum visibility.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and visualization.
 
 #### Warning
 
@@ -77,35 +103,45 @@ Setting solid true means draw only one side of polygons (backface culling on), s
 
 ### SFBool [ ] **ccw** TRUE
 
-*ccw* = counterclockwise: ordering of vertex coordinates orientation.
+*ccw* defines clockwise/counterclockwise ordering of vertex coordinates, which in turn defines front/back orientation of polygon normals according to Right-Hand Rule (RHR).
 
-#### Hint
+#### Hints
 
-- *ccw* false can reverse solid (backface culling) and normal-vector orientation.
+- A good debugging technique for problematic polygons is to try changing the value of *ccw*, which can reverse solid effects (single-sided backface culling) and normal-vector direction.
+- [Clockwise](https://en.wikipedia.org/wiki/Clockwise){:target="_blank"}
+
+#### Warning
+
+- Consistent and correct ordering of left-handed or right-handed point sequences is important throughout the coord array of point values.
 
 ### SFFloat [ ] **creaseAngle** 0 <small>[0,∞)</small>
 
-*creaseAngle* defines angle (in radians) for determining whether adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than creaseAngle, smooth shading is rendered across the shared line segment.
+*creaseAngle* defines angle (in radians) for determining whether adjacent polygons are drawn with sharp edges or smooth shading. If angle between normals of two adjacent polygons is less than *creaseAngle*, smooth shading is rendered across the shared line segment.
 
-#### Hint
+#### Hints
 
-- CreaseAngle=0 means render all edges sharply, creaseAngle=3.14159 means render all edges smoothly.
+- *creaseAngle*=0 means render all edges sharply, *creaseAngle*=3.14159 means render all edges smoothly.
+- [Radian units for angular measure](https://en.wikipedia.org/wiki/Radian){:target="_blank"}
 
 ### SFBool [ ] **colorPerVertex** TRUE
 
-Whether Color node color values are applied to each vertex (true) or per quadrilateral (false).
+Whether Color node color values are applied to each point vertex (true) or per quadrilateral (false).
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
 ### SFBool [ ] **normalPerVertex** TRUE
 
-Whether Normal node vector values are applied to each vertex (true) or per quadrilateral (false).
+Whether Normal node vector values are applied to each point vertex (true) or per quadrilateral (false).
+
+#### Hint
+
+- If no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
 
 ### MFNode [in, out] **attrib** [ ] <small>[X3DVertexAttributeNode]</small>
 
-Multiple contained FloatVertexAttribute nodes that can specify list of per-vertex attribute information for programmable shaders.
+Single contained FloatVertexAttribute node that can specify list of per-vertex attribute information for programmable shaders.
 
 #### Hint
 
@@ -117,7 +153,7 @@ Single contained FogCoordinate node that can specify depth parameters for fog in
 
 ### SFNode [in, out] **color** NULL <small>[X3DColorNode]</small>
 
-Single contained Color or ColorRGBA node that can specify color values applied to corresponding vertices according to colorIndex and colorPerVertex fields.
+Single contained Color or ColorRGBA node that can specify *color* values applied to corresponding vertices according to colorPerVertex field.
 
 ### SFNode [in, out] **texCoord** NULL <small>[X3DTextureCoordinateNode]</small>
 
@@ -131,23 +167,31 @@ Single contained Normal node that can specify perpendicular vectors for correspo
 
 - Useful for special effects. Normal vector computation by 3D graphics hardware is quite fast so adding normals to a scene is typically unnecessary.
 
+#### Warning
+
+- *normal* vectors increase file size, typically doubling geometry definitions.
+
 ### MFFloat [ ] **height** [ ] <small>(-∞,∞)</small>
 
-Grid array of height vertices with upward direction along +Y axis, with xDimension rows and zDimension columns.
+Grid array of *height* vertices with upward direction along +Y axis, with xDimension rows and zDimension columns.
 
 #### Hint
 
-- Height array values are given in row-major order from left to right along X axis, then back to front along Z axis.
+- *height* array values are given in row-major order from left to right along X axis, then back to front along Z axis.
+
+#### Warning
+
+- *height* array values are not retained or available at run time since a browser is permitted to condense geometry.
 
-## Description
+## Advisories
 
 ### Hints
 
-- The height array defines (xDimension-1)\*(zDimension-1) quadrilaterals.
+- The height array defines (xDimension-1)*(zDimension-1) quadrilaterals.
 - Positive direction for normal of each triangle is on same side of the quadrilateral. Triangles are defined either counterclockwise or clockwise depending on value of ccw field.
-- ElevationGrid can contain Color/ColorRGBA, Normal and TextureCoordinate nodes.
+- ElevationGrid can contain Color or ColorRGBA, Normal and TextureCoordinate nodes.
 - Insert a Shape node before adding geometry or Appearance.
-- You can also substitute a type-matched ProtoInstance node for contained content.
+- For advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
 
 ### Warning
 
@@ -157,6 +201,6 @@ Grid array of height vertices with upward direction along +Y axis, with xDimensi
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Geometry3D/ElevationGrid/ElevationGrid.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ElevationGrid](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geometry3D.html#ElevationGrid){:target="_blank"}
+- [X3D Specification of ElevationGrid node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geometry3D.html#ElevationGrid){:target="_blank"}