x_ite 8.8.7 → 8.9.0

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

@@ -1,6 +1,6 @@
 ---
 title: ScreenFontStyle
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Layout
 categories: [components, Layout]
 tags: [ScreenFontStyle, Layout]
@@ -15,7 +15,7 @@ tags: [ScreenFontStyle, Layout]
 
 ScreenFontStyle is an X3DFontStyleNode defines the size, family, justification, and other styles used within a screen layout. ScreenFontStyle renders text so that it appears identical to typical 2D applications by specifying pointSize in points (as in 2D document layout) rather than size in meters. Each glyph of text is rendered as a quadrilateral with a texture applied.
 
-The ScreenFontStyle node belongs to the **Layout** component and its default container field is *fontStyle.* It is available since X3D version 3.2 or later.
+The ScreenFontStyle node belongs to the **Layout** component and its default container field is *fontStyle.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,109 +29,136 @@ The ScreenFontStyle node belongs to the **Layout** 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.
 
-### SFString [in, out] **language** ""
+#### Hint
 
-*language* codes consist of a primary code and a (possibly empty) series of subcodes. [ language-code = primary-code ( "-" subcode )\* ] Two-letter primary codes are reserved for language abbreviations. Two-letter primary codes include en (English), fr (French), de (German), it (Italian), nl (Dutch), el (Greek), es (Spanish), pt (Portuguese), ar (Arabic), he (Hebrew), ru (Russian), zh (Chinese), ja (Japanese), hi (Hindi), ur (Urdu), and sa (Sanskrit). Any two-letter subcode is understood to be a country code.
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
-#### Warning
+### SFString [in, out] **language** ""
 
-- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
+Language codes consist of a primary code and a (possibly empty) series of subcodes. [ *language*-code = primary-code ( "-" subcode )* ] Two-letter primary codes are reserved for *language* abbreviations. Two-letter primary codes include en (English), fr (French), de (German), it (Italian), nl (Dutch), el (Greek), es (Spanish), pt (Portuguese), ar (Arabic), he (Hebrew), ru (Russian), zh (Chinese), ja (Japanese), hi (Hindi), ur (Urdu), and sa (Sanskrit). Any two-letter subcode is understood to be a country code.
 
-#### See Also
+#### Hints
 
