x_ite 8.8.7 → 8.9.1

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

@@ -1,6 +1,6 @@
 ---
 title: Appearance
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [Appearance, Shape]
@@ -13,9 +13,9 @@ tags: [Appearance, Shape]
 
 ## Overview
 
-Appearance specifies the visual properties of geometry by containing the Material, ImageTexture/MovieTexture/PixelTexture, FillProperties, LineProperties, and TextureTransform nodes.
+Appearance specifies the visual properties of geometry by containing the Material, ImageTexture/MovieTexture/PixelTexture, FillProperties, LineProperties, programmable shader nodes (ComposedShader, PackagedShader, ProgramShader) and TextureTransform nodes.
 
-The Appearance node belongs to the **Shape** component and its default container field is *appearance.* It is available since X3D version 2.0 or later.
+The Appearance node belongs to the **Shape** component and its default container field is *appearance.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -29,15 +29,23 @@ The Appearance node belongs to the **Shape** 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.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
+
+### SFNode [in, out] **acousticProperties** NULL <small>[AcousticProperties]</small>
+
+Single contained *acousticProperties* node that can specify additional acoustic attributes applied to associated surface geometry.
 
 ### SFString [in, out] **alphaMode** "AUTO" <small>["AUTO"|"OPAQUE"|"MASK"|"BLEND"]</small>
 
-Provides options for control of alpha transparency handling for textures. AUTO means Material transparency is applied to texture transparency for full backwards compatibility with X3D3, OPAQUE means ignore alpha transparency to render texture as opaque, MASK means alpha-testing of pixels as fully transparent when alpha value is less than alphaCutoff and fully opaque when alpha value is greater than or equal to alphaCutoff, BLEND combines partial transparency of textures and materials.
+Provides options for control of alpha transparency handling for textures. AUTO means Material transparency is applied to texture transparency for full backwards compatility with X3D3, OPAQUE means ignore alpha transparency to render texture as opaque, MASK means alpha-testing of pixels as fully transparent when alpha value is less than alphaCutoff and fully opaque when alpha value is greater than or equal to alphaCutoff, BLEND combines partial transparency of textures and materials.
 
 #### Hint
 
