x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/Shape/PhysicalMaterial.md

@@ -15,7 +15,7 @@ tags: [PhysicalMaterial, Shape]
 
 PhysicalMaterial specifies surface rendering properties for associated geometry nodes. Material attributes are used by the X3D lighting equations during rendering.
 
-The PhysicalMaterial node belongs to the **Shape** component and its default container field is *material.* It is available since X3D version 4.0 or later.
+The PhysicalMaterial node belongs to the **Shape** component and its default container field is *material.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
@@ -31,16 +31,24 @@ The PhysicalMaterial node belongs to the **Shape** component and its default con
 
 ### 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"}
 
 ### SFColor [in, out] **baseColor** 1 1 1 <small>[0,1]</small>
 
-Similar to diffuseColor from Material.
+Similar to diffuseColor, TODO define more precisely.
 
 ### SFString [in, out] **baseTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **baseTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying baseColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -48,7 +56,7 @@ When applying baseColor for this material node, the contained texture provides P
 #### Hints
 
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='baseTexture'
+- Contained texture node must include `containerField='baseTexture'`
 
 ### SFColor [in, out] **emissiveColor** 0 0 0 <small>[0,1]</small>
 
@@ -56,18 +64,22 @@ How much glowing light is emitted from this object.
 
 #### Hints
 
-- emissiveColors glow even when all lights are off.
-- Reset diffuseColor from default (0.8 0.8 0.8) to (0 0 0) to avoid washout.
-- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
+- EmissiveColors glow even when all lights are off.
+- Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
+- Only *emissiveColor* affects IndexedLineSet, LineSet and PointSet.
 
 #### Warning
 
-- Bright emissiveColor values can wash out other colors and some textures.
+- Bright *emissiveColor* values can wash out other colors and some textures.
 
 ### SFString [in, out] **emissiveTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **emissiveTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying emissiveColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -75,20 +87,24 @@ When applying emissiveColor for this material node, the contained texture provid
 #### Hints
 
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='emissiveTexture'
+- Contained texture node must include `containerField='emissiveTexture'`
 
 ### SFFloat [in, out] **metallic** 1 <small>[0,1]</small>
 
-How metallic is the material.
+*metallic* is a PBR parameter (TODO elaborate)
 
 ### SFFloat [in, out] **roughness** 1 <small>[0,1]</small>
 
-How rough is the material.
+*roughness* is a PBR parameter (TODO elaborate)
 
 ### SFString [in, out] **metallicRoughnessTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **metallicRoughnessTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying metallic for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -96,7 +112,7 @@ When applying metallic for this material node, the contained texture provides Ph
 #### Hints
 
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='metallicRoughnessTexture'
+- Contained texture node must include `containerField='metallicRoughnessTexture'`
 
 ### SFFloat [in, out] **occlusionStrength** 1 <small>[0,1]</small>
 
@@ -105,12 +121,16 @@ When applying metallic for this material node, the contained texture provides Ph
 #### Hints
 
 - Only the Red channel of the texture is used for occlusion computations, other channels are ignored.
-- https://en.wikipedia.org/wiki/Ambient_occlusion
+- Https://en.wikipedia.org/wiki/Ambient_occlusion
 
 ### SFString [in, out] **occlusionTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **occlusionTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying occlusionStrength for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -118,7 +138,7 @@ When applying occlusionStrength for this material node, the contained texture pr
 #### Hints
 
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='occlusionTexture'
+- Contained texture node must include `containerField='occlusionTexture'`
 
 ### SFFloat [in, out] **normalScale** 1 <small>[0,∞)</small>
 
@@ -126,40 +146,44 @@ When applying occlusionStrength for this material node, the contained texture pr
 
 #### Hints
 
