x_ite 8.8.6 → 8.9.0

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"}

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.
 
-### SFFloat [in, out] **pointSizeScaleFactor** 1 (1,∞)
+#### 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,40 +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.
-
-### MFFloat [in, out] **pointSizeAttenuation** 1 0 0 <small>(0,∞)</small>
-
-*pointSizeAttenuation* 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.
+- Maintain pointSizeMinValue \<= *pointSizeMaxValue*.
 
-#### 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.
-
-### SFString [in, out] **colorMode** "TEXTURE_AND_POINT_COLOR" <small>["POINT_COLOR", "TEXTURE_COLOR", "TEXTURE_AND_POINT_COLOR"]</small>
+### MFFloat [in, out] **attenuation** [ 1, 0, 0 ] <small>(0,∞)</small>
 
-*colorMode* has blending effect on the rendering of point sprites, applying supplied color (Color node or Material emissiveColor) and texture color
+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
 
-- POINT_COLOR shall display the RGB channels of the color instance defined in X3DMaterialNode or X3DColorNode, and the A channel of the texture if any. If no color is associated to the point, the default RGB color (0, 0, 0) shall be used. TEXTURE_COLOR shall display the original texture with its RGBA channels and regardless to the X3DMaterialNode or X3DColorNode which might be associated to the point set. TEXTURE_AND_POINT_COLOR shall display the RGBA channels of a texture added to the RGB channels of the color defined in X3DMaterialNode or X3DColorNode node, and the A channel of the texture if any. If no color is associated to the point, the result shall be exactly the same as TEXTURE_COLOR.
+- 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"}