-- [glTF version 2 Alpha Coverage](https://www.khronos.org/registry/glTF/specs/2.0/glTF-2.0.html#alpha-coverage){:target="_blank"}
+- [GlTF version 2 Alpha Coverage](https://www.khronos.org/registry/glTF/specs/2.0/glTF-2.0.html#alpha-coverage){:target="_blank"}
 
 ### SFFloat [in, out] **alphaCutoff** 0.5 <small>[0,1]</small>
 
@@ -45,7 +53,7 @@ Threshold value used for pixel rendering either transparent or opaque, used when
 
 #### Hint
 
-- [glTF version 2 Alpha Coverage](https://www.khronos.org/registry/glTF/specs/2.0/glTF-2.0.html#alpha-coverage){:target="_blank"}
+- [GlTF version 2 Alpha Coverage](https://www.khronos.org/registry/glTF/specs/2.0/glTF-2.0.html#alpha-coverage){:target="_blank"}
 
 ### SFNode [in, out] **pointProperties** NULL <small>[PointProperties]</small>
 
@@ -65,30 +73,31 @@ Single contained Material node that can specify visual attributes for lighting r
 
 #### Warning
 
-- If material is NULL or unspecified, lighting is off (all lights ignored) for this Shape and unlit object color is (1, 1, 1).
+- If *material* is NULL or unspecified, lighting is off (all lights ignored) for this Shape and unlit object color is (1, 1, 1).
 
 ### SFNode [in, out] **backMaterial** NULL <small>[X3DOneSidedMaterialNode]</small>
 
-Single contained Material node that can specify visual attributes for lighting response (color types, transparency, etc.) applied to corresponding geometry.
+Input/Output field *backMaterial*.
 
 ### SFNode [in, out] **texture** NULL <small>[X3DTextureNode]</small>
 
-Single contained texture node (ImageTexture, MovieTexture, PixelTexture, MultiTexture) that maps image(s) to surface geometry.
+Single contained *texture* node (ImageTexture, MovieTexture, PixelTexture, MultiTexture) that maps image(s) to surface geometry.
 
 #### Hints
 
-- If texture node is NULL or unspecified, corresponding Shape geometry for this Appearance is not textured.
+- If *texture* node is NULL or unspecified, corresponding Shape geometry for this Appearance is not textured.
 - [X3D Scene Authoring Hints, Images](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images){:target="_blank"}
-- [3D Architecture 18 Texturing component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html){:target="_blank"}
+- [X3D Architecture 18 Texturing component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html){:target="_blank"}
 - [X3D Architecture 33 Texturing3D component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texture3D.html){:target="_blank"}
 
 ### SFNode [in, out] **textureTransform** NULL <small>[X3DTextureTransformNode]</small>
 
 Single contained TextureTransform node that defines 2D transformation applied to texture coordinates.
 
-#### Hint
+#### Hints
 
-- If textureTransform array is empty, then this field has no effect.
+- Texture coordinates are reapplied (or else recomputed if *textureTransform* field initially NULL) whenever the corresponding vertex-based geometry changes.
+- If *textureTransform* array is empty, then this field has no effect.
 
 ### MFNode [in, out] **shaders** [ ] <small>[X3DShaderNode]</small>
 
@@ -96,28 +105,26 @@ Zero or more contained programmable shader nodes (ComposedShader, PackagedShader
 
 #### Hint
 
-- [X3D Architecture 31 Programmable shaders component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shaders.html){:target="_blank"}
+- [X3D Architecture 31 Programmable *shaders* component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/*shaders*.html){:target="_blank"}
 
 ### SFNode [in, out] **blendMode** NULL <small>[BlendMode]</small> <small class="yellow">non standard</small>
 
 Single contained BlendMode node that defines blend mode properties.
 
-### SFNode [in, out] **acousticProperties** NULL <small>[AcousticProperties]</small>
-
-Single contained acousticProperties node that can specify additional acoustic attributes applied to associated surface geometry.
-
-## Description
+## Advisories
 
 ### Hints
 
 - Insert a Shape node before adding geometry or Appearance. Interchange profile hint: only Material and ImageTexture children are allowed.
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
 - Advanced uses can contain MultiTexture, MultiTextureTransform/TextureTransformMatrix3D/TextureTransform3D, ComposedShader/PackagedShader/ProgramShader, ComposedTexture3D/ImageTexture3D/PixelTexture3D, or ComposedCubeMapTexture/GeneratedCubeMapTexture/ImageCubeMapTexture.
+- [X3D Architecture 12.2.2 Appearance node](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shape.html#Appearancenode){: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"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Shape/Appearance/Appearance.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of Appearance](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Appearance){:target="_blank"}
+- [X3D Specification of Appearance node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Appearance){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: FillProperties
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [FillProperties, Shape]
@@ -15,7 +15,7 @@ tags: [FillProperties, Shape]
 
 FillProperties indicates whether appearance is filled or hatched for associated geometry nodes inside the same Shape. Hatches are applied on top of the already rendered appearance of the node, and are not affected by lighting.
 
-The FillProperties node belongs to the **Shape** component and its default container field is *fillProperties.* It is available since X3D version 3.0 or later.
+The FillProperties node belongs to the **Shape** component and its default container field is *fillProperties.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -29,39 +29,46 @@ The FillProperties node belongs to the **Shape** component and its default conta
 
 ### 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] **filled** TRUE
 
-Whether or not associated geometry is filled.
+Whether or not associated geometry is *filled*.
 
 ### SFBool [in, out] **hatched** TRUE
 
-Whether or not associated geometry is hatched.
+Whether or not associated geometry is *hatched*.
 
 ### SFInt32 [in, out] **hatchStyle** 1 <small>[0,∞)</small>
 
-*hatchStyle* selects a hatch pattern from International Register of Graphical Items. 1=Horizontal equally spaced parallel lines. 2=Vertical equally spaced parallel lines. 3=Positive slope equally spaced parallel lines. 4=Negative slope equally spaced parallel lines. 5=Horizontal/vertical crosshatch. 6=Positive slope/negative slope crosshatch. 7=(cast iron or malleable iron and general use for all materials). 8=(steel). 9=(bronze, brass, copper, and compositions). 10=(white metal, zinc, lead, babbit, and alloys). 11=(magnesium, aluminum, and aluminum alloys). 12=(rubber, plastic, and electrical insulation). 13=(cork, felt, fabric, leather, and fibre). 14=(thermal insulation). 15=(titanium and refi-actory material). 16=(marble, slate, porcelain, glass, etc.). 17=(earth). 18=(sand). 19=(repeating dot).
+*hatchStyle* selects a hatch pattern from ISO/IEC 9973 International Register of Graphical Items. 1=Horizontal equally spaced parallel lines. 2=Vertical equally spaced parallel lines. 3=Positive slope equally spaced parallel lines. 4=Negative slope equally spaced parallel lines. 5=Horizontal/vertical crosshatch. 6=Positive slope/negative slope crosshatch. 7=(cast iron or malleable iron and general use for all materials). 8=(steel). 9=(bronze, brass, copper, and compositions). 10=(white metal, zinc, lead, babbit, and alloys). 11=(magnesium, aluminum, and aluminum alloys). 12=(rubber, plastic, and electrical insulation). 13=(cork, felt, fabric, leather, and fibre). 14=(thermal insulation). 15=(titanium and refi-actory material). 16=(marble, slate, porcelain, glass, etc.). 17=(earth). 18=(sand). 19=(repeating dot).
 
 #### Hint
 
-- Detailed descriptions of hatchstyle values are found at the [ISO/IEC International Register of Graphical Items](https://www.iso.org/jtc1/sc24/register){:target="_blank"} (may require login)
+- [Detailed descriptions of hatchstyle values are found at the ISO/IEC 9973 International Register of Graphical Items](https://www.iso.org/jtc1/sc24/register){:target="_blank"} [](https://isotc.iso.org/livelink/livelink/fetch/-8916524/8916549/8916590/6208440/class_pages/hatchstyle.html){:target="_blank"}
 
 ### SFColor [in, out] **hatchColor** 1 1 1 <small>[0,1]</small>
 
 Color of the hatch pattern.
 
-## Description
+## Advisories
 
-### Hints
+### Hint
 
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-- Include `<component name='Shape' level='3'/>`
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Shape' level='3'/>`
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Shape/FillProperties/FillProperties.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of FillProperties](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#FillProperties){:target="_blank"}
+- [X3D Specification of FillProperties node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#FillProperties){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: LineProperties
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [LineProperties, Shape]
@@ -13,9 +13,9 @@ tags: [LineProperties, Shape]
 
 ## Overview
 
-LineProperties allows fine control over rendering of lines and edges for associated geometry nodes inside the same Shape.
+LineProperties allows precise fine-grained control over the rendering style of lines and edges for associated geometry nodes inside the same Shape.
 
-The LineProperties node belongs to the **Shape** component and its default container field is *lineProperties.* It is available since X3D version 3.0 or later.
+The LineProperties node belongs to the **Shape** component and its default container field is *lineProperties.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -29,11 +29,15 @@ The LineProperties node belongs to the **Shape** component and its default conta
 
 ### 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] **applied** TRUE
 
-Whether or not LineProperties are applied to associated geometry.
+Whether or not LineProperties are *applied* to associated geometry.
 
 ### SFInt32 [in, out] **linetype** 1 <small>[1,∞)</small>
 
@@ -41,23 +45,27 @@ Whether or not LineProperties are applied to associated geometry.
 
 #### Hint
 
-- Detailed descriptions of lineType values are found at the [ISO/IEC International Register of Graphical Items](https://www.iso.org/jtc1/sc24/register){:target="_blank"} (may require login)
+- [Detailed descriptions of lineType values are found at the ISO/IEC 9973 International Register of Graphical Items](https://www.iso.org/jtc1/sc24/register){:target="_blank"} [](https://isotc.iso.org/livelink/livelink/fetch/-8916524/8916549/8916590/6208440/class_pages/*linetype*.html){:target="_blank"}
 
 ### SFFloat [in, out] **linewidthScaleFactor** 0 <small>(-∞,∞)</small>
 
 *linewidthScaleFactor* is a scale factor multiplied by browser-dependent nominal linewidth, mapped to nearest available line width. Values zero or less provide minimum available line width.
 
-## Description
+## Advisories
 
 ### Hints
 
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-- Include `<component name='Shape' level='2'/>`
+- [LineProperties illustration model](https://X3dGraphics.com/examples/X3dForWebAuthors/Chapter05AppearanceMaterialTextures/LinePropertiesExampleIndex.html){:target="_blank"}
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Shape' level='2'/>`
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Shape/LineProperties/LineProperties.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of LineProperties](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#LineProperties){:target="_blank"}
+- [X3D Specification of LineProperties node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#LineProperties){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: Material
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [Material, Shape]
@@ -15,7 +15,7 @@ tags: [Material, Shape]
 
 Material specifies surface rendering properties for associated geometry nodes. Material attributes are used by the X3D lighting equations during rendering.
 
-The Material node belongs to the **Shape** component and its default container field is *material.* It is available since X3D version 2.0 or later.
+The Material node belongs to the **Shape** component and its default container field is *material.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The Material node belongs to the **Shape** component and its default container f
 
 ### 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] **ambientIntensity** 0.2 <small>[0,1]</small>
 
@@ -41,27 +45,35 @@ How much ambient omnidirectional light is reflected from all light sources. Inte
 
 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] **ambientTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying ambientIntensity for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
 
-#### Hint
+#### Hints
 
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='ambientTexture'
+- Contained texture node must include `containerField='ambientTexture'`
 
 ### SFColor [in, out] **diffuseColor** 0.8 0.8 0.8 <small>[0,1]</small>
 
 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.
 
 ### SFString [in, out] **diffuseTextureMapping** ""
 
 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] **diffuseTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying diffuseColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -69,7 +81,7 @@ When applying diffuseColor for this material node, the contained texture provide
 #### Hints
 
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='diffuseTexture'
+- Contained texture node must include `containerField='diffuseTexture'`
 
 ### SFColor [in, out] **specularColor** 0 0 0 <small>[0,1]</small>
 
@@ -79,6 +91,10 @@ Specular highlights are brightness reflections (example: shiny spots on an apple
 
 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] **specularTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying specularColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -86,7 +102,7 @@ When applying specularColor 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='specularTexture'
+- Contained texture node must include `containerField='specularTexture'`
 
 ### SFColor [in, out] **emissiveColor** 0 0 0 <small>[0,1]</small>
 
@@ -94,16 +110,22 @@ 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.
 
 ### 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.
@@ -111,16 +133,20 @@ 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] **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.
 
 ### SFString [in, out] **shininessTextureMapping** ""
 
 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] **shininessTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying shininess for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -128,7 +154,7 @@ When applying shininess 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='shininessTexture'
+- Contained texture node must include `containerField='shininessTexture'`
 
 ### SFFloat [in, out] **occlusionStrength** 1 <small>[0,1]</small>
 
@@ -137,12 +163,16 @@ When applying shininess for this material node, the contained texture provides P
 #### 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.
@@ -150,7 +180,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>
 
@@ -158,52 +188,48 @@ 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.
-
-#### 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.
 
-## 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.
+- [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"}
+- [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"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Shape/Material/Material.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of Material](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Material){: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"}
-- [Rendering](https://en.wikipedia.org/wiki/Rendering_(computer_graphics)){:target="_blank"}
-- [3D rendering](https://en.wikipedia.org/wiki/3D_rendering){:target="_blank"}
-- [Phong reflection model](https://en.wikipedia.org/wiki/Phong_reflection_model){:target="_blank"}
+- [X3D Specification of Material node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Material){:target="_blank"}