-- normalScale only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
-- normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping
+- *normalScale* only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
+- [NormalTexture techniques apply Bump mapping](https://en.wikipedia.org/wiki/Bump_mapping){:target="_blank"}
 
 ### SFString [in, out] **normalTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **normalTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying normalScale for this material node, the contained texture modulates the texture across the surface.
 
 #### Hints
 
-- normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping
+- [*normalTexture* techniques apply Bump mapping](https://en.wikipedia.org/wiki/Bump_mapping){:target="_blank"}
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='normalTexture'
+- Contained texture node must include `containerField='normalTexture'`
 
 ### SFFloat [in, out] **transparency** 0 <small>[0,1]</small>
 
-How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque.
+How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile hint: *transparency* \< .5 opaque, *transparency* \> .5 transparent.
 
-## Description
+## Advisories
 
 ### Hints
 
 - Insert Shape and Appearance nodes before adding material.
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-
-## External Links
-
-- [X3D Specification of PhysicalMaterial](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#PhysicalMaterial){:target="_blank"}
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 - [X3D Example Archives, Basic, Universal Media Materials](https://www.web3d.org/x3d/content/examples/Basic/UniversalMediaMaterials){:target="_blank"}
-- [3D Architecture 17.2.2 Lighting model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/lighting.html#Lightingmodel){:target="_blank"}
+- [X3D Architecture 17.2.2 Lighting model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/lighting.html#Lightingmodel){:target="_blank"}
 - [Rendering](https://en.wikipedia.org/wiki/Rendering_(computer_graphics)){:target="_blank"}
 - [3D rendering](https://en.wikipedia.org/wiki/3D_rendering){:target="_blank"}
 - [Physically based rendering (PBR)](https://en.wikipedia.org/wiki/Physically_based_rendering){:target="_blank"}
+
+## See Also
+
+- [X3D Specification of PhysicalMaterial node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#PhysicalMaterial){:target="_blank"}

package/docs/_posts/components/Shape/PointProperties.md

@@ -1,6 +1,6 @@
 ---
 title: PointProperties
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [PointProperties, Shape]
@@ -15,7 +15,7 @@ tags: [PointProperties, Shape]
 
 PointProperties allows precise fine-grained control over the rendering style of PointSet node points inside the same Shape.
 
-The PointProperties node belongs to the **Shape** component and its default container field is *pointProperties.* It is available since X3D version 4.0 or later.
+The PointProperties node belongs to the **Shape** component and its default container field is *pointProperties.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
@@ -29,15 +29,19 @@ The PointProperties node belongs to the **Shape** component and its default cont
 
 ### 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"}
 
 ### SFFloat [in, out] **pointSizeScaleFactor** 1 <small>(1,∞)</small>
 
-Nominal rendered point size is a browser-dependent minimum renderable point size, which is then multiplied by an additional (greater than or equal to 1.0) pointSizeScaleFactor.
+Nominal rendered point size is a browser-dependent minimum renderable point size, which is then multiplied by an additional *pointSizeScaleFactor* (which is greater than or equal to 1).
 
 #### Hint
 
-- Additional sizing modifications are determined by pointSizeMinValue, pointSizeMaxValue, and pointSizeAttenuation array.
+- Additional sizing modifications are determined by pointSizeMinValue, pointSizeMaxValue, and attenuation array.
 
 ### SFFloat [in, out] **pointSizeMinValue** 1 <small>[0,∞)</small>
 
@@ -45,32 +49,35 @@ Nominal rendered point size is a browser-dependent minimum renderable point size
 
 #### Warning
 
-- Maintain pointSizeMinValue\<= pointSizeMaxValue.
+- Maintain *pointSizeMinValue* \<= pointSizeMaxValue.
 
 ### SFFloat [in, out] **pointSizeMaxValue** 1 <small>(0,∞)</small>
 
-*pointSizeMaxValue* is maximum allowed scaling factor on nominal browser point scaling
+*pointSizeMaxValue* is maximum allowed scaling factor on nominal browser point scaling.
 
 #### Warning
 
-- Maintain pointSizeMinValue \<= pointSizeMaxValue.
+- Maintain pointSizeMinValue \<= *pointSizeMaxValue*.
 
 ### MFFloat [in, out] **attenuation** [ 1, 0, 0 ] <small>(0,∞)</small>
 
-*attenuation* array values [a, b, c] are set to default values if undefined. Together these parameters define attenuation factor 1/(a + b×r + c×r^2) where r is the distance from observer position (current viewpoint) to each point.
+Are set to default values if undefined. Together these parameters define *attenuation* factor 1/(a + b×r + c×r^2) where r is the distance from observer position (current viewpoint) to each point.
 
 #### Hint
 
-- Nominal point size is multiplied by attenuation factor and then clipped to a minimum value of pointSizeMinValue × minimum renderable point size, then clipped to maximum size of pointSizeMaxValue × minimum renderable point size.
+- Nominal point size is multiplied by *attenuation* factor and then clipped to a minimum value of pointSizeMinValue × minimum renderable point size, then clipped to maximum size of pointSizeMaxValue × minimum renderable point size.
 
-## Description
+## Advisories
 
 ### Hints
 
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
 - When an X3DTextureNode is defined in the same Appearance instance as PointProperties node, the points of a PointSet shall be displayed as point sprites using the given texture(s).
-- Requires X3D profile='Full' or else include \<component name='Shape' level='5'/>`
 
-## External Links
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Shape' level='5'/>`
+
+## See Also
 
-- [X3D Specification of PointProperties](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#LineProperties){:target="_blank"}
+- [X3D Specification of PointProperties node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#LineProperties){:target="_blank"}

package/docs/_posts/components/Shape/Shape.md

@@ -1,6 +1,6 @@
 ---
 title: Shape
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [Shape, Shape]
@@ -13,9 +13,9 @@ tags: [Shape, Shape]
 
 ## Overview
 
-Shape can appear under any grouping node. Shape can contain an Appearance node and a geometry node (Box Cone Cylinder ElevationGrid Extrusion IndexedFaceSet IndexedLineSet LineSet PointSet Sphere Text).
+Shape can appear under any grouping node. Shape can contain an Appearance node and a geometry node (for example one of the primitives Box Cone Cylinder Sphere Text, one of ElevationGrid Extrusion IndexedFaceSet IndexedLineSet LineSet PointSet, or one of the other geometry nodes).
 
-The Shape node belongs to the **Shape** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The Shape node belongs to the **Shape** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -30,22 +30,26 @@ The Shape node belongs to the **Shape** component and its default container fiel
 
 ### 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"}
 
 ### SFBool [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
 ### SFBool [in, out] **castShadow** TRUE
 
 *castShadow* defines whether this Shape casts shadows as produced by lighting nodes.
 
-#### Hint
+#### Hints
 
 - If the visible field is FALSE, then the Shape does not cast any shadows.
 - If prior X3D3 content is loaded into an X3D4 model, then legacy Shape nodes have shadows set to true.
@@ -62,28 +66,42 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
 
-#### Hint
+#### Hints
 
 - Can be useful for collision computations or inverse-kinematics (IK) engines.
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
+
+#### Hints
+
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFNode [in, out] **appearance** NULL <small>[X3DAppearanceNode]</small>
 
-Input/Output field appearance.
+Single contained Appearance node that can specify visual attributes (such as material, texture, fillProperties and lineProperties) applied to corresponding geometry.
 
 ### SFNode [in, out] **geometry** NULL <small>[X3DGeometryNode]</small>
 
-Input/Output field geometry.
+Single contained *geometry* node that is rendered according to corresponding appearance.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
-- You can also substitute a type-matched ProtoInstance node for contained content.
+- [Shape](https://en.wikipedia.org/wiki/Shape){:target="_blank"}
+- The Shape design pattern to collect appearance and geometry together is fundamentally the same for many types of 3D graphics software and hardware.
+- For advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
+- [X3D Architecture 12.2.1 Shape nodes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shape.html#Shapenodes){:target="_blank"}
+- [X3D Architecture 17.2.2 Lighting model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/lighting.html#Lightingmodel){:target="_blank"}
+- Apply `containerField='shape'` if parent node is CADFace.
 
-## External Links
+## See Also
 
-- [X3D Specification of Shape](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Shape){:target="_blank"}
+- [X3D Specification of Shape node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Shape){:target="_blank"}

package/docs/_posts/components/Shape/TwoSidedMaterial.md

@@ -1,6 +1,6 @@
 ---
 title: TwoSidedMaterial
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [TwoSidedMaterial, Shape]
@@ -15,9 +15,9 @@ tags: [TwoSidedMaterial, Shape]
 
 TwoSidedMaterial specifies surface rendering properties for associated geometry nodes, for outer (front) and inner (back) sides of polygons. Material attributes are used by the X3D lighting equations during rendering.
 
-The TwoSidedMaterial node belongs to the **Shape** component and its default container field is *material.* It is available since X3D version 3.2 until 4.0.
+The TwoSidedMaterial node belongs to the **Shape** component and its default container field is *material.* It is available from X3D version 3.2 to 4.0.
 
->Deprecated: This node is deprecated since X3D version 4.0. Future versions of the standard may remove this node.
+>Deprecated: This node is deprecated as of X3D version 4.0. Future versions of the standard may remove this node.
 {: .prompt-danger }
 
 ## Hierarchy
@@ -33,7 +33,11 @@ The TwoSidedMaterial node belongs to the **Shape** component and its default con
 
 ### 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"}
 
 ### SFBool [in, out] **separateBackColor** FALSE
 
@@ -41,7 +45,7 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 #### Warning
 
-- Backface Material values are ignored unless you set separateBackColor='true'
+- Backface Material values are ignored unless you set *separateBackColor*='true'
 
 ### SFFloat [in, out] **ambientIntensity** 0.2 <small>[0,1]</small>
 
@@ -51,9 +55,9 @@ How much ambient omnidirectional light is reflected from all light sources. Inte
 
 How much direct, angle-dependent light is reflected from all light sources.
 
-#### Hints
+#### Hint
 
-- Only emissiveColor affects IndexedLineSet, LineSet and PointSet. If a texture is present the diffuseColor is always multiplied with the texture color, in contrast to the specification. Set diffuseColor to (1 1 1) to get maximum texture color intensity.
+- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
 
 ### SFColor [in, out] **specularColor** 0 0 0 <small>[0,1]</small>
 
@@ -65,27 +69,21 @@ How much glowing light is emitted from this object.
 
 #### Hints
 
-- EmissiveColors glow even when all lights are off. Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout. Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
+- EmissiveColors glow even when all lights are off.
+- Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
+- Only *emissiveColor* affects IndexedLineSet, LineSet and PointSet.
 
 #### Warning
 
-- Bright emissiveColor values can wash out other colors and some textures.
+- Bright *emissiveColor* values can wash out other colors and some textures.
 
 ### SFFloat [in, out] **shininess** 0.2 <small>[0,1]</small>
 
-Lower shininess values provide soft specular glows, while higher values result in sharper, smaller highlights. Interchange profile hint: this field may be ignored, applying the default value regardless.
+Lower *shininess* values provide soft specular glows, while higher values result in sharper, smaller highlights. Interchange profile hint: this field may be ignored, applying the default value regardless.
 
 ### SFFloat [in, out] **transparency** 0 <small>[0,1]</small>
 
-How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque.
-
-#### Interchange profile hint:
-
-Transparency < .5 opaque, transparency > .5 transparent.
-
-#### Hint
-
-- If a texture is present the transparency is always multiplied with the texture's transparency, in contrast to the specification. Set transparency to (0) to get a full opaque texture color.
+How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile hint: *transparency* \< .5 opaque, *transparency* \> .5 transparent.
 
 ### SFFloat [in, out] **backAmbientIntensity** 0.2 <small>[0,1]</small>
 
@@ -95,9 +93,9 @@ How much ambient omnidirectional light is reflected from all light sources. Inte
 
 How much direct, angle-dependent light is reflected from all light sources.
 
-#### Hints
+#### Hint
 
-- Only emissiveColor affects IndexedLineSet, LineSet and PointSet. If a texture is present the diffuseColor is always multiplied with the texture color, in contrast to the specification. Set diffuseColor to (1 1 1) to get maximum texture color intensity.
+- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
 
 ### SFColor [in, out] **backSpecularColor** 0 0 0 <small>[0,1]</small>
 
@@ -109,7 +107,9 @@ How much glowing light is emitted from this object.
 
 #### Hints
 
-- EmissiveColors glow even when all lights are off. Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout. Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
+- EmissiveColors glow even when all lights are off.
+- Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
+- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
 
 #### Warning
 
@@ -121,29 +121,28 @@ Lower shininess values provide soft specular glows, while higher values result i
 
 ### SFFloat [in, out] **backTransparency** 0 <small>[0,1]</small>
 
-How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque.
-
-#### Interchange profile hint
-
-Transparency < .5 opaque, transparency > .5 transparent.
-
-#### Hint
+How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile hint: transparency \< .5 opaque, transparency \> .5 transparent.
 
-- If a texture is present the transparency is always multiplied with the texture's transparency, in contrast to the specification. Set transparency to (0) to get a full opaque texture color.
-
-## Description
+## Advisories
 
 ### Hints
 
-- Include `<component name='Shape' level='4'/>`
 - Insert Shape and Appearance nodes before adding material.
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+- [X3D Architecture 12.2.3 Two-sided materials](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shape.html#TwoSidedMaterials){:target="_blank"}
+- [X3D Architecture 17.2.2 Lighting model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/lighting.html#Lightingmodel){:target="_blank"}
+
+### Warnings
+
+- Requires X3D `profile='Full'` or else include `<component name='Shape' level='4'/>`
+- Corresponding geometry within the parent Shape must have solid='false' for two-sided rendering, otherwise no reverse-side back geometry is displayed.
+- X3D4 Architecture has deprecated TwoSidedMaterial, preferring use of child backMaterial node in parent Appearance.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Shape/TwoSidedMaterial/TwoSidedMaterial.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of TwoSidedMaterial](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#TwoSidedMaterial){:target="_blank"}
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+- [X3D Specification of TwoSidedMaterial node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#TwoSidedMaterial){:target="_blank"}

package/docs/_posts/components/Shape/UnlitMaterial.md

@@ -15,7 +15,7 @@ tags: [UnlitMaterial, Shape]
 
 UnlitMaterial specifies surface rendering properties for associated geometry nodes. Material attributes are used by the X3D lighting equations during rendering.
 
-The UnlitMaterial node belongs to the **Shape** component and its default container field is *material.* It is available since X3D version 4.0 or later.
+The UnlitMaterial node belongs to the **Shape** component and its default container field is *material.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The UnlitMaterial node belongs to the **Shape** 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.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFColor [in, out] **emissiveColor** 1 1 1 <small>[0,1]</small>
 
@@ -39,18 +43,22 @@ How much glowing light is emitted from this object.
 
 #### Hints
 
-- emissiveColors glow even when all lights are off.
-- Reset diffuseColor from default (0.8 0.8 0.8) to (0 0 0) to avoid washout.
-- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
+- EmissiveColors glow even when all lights are off.
+- Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
+- Only *emissiveColor* affects IndexedLineSet, LineSet and PointSet.
 
 #### Warning
 
-- Bright emissiveColor values can wash out other colors and some textures.
+- Bright *emissiveColor* values can wash out other colors and some textures.
 
 ### SFString [in, out] **emissiveTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **emissiveTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying emissiveColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -58,7 +66,7 @@ When applying emissiveColor for this material node, the contained texture provid
 #### Hints
 
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='emissiveTexture'
+- Contained texture node must include `containerField='emissiveTexture'`
 
 ### SFFloat [in, out] **normalScale** 1 <small>[0,∞)</small>
 
@@ -66,37 +74,37 @@ When applying emissiveColor for this material node, the contained texture provid
 
 #### Hints
 
-- normalScale only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
-- normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping
+- *normalScale* only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
+- [NormalTexture techniques apply Bump mapping](https://en.wikipedia.org/wiki/Bump_mapping){:target="_blank"}
 
 ### SFString [in, out] **normalTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **normalTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying normalScale for this material node, the contained texture modulates the texture across the surface.
 
 #### Hints
 
-- normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping
+- [*normalTexture* techniques apply Bump mapping](https://en.wikipedia.org/wiki/Bump_mapping){:target="_blank"}
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='normalTexture'
+- Contained texture node must include `containerField='normalTexture'`
 
 ### SFFloat [in, out] **transparency** 0 <small>[0,1]</small>
 
-How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque.
+How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile hint: *transparency* \< .5 opaque, *transparency* \> .5 transparent.
 
-## Description
+## Advisories
 
 ### Hints
 
 - Insert Shape and Appearance nodes before adding material.
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-
-## External Links
-
-- [X3D Specification of UnlitMaterial](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#UnlitMaterial){:target="_blank"}
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 - [X3D Example Archives, Basic, Universal Media Materials](https://www.web3d.org/x3d/content/examples/Basic/UniversalMediaMaterials){:target="_blank"}
 - [X3D Architecture 17.2.2 Lighting model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/lighting.html#Lightingmodel){:target="_blank"}
@@ -105,3 +113,7 @@ How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaqu
 - [Physically based rendering (PBR)](https://en.wikipedia.org/wiki/Physically_based_rendering){:target="_blank"}
 - [Non-photorealistic rendering (NPR)](https://en.wikipedia.org/wiki/Non-photorealistic_rendering){:target="_blank"}
 - [Cel shading (toon shading)](https://en.wikipedia.org/wiki/Cel_shading){:target="_blank"}
+
+## See Also
+
+- [X3D Specification of UnlitMaterial node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#UnlitMaterial){:target="_blank"}