x_ite 8.8.6 → 8.9.0

package/docs/_posts/components/Layout/ScreenGroup.md

@@ -1,6 +1,6 @@
 ---
 title: ScreenGroup
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Layout
 categories: [components, Layout]
 tags: [ScreenGroup, Layout]
@@ -15,7 +15,7 @@ tags: [ScreenGroup, Layout]
 
 ScreenGroup is a Grouping node that can contain most nodes. ScreenGroup modifies the screen scale in such a way that one unit is equal to one pixel in both the horizontal and vertical directions.
 
-The ScreenGroup node belongs to the **Layout** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The ScreenGroup node belongs to the **Layout** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -30,18 +30,22 @@ The ScreenGroup node belongs to the **Layout** component and its default contain
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
 
-### SFBool [ ] **visible** TRUE
+#### 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 [ ] **bboxDisplay** FALSE
+### SFBool [in, out] **bboxDisplay** FALSE
 
 Whether to display bounding box for associated geometry, aligned with world coordinates.
 
@@ -49,40 +53,52 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 - The bounding box is displayed regardless of whether contained content is visible.
 
-### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>(0,∞) or -1 -1 -1</small>
+### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
 
 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"}
 
 ### MFNode [in] **addChildren**
 
-Input field addChildren.
+Input field *addChildren*.
 
 ### MFNode [in] **removeChildren**
 
-Input field removeChildren.
+Input field *removeChildren*.
 
 ### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
 
-Grouping nodes contain a list of children nodes.
+Grouping nodes contain an ordered list of *children* nodes.
 
-#### Hint
+#### Hints
 
-- Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+- Each grouping node defines a coordinate space for its *children*, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+- InputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
+- InputOnly MFNode removeChildren field can remove nodes from the *children* list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
+- [X3D Architecture 10.2.1 Grouping and *children* node types](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#GroupingAndChildrenNodes){:target="_blank"}
 
-## Description
+## Advisories
 
 ### Hint
 
 - Insert a Shape node before adding geometry or Appearance.
 
-## External Links
+## See Also
 
-- [X3D Specification of ScreenGroup](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layout.html#ScreenGroup){:target="_blank"}
+- [X3D Specification of ScreenGroup node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layout.html#ScreenGroup){:target="_blank"}

package/docs/_posts/components/Lighting/DirectionalLight.md

@@ -1,6 +1,6 @@
 ---
 title: DirectionalLight
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Lighting
 categories: [components, Lighting]
 tags: [DirectionalLight, Lighting]
@@ -13,9 +13,9 @@ tags: [DirectionalLight, Lighting]
 
 ## Overview
 
-DirectionalLight creates parallel light rays to illuminate geometric shapes. Light is scoped and only illuminates geometry within its enclosing parent group! No source location is needed since rays are parallel from an infinitely distant source. DirectionalLight nodes do not attenuate with distance. Lights have no visible shape themselves and shine through occluding geometry.
+DirectionalLight defines parallel light rays that illuminate geometric shapes. Lighting illuminates all geometry except lines and points. By default, light scope only illuminates peer geometry and children nodes within the scene graph hierarchy. No source location is needed since rays are parallel from an infinitely distant source. DirectionalLight nodes do not attenuate with distance. Lights have no visible shape themselves and lighting effects continue through any intermediate geometry.
 
-The DirectionalLight node belongs to the **Lighting** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The DirectionalLight node belongs to the **Lighting** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -30,11 +30,19 @@ The DirectionalLight node belongs to the **Lighting** component and its default
 
 ### 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] **global** FALSE
 
-*global* lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+Global lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+
+#### Warning
+
+- DirectionalLight default *global*=false to limit scope and avoid inadvertently illuminating every object in a large scene. PointLight and SpotLight default *global*=true since their effects are each limited by maximum radius value.
 
 ### SFBool [in, out] **on** TRUE
 
@@ -44,7 +52,7 @@ Enables/disables this light source.
 
 *color* of light, applied to colors of objects.
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
@@ -62,39 +70,39 @@ Orientation vector of light relative to local coordinate system.
 
 #### Hint
 
-- Animate direction to simulate time-of-day sunlight effects.
+- Animate *direction* to simulate time-of-day sunlight effects.
 
 ### SFBool [in, out] **shadows** FALSE
 
 *shadows* field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.
 
-### SFColor [in, out] **shadowColor** 0 0 0 <small>[0,1] <span class="yellow">non standard</span></small>
+### SFColor [in, out] **shadowColor** 0 0 0 <small>[0,1]</small> <small class="yellow">non standard</small>
 
 Color of shadow, applied to colors of objects.
 
-### SFFloat [in, out] **shadowIntensity** 0 <small>[0,1]</small>
+### SFFloat [in, out] **shadowIntensity** 1 <small>[0,1]</small>
 
 *shadowIntensity* field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).
 
-### SFFloat [in, out] **shadowBias** 0.005 <small>[0,1] <span class="yellow">non standard</span></small>
+### SFFloat [in, out] **shadowBias** 0.005 <small>[0,1]</small> <small class="yellow">non standard</small>
 
 The shadowBias value controls the visibility of *shadow acne*.
 
-### SFInt32 [ ] **shadowMapSize** 1024 <small>[0,∞) <span class="yellow">non standard</span></small>
+### SFInt32 [ ] **shadowMapSize** 1024 <small>[0,∞)</small> <small class="yellow">non standard</small>
 
 Size of the shadow map in pixels, must be power of two.
 
-## Description
+## Advisories
 
 ### Hints
 
 - Animate direction to simulate time-of-day sunlight effects.
-- HeadLight enabled on/off is controlled by NavigationInfo.
+- The bound NavigationInfo controls whether headlight is enabled on/off. Interchange profile hint: light might not be scoped by parent Group or Transform.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Lighting/DirectionalLight/DirectionalLight.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of DirectionalLight](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#DirectionalLight){:target="_blank"}
+- [X3D Specification of DirectionalLight node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#DirectionalLight){:target="_blank"}

package/docs/_posts/components/Lighting/EnvironmentLight.md

@@ -32,7 +32,7 @@ The EnvironmentLight node belongs to the **Lighting** component and its default
 
 Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
 
-### SFBool [in, out] **global** TRUE
+### SFBool [in, out] **global** FALSE
 
 *global* lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
 
@@ -46,10 +46,6 @@ Enables/disables this light source.
 
 *color* of light, applied to colors of objects.
 
-#### See Also
-
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
-
 ### SFFloat [in, out] **intensity** 1 <small>[0,∞)</small>
 
 Brightness of direct emission from the light.
@@ -70,22 +66,22 @@ Brightness of ambient (nondirectional background) emission from the light.
 
 *shadows* field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.
 
-### SFColor [in, out] **shadowColor** 0 0 0 <small>[0,1] <span class="yellow">non standard</span></small>
+### SFColor [in, out] **shadowColor** 0 0 0 <small>[0,1]</small> <small class="yellow">non standard</small>
 
 Color of shadow, applied to colors of objects.
 
-### SFFloat [in, out] **shadowIntensity** 0 <small>[0,1]</small>
+### SFFloat [in, out] **shadowIntensity** 1 <small>[0,1]</small>
 
 *shadowIntensity* field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).
 
-### SFFloat [in, out] **shadowBias** 0.005 <small>[0,1] <span class="yellow">non standard</span></small>
+### SFFloat [in, out] **shadowBias** 0.005 <small>[0,1]</small> <small class="yellow">non standard</small>
 
 The shadowBias value controls the visibility of *shadow acne*.
 
-### SFInt32 [ ] **shadowMapSize** 1024 <small>[0,∞) <span class="yellow">non standard</span></small>
+### SFInt32 [ ] **shadowMapSize** 1024 <small>[0,∞)</small> <small class="yellow">non standard</small>
 
 Size of the shadow map in pixels, must be power of two.
 
-## External Links
+## See Also
 
-- [X3D Specification of EnvironmentLight](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#EnvironmentLight){:target="_blank"}
+- [X3D Specification of EnvironmentLight node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#EnvironmentLight){:target="_blank"}

package/docs/_posts/components/Lighting/PointLight.md

@@ -1,6 +1,6 @@
 ---
 title: PointLight
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Lighting
 categories: [components, Lighting]
 tags: [PointLight, Lighting]
@@ -13,9 +13,9 @@ tags: [PointLight, Lighting]
 
 ## Overview
 
-PointLight is a single light source that illuminates outwards in all directions. Light illuminates all geometry and is normally scoped to illuminate peers and children nodes within the scene graph hierarchy Lights have no visible shape themselves and shine through occluding geometry.
+PointLight is a single light source that illuminates outwards in all directions. Lighting illuminates all geometry except lines and points. By default, light scope only illuminates peer geometry and children nodes within the scene graph hierarchy. Lights have no visible shape themselves and lighting effects continue through any intermediate geometry.
 
-The PointLight node belongs to the **Lighting** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The PointLight node belongs to the **Lighting** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -30,11 +30,19 @@ The PointLight node belongs to the **Lighting** 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"}
 
 ### SFBool [in, out] **global** TRUE
 
-*global* lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+Global lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+
+#### Warning
+
+- DirectionalLight default *global*=false to limit scope and avoid inadvertently illuminating every object in a large scene. PointLight and SpotLight default *global*=true since their effects are each limited by maximum radius value.
 
 ### SFBool [in, out] **on** TRUE
 
@@ -44,7 +52,7 @@ Enables/disables this light source.
 
 *color* of light, applied to colors of objects.
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
@@ -58,7 +66,11 @@ Brightness of ambient (nondirectional background) emission from the light.
 
 ### SFVec3f [in, out] **attenuation** 1 0 0 <small>[0,∞)</small>
 
-Constant, linear-distance and squared-distance dropoff factors.
+Constant, linear-distance and squared-distance dropoff factors as radial distance increases from the source.
+
+#### Hint
+
+- *attenuation* = 1/max(*attenuation*[0] + *attenuation*[1] ⨯ r + *attenuation*[2] ⨯ r2 , 1)
 
 ### SFVec3f [in, out] **location** 0 0 0 <small>(-∞,∞)</small>
 
@@ -72,32 +84,32 @@ Maximum effective distance of light relative to local light position, affected b
 
 *shadows* field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.
 
-### SFColor [in, out] **shadowColor** 0 0 0 <small>[0,1] <span class="yellow">non standard</span></small>
+### SFColor [in, out] **shadowColor** 0 0 0 <small>[0,1]</small> <small class="yellow">non standard</small>
 
 Color of shadow, applied to colors of objects.
 
-### SFFloat [in, out] **shadowIntensity** 0 <small>[0,1]</small>
+### SFFloat [in, out] **shadowIntensity** 1 <small>[0,1]</small>
 
 *shadowIntensity* field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).
 
-### SFFloat [in, out] **shadowBias** 0.005 <small>[0,1] <span class="yellow">non standard</span></small>
+### SFFloat [in, out] **shadowBias** 0.005 <small>[0,1]</small> <small class="yellow">non standard</small>
 
 The shadowBias value controls the visibility of *shadow acne*.
 
-### SFInt32 [ ] **shadowMapSize** 1024 <small>[0,∞) <span class="yellow">non standard</span></small>
+### SFInt32 [ ] **shadowMapSize** 1024 <small>[0,∞)</small> <small class="yellow">non standard</small>
 
 Size of the shadow map in pixels, must be power of two.
 
-## Description
+## Advisories
 
 ### Hint
 
-- HeadLight enabled on/off is controlled by NavigationInfo.
+- The bound NavigationInfo controls whether headlight is enabled on/off.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Lighting/PointLight/PointLight.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of PointLight](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#PointLight){:target="_blank"}
+- [X3D Specification of PointLight node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#PointLight){:target="_blank"}

package/docs/_posts/components/Lighting/SpotLight.md

@@ -1,6 +1,6 @@
 ---
 title: SpotLight
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Lighting
 categories: [components, Lighting]
 tags: [SpotLight, Lighting]
@@ -13,9 +13,9 @@ tags: [SpotLight, Lighting]
 
 ## Overview
 
-SpotLight is a light source that illuminates geometry within a conical beam. Light illuminates all geometry and is normally scoped to illuminate peers and children nodes within the scene graph hierarchy Lights have no visible shape themselves and shine through occluding geometry.
+SpotLight is a light source that illuminates geometry within a conical beam. Lighting illuminates all geometry except lines and points. By default, light scope only illuminates peer geometry and children nodes within the scene graph hierarchy. Lights have no visible shape themselves and lighting effects continue through any intermediate geometry.
 
-The SpotLight node belongs to the **Lighting** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The SpotLight node belongs to the **Lighting** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -30,11 +30,19 @@ The SpotLight node belongs to the **Lighting** component and its default contain
 
 ### 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] **global** TRUE
 
-*global* lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+Global lights illuminate all objects within their volume of lighting influence. Scoped lights only illuminate objects within the same transformation hierarchy.
+
+#### Warning
+
+- DirectionalLight default *global*=false to limit scope and avoid inadvertently illuminating every object in a large scene. PointLight and SpotLight default *global*=true since their effects are each limited by maximum radius value.
 
 ### SFBool [in, out] **on** TRUE
 
@@ -44,7 +52,7 @@ Enables/disables this light source.
 
 *color* of light, applied to colors of objects.
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
@@ -58,7 +66,11 @@ Brightness of ambient (nondirectional background) emission from the light.
 
 ### SFVec3f [in, out] **attenuation** 1 0 0 <small>[0,∞)</small>
 
-Constant, linear-distance and squared-distance dropoff factors.
+Constant, linear-distance and squared-distance dropoff factors as radial distance increases from the source.
+
+#### Hint
+
+- *attenuation* = 1/max(*attenuation*[0] + *attenuation*[1] ⨯ r + *attenuation*[2] ⨯ r2 , 1)
 
 ### SFVec3f [in, out] **location** 0 0 0 <small>(-∞,∞)</small>
 
@@ -76,57 +88,58 @@ Maximum effective distance of light relative to local light position, affected b
 
 Inner conical solid angle (in radians) where light source has uniform full intensity.
 
-#### Hint
+#### Hints
 
-- BeamWidth is inner angle of full intensity, cutOffAngle is outer angle of zero intensity. Therefore set beamWidth\<= cutOffAngle.
+- *beamWidth* is inner angle of full intensity, cutOffAngle is outer angle of zero intensity. Therefore set *beamWidth* \<= cutOffAngle.
+- [Radian units for angular measure](https://en.wikipedia.org/wiki/Radian){:target="_blank"}
 
 #### Warning
 
-- If beamWidth > cutOffAngle, then beamWidth reset to equal cutOffAngle.
+- If *beamWidth* \> cutOffAngle, then *beamWidth* is reset to equal cutOffAngle.
 
 ### SFFloat [in, out] **cutOffAngle** π/2 <small>(0,π/2]</small>
 
 Outer conical solid angle (in radians) where light source intensity becomes zero.
 
-#### Hint
+#### Hints
 
-- beamWidth is inner angle of full intensity, cutOffAngle is outer angle of zero intensity. Therefore set beamWidth\<= cutOffAngle.
+- BeamWidth is inner angle of full intensity, *cutOffAngle* is outer angle of zero intensity. Therefore set beamWidth \<= *cutOffAngle*.
+- [Radian units for angular measure](https://en.wikipedia.org/wiki/Radian){:target="_blank"}
 
-#### Warnings
+#### Warning
 
-- If beamWidth > cutOffAngle, then beamWidth reset to equal cutOffAngle.
-- If shadows is `TRUE`, cutOffAngle must be significantly smaller than π/2.
+- If beamWidth \> *cutOffAngle*, then beamWidth is reset to equal *cutOffAngle*.
 
 ### SFBool [in, out] **shadows** FALSE
 
 *shadows* field indicates whether or not this light casts a shadow behind illuminated X3DShapeNode geometry.
 
-### SFColor [in, out] **shadowColor** 0 0 0 <small>[0,1] <span class="yellow">non standard</span></small>
+### SFColor [in, out] **shadowColor** 0 0 0 <small>[0,1]</small> <small class="yellow">non standard</small>
 
 Color of shadow, applied to colors of objects.
 
-### SFFloat [in, out] **shadowIntensity** 0 <small>[0,1]</small>
+### SFFloat [in, out] **shadowIntensity** 1 <small>[0,1]</small>
 
 *shadowIntensity* field defines how much light is obscured by shapes that cast shadows, ranging from 0 (light not obscured, no visible shadows) to 1 (light completely obscured, full-intensity shadows).
 
-### SFFloat [in, out] **shadowBias** 0.005 <small>[0,1] <span class="yellow">non standard</span></small>
+### SFFloat [in, out] **shadowBias** 0.005 <small>[0,1]</small> <small class="yellow">non standard</small>
 
 The shadowBias value controls the visibility of *shadow acne*.
 
-### SFInt32 [ ] **shadowMapSize** 1024 <small>[0,∞) <span class="yellow">non standard</span></small>
+### SFInt32 [ ] **shadowMapSize** 1024 <small>[0,∞)</small> <small class="yellow">non standard</small>
 
 Size of the shadow map in pixels, must be power of two.
 
-## Description
+## Advisories
 
 ### Hint
 
-- HeadLight enabled on/off is controlled by NavigationInfo.
+- The bound NavigationInfo controls whether headlight is enabled on/off.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Lighting/SpotLight/SpotLight.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of SpotLight](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#SpotLight){:target="_blank"}
+- [X3D Specification of SpotLight node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/lighting.html#SpotLight){:target="_blank"}

package/docs/_posts/components/NURBS/Contour2D.md

@@ -1,6 +1,6 @@
 ---
 title: Contour2D
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [Contour2D, NURBS]
@@ -15,7 +15,7 @@ tags: [Contour2D, NURBS]
 
 Contour2D groups a set of curve segments into a composite contour. The children segments form a closed loop, with first point of first child repeated as last point of last child, and last point of each segment repeated as the first point of the next consecutive segment. The children segments are type NurbsCurve2D or ContourPolyline2D, enumerated in the consecutive order of contour topology.
 
-The Contour2D node belongs to the **NURBS** component and its default container field is *trimmingContour.* It is available since X3D version 3.0 or later.
+The Contour2D node belongs to the **NURBS** component and its default container field is *trimmingContour.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -28,21 +28,29 @@ The Contour2D node belongs to the **NURBS** 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"}
 
 ### MFNode [in] **addChildren**
 
-Input field addChildren.
+Input field *addChildren*.
 
 ### MFNode [in] **removeChildren**
 
-Input field removeChildren.
+Input field *removeChildren*.
 
 ### MFNode [in, out] **children** [ ] <small>[NurbsCurve2D|ContourPolyline2D]</small>
 
-Input/Output field children.
+The *children* form a closed loop with first point of first child repeated as last point of last child, and the last point of a segment repeated as first point of the consecutive one.
+
+#### Hint
+
+- *children* nodes are listed in consecutive order according to topology of the contour.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -52,6 +60,6 @@ Input/Output field children.
 
 - Contour2D is not a renderable geometry node.
 
-## External Links
+## See Also
 
-- [X3D Specification of Contour2D](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#Contour2D){:target="_blank"}
+- [X3D Specification of Contour2D node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#Contour2D){:target="_blank"}

package/docs/_posts/components/NURBS/ContourPolyline2D.md

@@ -1,6 +1,6 @@
 ---
 title: ContourPolyline2D
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [ContourPolyline2D, NURBS]
@@ -15,7 +15,7 @@ tags: [ContourPolyline2D, NURBS]
 
 ContourPolyline2D defines a linear curve segment as part of a trimming contour in the u-v domain of a NURBS surface. NurbsCurve2D and ContourPolyline2D nodes that together form a closed contour, defined in the u-v parametric space of a NURBS surface, may be used as children in a Contour2D node.
 
-The ContourPolyline2D node belongs to the **NURBS** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The ContourPolyline2D node belongs to the **NURBS** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -29,18 +29,22 @@ The ContourPolyline2D node belongs to the **NURBS** component and its default co
 
 ### 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"}
 
 ### MFVec2d [in, out] **controlPoint** [ ] <small>(-∞,∞)</small>
 
 *controlPoint* specifies the end points of each segment of the piecewise linear curve.
 
-## Description
+## Advisories
 
 ### Warning
 
 - ContourPolyline2D is not a renderable geometry node.
 
-## External Links
+## See Also
 
-- [X3D Specification of ContourPolyline2D](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#ContourPolyline2D){:target="_blank"}
+- [X3D Specification of ContourPolyline2D node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#ContourPolyline2D){:target="_blank"}