-- [See ISO639.2 Codes for the Representation of Names of Languages](https://www.loc.gov/standards/iso639-2/php/code_list.php){:target="_blank"}
+- [See ISO639.2 Codes for the Representation of Names of Languages](http://www.loc.gov/standards/iso639-2/php/code_list.php){:target="_blank"}
 - [See RFC3066 Tags for the Identification of Languages](https://tools.ietf.org/html/rfc3066){:target="_blank"}
 - [See ISO3166 or](http://xml.coverpages.org/languageIdentifiers.html){:target="_blank"}
-- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- [Relates to Internationalization (i18n)](http://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
+
+#### Warning
+
+- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
 
 ### MFString [in, out] **family** "SERIF" <small>String or [URI]</small>
 
-Array of quoted font family names, or the addresses of the font files to load, in order of preference; browsers will use the first supported family.
+Array of quoted font *family* names in preference order, browsers use the first supported *family*.
 
 #### Hints
 
-- Example family array might be "Times" "SERIF" Values with guaranteed support include "SERIF" "SANS" "TYPEWRITER". SERIF and SANS are variable-width fonts (for example, Times Roman and Arial). TYPEWRITER is a fixed-width font (for example, Courier). MFString arrays can have multiple values, so "separate each individual string" "by using quote marks". See [15.2.2.2 Font family and style](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Fontfamilyandstyle){:target="_blank"} for details.
+- Example *family* array might be "Times" "SERIF"
+- Values with guaranteed support include "SERIF" "SANS" "TYPEWRITER".
+- SERIF and SANS are variable-width fonts (for example, Times Roman and Arial).
+- TYPEWRITER is a fixed-width font (for example, Courier).
+- MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
+- [See 15.2.2.2 Font *family* and style](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/text.html#Fontfamilyandstyle){:target="_blank"} for details.
+- [Relates to Internationalization (i18n)](http://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
 #### Warning
 
-- Font family support often varies.
-
-#### See Also
-
-- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- Font *family* support often varies.
 
 ### SFString [in, out] **style** "PLAIN" <small>["PLAIN"|"BOLD"|"ITALIC"|"BOLDITALIC"|""]</small>
 
-Pick one of four values for text style.
+Pick one of four values for text *style* (PLAIN or BOLD or ITALIC or BOLDITALIC).
 
-#### Hint
+#### Hints
 
-- See [15.2.2.2 Font family and style](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Fontfamilyandstyle){:target="_blank"} for details.
+- [See 15.2.2.2 Font family and *style*](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/text.html#Fontfamilyandstyle){:target="_blank"} for details.
+- Overlapping functionality with CSS *style* attribute provides a "best of both worlds" approach. The *style* attribute provides an inline block of CSS source for element styling, reserved for use by Cascading Style Sheets (CSS) and XML stylesheets.
+- [X3D Architecture Annex L, HTML authoring guidelines, CSS considerations](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/htmlGuidelines.html#CSS){:target="_blank"}
+- [W3C Cascading Style Sheets](https://www.w3.org/Style/CSS){:target="_blank"}
+- [CSS Snapshot](https://www.w3.org/TR/css-2018){:target="_blank"}
+- Https://www.w3.org/TR/css-*style*-attr
+- [Wikibooks, XML - Managing Data Exchange/XSLT and Style Sheets](https://en.wikibooks.org/wiki/XML_-_Managing_Data_Exchange/XSLT_and_Style_Sheets){:target="_blank"}
 
-#### Warning
+#### Warnings
 
+- Overloaded name for CSS *style* attribute.
 - Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
 
 ### SFFloat [in, out] **pointSize** 12 <small>(0,∞)</small>
 
-*pointSize* field specifies the size of text in points. Nominal height (in local coordinate system) of text glyphs Also sets default spacing between adjacent lines of text.
+*pointSize* field specifies the size of text in points. Nominal height (in local coordinate system) of text glyphs, also sets default spacing between adjacent lines of text.
 
-#### Hint
+#### Hints
 
-- PointSize replaces the size field of the FontStyle node.
+- *pointSize* replaces the size field of the FontStyle node.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
 ### SFFloat [in, out] **spacing** 1 <small>[0,∞)</small>
 
-Adjustment factor for line spacing between adjacent lines of text.
+Adjustment factor for line *spacing* between adjacent lines of text.
 
-### SFBool [in, out] **horizontal** TRUE
+#### Hint
 
-Whether text direction is horizontal (true) or vertical (false).
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
-#### Hint
+### SFBool [in, out] **horizontal** TRUE
 
-- See [15.2.2.3 Direction and justification](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+Whether text direction is *horizontal* (true) or vertical (false).
 
-#### See Also
+#### Hints
 
-- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- [See 15.2.2.3 Direction and justification](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+- [Relates to Internationalization (i18n)](http://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
 ### SFBool [in, out] **leftToRight** TRUE
 
-Field leftToRight.
+Whether text direction is left-to-right (true) or right-to-left (false).
 
-### SFBool [in, out] **topToBottom** TRUE
+#### Hints
 
-Whether text direction is top-to-bottom (true) or bottom-to-top (false).
+- [See 15.2.2.3 Direction and justification](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+- [Relates to Internationalization (i18n)](http://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
-#### Hint
+### SFBool [in, out] **topToBottom** TRUE
 
-- See [15.2.2.3 Direction and justification](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+Whether text direction is top-to-bottom (true) or bottom-to-top (false).
 
-#### See Also
+#### Hints
 
-- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- [See 15.2.2.3 Direction and justification](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+- [Relates to Internationalization (i18n)](http://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
 ### MFString [in, out] **justify** "BEGIN" <small>["BEGIN", "END", "FIRST", "MIDDLE", ""]</small>
 
-The justify field determines alignment of the above text layout relative to the origin of the object coordinate system.
+The *justify* field determines horizontal and vertical alignment of text layout, relative to the origin of the object coordinate system.
 
 #### Hints
 
-- Preferred value is usually justify=' "MIDDLE" "MIDDLE" ' for centered justification horizontally and vertically. MFString arrays can have multiple values, so "separate each individual string" "by using quote marks". See [15.2.2.3 Direction and justification](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+- Preferred value is usually *justify*=' "MIDDLE" "MIDDLE" ' for centered justification horizontally and vertically.
+- MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".
+- [See 15.2.2.3 Direction and justification](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/text.html#Directionandjustification){:target="_blank"} for details.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
 #### Warnings
 
-- Exactly two string values are provided for major and minor axis alignment. Do not use illegal values such as LEFT RIGHT TOP BOTTOM or CENTER.
+- Exactly two string values are provided for major and minor axis alignment.
+- Do not use illegal values such as LEFT RIGHT TOP BOTTOM or CENTER.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
 - First add a Text node as a parent.
+- [Wikipedia](https://en.wikipedia.org/wiki/Font){:target="_blank"}
 
-## External Links
+## See Also
 
-- [X3D Specification of ScreenFontStyle](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layout.html#ScreenFontStyle){:target="_blank"}
+- [X3D Specification of ScreenFontStyle node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/layout.html#ScreenFontStyle){:target="_blank"}

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,16 +30,20 @@ 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.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFBool [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
 ### SFBool [in, out] **bboxDisplay** FALSE
 
@@ -53,36 +57,48 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
 
-#### Hint
+#### Hints
 
 - Can be useful for collision computations or inverse-kinematics (IK) engines.
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
+
+#### Hints
+
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### 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,7 +70,7 @@ 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
 
@@ -84,17 +92,17 @@ The shadowBias value controls the visibility of *shadow acne*.
 
 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

@@ -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.
@@ -86,6 +82,6 @@ The shadowBias value controls the visibility of *shadow acne*.
 
 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>
 
@@ -88,16 +100,16 @@ The shadowBias value controls the visibility of *shadow acne*.
 
 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,26 +88,27 @@ 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
 
@@ -117,16 +130,16 @@ The shadowBias value controls the visibility of *shadow acne*.
 
 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"}