x_ite 8.8.6 → 8.9.0

package/docs/_posts/components/Texturing/MovieTexture.md

@@ -1,6 +1,6 @@
 ---
 title: MovieTexture
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Texturing
 categories: [components, Texturing]
 tags: [MovieTexture, Texturing]
@@ -13,9 +13,9 @@ tags: [MovieTexture, Texturing]
 
 ## Overview
 
-MovieTexture applies a 2D movie image to surface geometry, or provides audio for a Sound node. First define as texture, then USE as Sound source to see it/hear it/save memory. Texture maps have a 2D coordinate system (s, t) horizontal and vertical, with (s, t) values in range [0.0, 1.0] for opposite corners of the image.
+MovieTexture applies a 2D movie image to surface geometry, or provides audio for a Sound node. First define as texture, then USE as Sound source to see it/hear it/save memory. Texture maps have a 2D coordinate system (s, t) horizontal and vertical, with (s, t) texture-coordinate values in range [0.0, 1.0] for opposite corners of the image.
 
-The MovieTexture node belongs to the **Texturing** component and its default container field is *texture.* It is available since X3D version 2.0 or later.
+The MovieTexture node belongs to the **Texturing** component and its default container field is *texture.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -34,7 +34,11 @@ The MovieTexture node belongs to the **Texturing** 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"}
 
 ### SFString [in, out] **description** ""
 
@@ -42,15 +46,19 @@ Author-provided prose that describes intended purpose of the url asset.
 
 #### Hint
 
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
+- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
+
+### SFBool [in, out] **enabled** TRUE
+
+Enables/disables node operation.
 
 ### SFBool [in, out] **load** TRUE
 
-*load*=true means load immediately, load=false means defer loading or else unload a previously loaded asset.
+*load*=true means *load* immediately, *load*=false means defer loading or else unload a previously loaded scene.
 
 #### Hints
 
-- Allows author to design when MovieTexture loading occurs via user interaction, event chains or scripting.
+- Allows author to design when Inline loading occurs via user interaction, event chains or scripting.
 - Use a separate LoadSensor node to detect when loading is complete.
 
 ### MFString [in, out] **url** [ ] <small>[URI]</small>
@@ -59,15 +67,14 @@ Location and filename of movie file or stream. Multiple locations are more relia
 
 #### Hints
 
-- MFString arrays can have multiple values, so separate each individual string by quote marks "https://www.web3d.org" "https://www.web3d.org/about" "etc." XML encoding for quotation mark " is &amp;quot; (which is called a character entity). Can replace embedded blank(s) in url queries with %20 for each blank character.
+- MFString arrays can have multiple values, so separate each individual string by quote marks "https://www.web3d.org" "https://www.web3d.org/about" "etc."
+- Alternative XML encoding for quotation mark " is &amp;quot; (which is an example of a character entity).
+- Can replace embedded blank(s) in *url* queries with %20 for each blank character.
+- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
 
 #### Warning
 
-- Strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https and other operating systems are not.
-
-#### See Also
-
-- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
+- Strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https *url* addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
 
 ### SFTime [in, out] **autoRefresh** 0 <small>[0,∞)</small>
 
@@ -94,124 +101,164 @@ Location and filename of movie file or stream. Multiple locations are more relia
 
 - Automatically reloading content has security considerations and needs to be considered carefully.
 
+### SFFloat [in, out] **gain** 1 <small>(-∞,∞)</small>
+
+The *gain* field is a factor that represents the amount of linear amplification to apply to the output of the node.
+
+#### Hint
+
+- Negative *gain* factors negate the input signal.
+
+#### Warning
+
+- Decibel values shall not be used.
+
 ### SFFloat [in, out] **speed** 1 <small>(-∞,∞)</small>
 
 Factor for how fast the movie (or soundtrack) is played.
 
 #### Hints
 
-- A MovieTexture node shall display frame 0 if speed = 0. A negative speed value sets the movie to play in reverse.
+- A MovieTexture node shall display frame 0 if *speed* = 0.
+- A negative *speed* value sets the movie to play in reverse.
 
 ### SFFloat [in, out] **pitch** 1 <small>(0,∞)</small>
 
-Input/Output field pitch.
+Multiplier for the rate at which sampled sound is played. Changing *pitch* also changes playback speed.
+
+#### Hint
+
+- Changing the *pitch* field does not trigger a duration_changed event. Playback interval may vary but duration of the original media data remains unmodified.
 
 ### SFBool [in, out] **loop** FALSE
 
-Repeat indefinitely when loop=true, repeat only once when loop=false.
+Repeat indefinitely when *loop*=true, repeat only once when *loop*=false.
 
-### SFTime [in, out] **startTime** <small>(-∞,∞)</small>
+### SFTime [in, out] **startTime** 0 <small>(-∞,∞)</small>
 
 Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
 
 #### Hint
 
-- Usually receives a ROUTEd time value.
+- ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
 
-### SFTime [in, out] **resumeTime** <small>(-∞,∞)</small>
+### SFTime [in, out] **resumeTime** 0 <small>(-∞,∞)</small>
 
-When resumeTime becomes\<= time now, isPaused becomes false and MovieTexture becomes active. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
+When *resumeTime* becomes \<= time now, isPaused becomes false and MovieTexture becomes active. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
 
 #### Hint
 
-- Usually receives a ROUTEd time value.
+- ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
 
 #### Warning
 
 - Not supported in VRML97.
 
-### SFTime [in, out] **pauseTime** <small>(-∞,∞)</small>
+### SFTime [in, out] **pauseTime** 0 <small>(-∞,∞)</small>
 
-When time now \>= pauseTime, isPaused becomes true and MovieTexture becomes paused. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
+When time now \>= *pauseTime*, isPaused becomes true and MovieTexture becomes paused. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
 
 #### Hint
 
-- Usually receives a ROUTEd time value.
+- ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
 
 #### Warning
 
 - Not supported in VRML97.
 
-### SFTime [in, out] **stopTime** <small>(-∞,∞)</small>
+### SFTime [in, out] **stopTime** 0 <small>(-∞,∞)</small>
 
 Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
 
 #### Hint
 
-- Usually receives a ROUTEd time value.
+- ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
 
 #### Warnings
 
-- An active TimeSensor node ignores set_cycleInterval and set_startTime events. An active TimeSensor node ignores set_stopTime event values less than or equal to startTime.
+- An active TimeSensor node ignores set_cycleInterval and set_startTime events.
+- An active TimeSensor node ignores set_stopTime event values less than or equal to startTime.
 
 ### SFBool [out] **isPaused**
 
 *isPaused* true/false events are sent when MovieTexture is paused/resumed.
 
-#### Warning
+#### Warnings
 
 - Not supported in VRML97.
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFBool [out] **isActive**
 
 *isActive* true/false events are sent when playback starts/stops.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFTime [out] **elapsedTime**
 
 Current elapsed time since MovieTexture activated/running, cumulative in seconds, and not counting any paused time.
 
-#### Warning
+#### Hint
+
+- *elapsedTime* is a nonnegative SFTime duration interval, not an absolute clock time.
+
+#### Warnings
 
 - Not supported in VRML97.
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFTime [out] **duration_changed**
 
-Length of time in seconds for one cycle of movie.
+Length of time in seconds for one cycle of media stream.
+
+#### Hints
+
+- *duration_changed* is an SFTime duration interval, normally nonnegative, and not an absolute clock time.
+- Changing the pitch field does not trigger a *duration_changed* event. Playback interval may vary but duration of the original media data remains unmodified.
+
+#### Warnings
+
+- Duration value of -1 implies that media data has not yet loaded or is unavailable for some reason.
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFBool [ ] **repeatS** TRUE
 
-Whether to horizontally repeat texture along S axis.
+Whether to repeat texture along S axis horizontally from left to right.
 
 ### SFBool [ ] **repeatT** TRUE
 
-Whether to vertically repeat texture along T axis.
+Whether to repeat texture along T axis vertically from top to bottom.
 
 ### SFNode [ ] **textureProperties** NULL <small>[TextureProperties]</small>
 
-Field textureProperties.
+Single contained TextureProperties node that can specify additional visual attributes applied to corresponding texture images.
 
-## Description
+## Advisories
 
 ### Hints
 
-- Texture width and height must be power of two.
 - Can contain a single TextureProperties node.
 - Insert Shape and Appearance nodes before adding texture.
 - Provide a Viewpoint that allows a clear view of the MovieTexture so that users can easily see all details.
 - Utilize DEF/USE references for multiple copies of a single MovieTexture video file in order to avoid multiple-download delays, reduce memory requirements, and maintain synchronization.
 - Authors can provide multiple video formats for the same video track, with each source address listed separately in the url field.
 - Player support for MPEG-1 video format is required, other formats are optional.
-- The underlying `<video/>` element can be accessed via movieTexture.getValue().getElement().
+- Texture coordinates are reapplied (or else recomputed if textureTransform field initially NULL) whenever the corresponding vertex-based geometry changes.
+- [X3D Scene Authoring Hints, Images](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images){:target="_blank"}
+- [Texture mapping](https://en.wikipedia.org/wiki/Texture_mapping){: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"}
+- [When parent node is LoadSensor, apply `containerField='children'` (X3Dv4) or `containerField='watchList'` (X3Dv3).](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#fieldNameChanges){:target="_blank"}
 
 ### Warning
 
-- MovieTexture has containerField='texture' when parent is an Appearance node, otherwise containerField='source' when parent is a Sound node.
+- MovieTexture has `containerField='texture'` when parent is an Appearance node, otherwise `containerField='source'` when parent is a Sound node.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Texturing/MovieTexture/MovieTexture.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of MovieTexture](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#MovieTexture){:target="_blank"}
-- [X3D Scene Authoring Hints, Images](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images){:target="_blank"}
+- [X3D Specification of MovieTexture node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#MovieTexture){:target="_blank"}

package/docs/_posts/components/Texturing/MultiTexture.md

@@ -1,6 +1,6 @@
 ---
 title: MultiTexture
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Texturing
 categories: [components, Texturing]
 tags: [MultiTexture, Texturing]
@@ -13,9 +13,9 @@ tags: [MultiTexture, Texturing]
 
 ## Overview
 
-MultiTexture applies several individual textures to a 3D object to achieve a more complex visual effect. MultiTexture contains multiple ImageTexture, MovieTexture and PixelTexture nodes. Texture maps have a 2D coordinate system (s, t) horizontal and vertical, with (s, t) values in range [0.0, 1.0] for opposite corners of the image.
+MultiTexture applies several individual textures to a single geometry node, enabling a variety of visual effects that include light mapping and environment mapping. MultiTexture can contain zero or more ImageTexture, MovieTexture, PixelTexture, ComposedCubeMapTexture, GeneratedCubeMapTexture, ImageCubeMapTexture, ComposedTexture3D, ImageTexture3D, and PixelTexture3D nodes. Texture maps have a 2D coordinate system (s, t) horizontal and vertical, with (s, t) texture-coordinate values in range [0.0, 1.0] for opposite corners of the image.
 
-The MultiTexture node belongs to the **Texturing** component and its default container field is *texture.* It is available since X3D version 3.0 or later.
+The MultiTexture node belongs to the **Texturing** component and its default container field is *texture.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,7 +30,11 @@ The MultiTexture node belongs to the **Texturing** 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"}
 
 ### SFString [in, out] **description** ""
 
@@ -38,19 +42,19 @@ Author-provided prose that describes intended purpose of the url asset.
 
 #### Hint
 
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
+- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
 
 ### SFColor [in, out] **color** 1 1 1 <small>[0,1]</small>
 
-The color field defines the RGB base values for mode operations.
+The *color* field defines the RGB base values for mode operations.
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
 ### SFFloat [in, out] **alpha** 1 <small>[0,1]</small>
 
-The alpha field defines the alpha (1-transparency) base value for mode operations.
+The *alpha* field defines the *alpha* (1-transparency) base value for mode operations.
 
 ### MFString [in, out] **mode** [ ]
 
@@ -58,7 +62,8 @@ The alpha field defines the alpha (1-transparency) base value for mode operation
 
 #### Hints
 
-- Include the same number of mode values as textures, otherwise the default value MODULATE is added for each remaining stage. See X3D Specification [Table 18.3 Multitexture modes](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/texturing.html#t-MultitextureModes){:target="_blank"} for further details.
+- Include the same number of *mode* values as textures, otherwise the default value MODULATE is added for each remaining stage.
+- [X3D Architecture Table 18.3 Multitexture modes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html#t-MultitextureModes){:target="_blank"} for further details.
 
 #### Warning
 
@@ -66,35 +71,58 @@ The alpha field defines the alpha (1-transparency) base value for mode operation
 
 ### MFString [in, out] **source** [ ]
 
-*source* field determines whether each image source is treated as DIFFUSE, SPECULAR or a multiplicative FACTOR. Empty string value "" indicates that no source modifier is applied for that stage.
+*source* field determines whether each image *source* is treated as DIFFUSE, SPECULAR or a multiplicative FACTOR. Empty string value "" indicates that no *source* modifier is applied for that stage.
 
 #### Hints
 
-- Include the same number of source values as textures, otherwise the default of no source interpretation is applied for each remaining stage. See X3D Specification [Table 18.4 Values for the source field](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/texturing.html#t-ValuesForSourceField){:target="_blank"} for further details.
+- Include the same number of *source* values as textures, otherwise the default of no *source* interpretation is applied for each remaining stage.
+- [X3D Architecture Table 18.4 Values for the *source* field](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html#t-ValuesForSourceField){:target="_blank"} for further details.
 
 ### MFString [in, out] **function** [ ]
 
-*function* operators COMPLEMENT or ALPHAREPLICATE can be applied after the mode blending operation. Empty string value "" indicates that no function operation is applied for that stage.
+*function* operators COMPLEMENT or ALPHAREPLICATE can be applied after the mode blending operation. Empty string value "" indicates that no *function* operation is applied for that stage.
 
 #### Hints
 
-- Include the same number of function values as textures, otherwise the default of no function operation is applied for each remaining stage. See X3D Specification [Table 18.5 Values for the function field](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/components/texturing.html#t-ValuesForFunctionField){:target="_blank"} for further details.
+- Include the same number of *function* values as textures, otherwise the default of no *function* operation is applied for each remaining stage.
+- [X3D Architecture Table 18.5 Values for the *function* field](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html#t-ValuesForFunctionField){:target="_blank"} for further details.
 
 ### MFNode [in, out] **texture** [ ] <small>[X3DTextureNode]</small>
 
-Input/Output field texture.
+Contained *texture* nodes (ImageTexture, MovieTexture, PixelTexture) that map image(s) to surface geometry, defining each of the different *texture* channels.
+
+#### Hints
+
+- If *texture* node is NULL or unspecified, corresponding Shape geometry for this Appearance is not textured.
+- [X3D Scene Authoring Hints, Images](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images){:target="_blank"}
+- [X3D Architecture 18 Texturing component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html){:target="_blank"}
+- [X3D Architecture 33 Texturing3D component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texture3D.html){:target="_blank"}
+
+#### Warning
+
+- MultiTexture may not contain another MultiTexture node.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
 - Insert Shape and Appearance nodes before adding texture.
-- Add a default BlendMode node to Appearance if the resulting image is transparent.
+- [Texture mapping](https://en.wikipedia.org/wiki/Texture_mapping){:target="_blank"}
+- Multitexturing is accomplished using MultiTexture, MultiTextureCoordinate and MultiTextureTransform nodes.
+- Texture coordinates are reapplied (or else recomputed if textureTransform field initially NULL) whenever the corresponding vertex-based geometry changes.
+- [X3D Texturing component Figure 18.2 Lightmap example](https://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/texturing.html#f-Lightmapexample){:target="_blank"}
+- [X3D Texturing component Table 18.2: Comparison of single texture and multitexture attributes](https://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/texturing.html#t-SingleAndMultitextureAttrs){:target="_blank"}
+- MultiTexture does not need to be included in LoadSensor watchList since any child ImageTexture and MovieTexture nodes of interest can be handled separately.
+
+### Warnings
+
+- The number of textures to be blended may have a significant impact on performance, depending on available graphics hardware capabilities.
+- MultiTexture may not contain another MultiTexture node.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Texturing/MultiTexture/MultiTexture.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of MultiTexture](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#MultiTexture){:target="_blank"}
+- [X3D Specification of MultiTexture node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#MultiTexture){:target="_blank"}

package/docs/_posts/components/Texturing/MultiTextureCoordinate.md

@@ -1,6 +1,6 @@
 ---
 title: MultiTextureCoordinate
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Texturing
 categories: [components, Texturing]
 tags: [MultiTextureCoordinate, Texturing]
@@ -13,9 +13,9 @@ tags: [MultiTextureCoordinate, Texturing]
 
 ## Overview
 
-MultiTextureCoordinate contains multiple TextureCoordinate or TextureCoordinateGenerator nodes, for use by a parent polygonal geometry node such as IndexedFaceSet or a Triangle\* node. Each of the contained texture coordinate nodes correspond to the multiple texture nodes contained in a sibling Appearance/MultiTexture node.
+MultiTextureCoordinate contains multiple TextureCoordinate or TextureCoordinateGenerator nodes, for use by a parent polygonal geometry node such as IndexedFaceSet or a Triangle* node. Each of the contained texture coordinate nodes correspond to the multiple texture nodes contained in a sibling Appearance/MultiTexture node.
 
-The MultiTextureCoordinate node belongs to the **Texturing** component and its default container field is *texCoord.* It is available since X3D version 3.0 or later.
+The MultiTextureCoordinate node belongs to the **Texturing** component and its default container field is *texCoord.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,18 +30,35 @@ The MultiTextureCoordinate node belongs to the **Texturing** component and its d
 
 ### 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, out] **texCoord** [ ] <small>[X3DTextureCoordinateNode]</small>
 
-Input/Output field texCoord.
+Zero or more contained TextureCoordinate or TextureCoordinateGenerator nodes that specify texture coordinates for the different texture channels, used for texture mapping onto corresponding geometry.
+
+#### Warning
+
+- MultiTextureCoordinate may not contain another MultiTextureCoordinate node.
+
+## Advisories
+
+### Hints
 
-## Description
+- Add Shape and then polygonal/planar geometry before adding MultiTextureCoordinate.
+- [Texture mapping](https://en.wikipedia.org/wiki/Texture_mapping){:target="_blank"}
+- Multitexturing is accomplished using MultiTexture, MultiTextureCoordinate and MultiTextureTransform nodes.
+- [X3D Texturing component Figure 18.2 Lightmap example](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html#f-Lightmapexample){:target="_blank"}
+- [X3D Texturing component Table 18.2: Comparison of single texture and multitexture attributes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html#t-SingleAndMultitextureAttrs){:target="_blank"}
 
-### Hint
+### Warnings
 
-- Add Shape and then polgyonal/planar geometry before adding MultiTextureCoordinate.
+- The number of textures to be blended may have a significant impact on performance, depending on available graphics hardware capabilities.
+- MultiTextureCoordinate may not contain another MultiTextureCoordinate node.
 
-## External Links
+## See Also
 
-- [X3D Specification of MultiTextureCoordinate](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#MultiTextureCoordinate){:target="_blank"}
+- [X3D Specification of MultiTextureCoordinate node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#MultiTextureCoordinate){:target="_blank"}

package/docs/_posts/components/Texturing/MultiTextureTransform.md

@@ -1,6 +1,6 @@
 ---
 title: MultiTextureTransform
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Texturing
 categories: [components, Texturing]
 tags: [MultiTextureTransform, Texturing]
@@ -13,9 +13,9 @@ tags: [MultiTextureTransform, Texturing]
 
 ## Overview
 
-MultiTextureTransform contains multiple TextureTransform nodes, for use by sibling ImageTexture MovieTexture or PixelTexture nodes.
+MultiTextureTransform contains multiple TextureTransform nodes, each provided for use by corresponding ImageTexture MovieTexture or PixelTexture nodes within a sibling MultiTexture node.
 
-The MultiTextureTransform node belongs to the **Texturing** component and its default container field is *textureTransform.* It is available since X3D version 3.0 or later.
+The MultiTextureTransform node belongs to the **Texturing** component and its default container field is *textureTransform.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,18 +30,40 @@ The MultiTextureTransform node belongs to the **Texturing** component and its de
 
 ### 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, out] **textureTransform** [ ] <small>[X3DTextureTransformNode]</small>
 
-Input/Output field textureTransform.
+Zero or more contained TextureTransform nodes, for each of the different texture channels, that define 2D transformation applied to texture coordinates.
+
+#### Hints
+
+- Texture coordinates are reapplied (or else recomputed if *textureTransform* field initially NULL) whenever the corresponding vertex-based geometry changes.
+- If *textureTransform* array is empty, then this field has no effect.
+
+#### Warning
+
+- MultiTextureTransform may not contain another MultiTextureTransform node.
+
+## Advisories
+
+### Hints
 
-## Description
+- Insert Shape and Appearance nodes before adding MultiTextureTransform.
+- [Texture mapping](https://en.wikipedia.org/wiki/Texture_mapping){:target="_blank"}
+- Multitexturing is accomplished using MultiTexture, MultiTextureCoordinate and MultiTextureTransform nodes.
+- [X3D Texturing component Figure 18.2 Lightmap example](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html#f-Lightmapexample){:target="_blank"}
+- [X3D Texturing component Table 18.2: Comparison of single texture and multitexture attributes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html#t-SingleAndMultitextureAttrs){:target="_blank"}
 
-### Hint
+### Warnings
 
-- Insert Shape and Appearance nodes before adding TextureTransform.
+- The number of textures to be blended may have a significant impact on performance, depending on available graphics hardware capabilities.
+- MultiTextureTransform may not contain another MultiTextureTransform node.
 
-## External Links
+## See Also
 
-- [X3D Specification of MultiTextureTransform](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#MultiTextureTransform){:target="_blank"}
+- [X3D Specification of MultiTextureTransform node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#MultiTextureTransform){:target="_blank"}

package/docs/_posts/components/Texturing/PixelTexture.md

@@ -1,6 +1,6 @@
 ---
 title: PixelTexture
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Texturing
 categories: [components, Texturing]
 tags: [PixelTexture, Texturing]
@@ -13,9 +13,9 @@ tags: [PixelTexture, Texturing]
 
 ## Overview
 
-PixelTexture creates a 2D-image texture map using a numeric array of pixel values. Texture maps have a 2D coordinate system (s, t) horizontal and vertical, with (s, t) values in range [0.0, 1.0] for opposite corners of the image.
+PixelTexture creates a 2D-image texture map using a numeric array of pixel values. Texture maps have a 2D coordinate system (s, t) horizontal and vertical, with (s, t) texture-coordinate values in range [0.0, 1.0] for opposite corners of the image.
 
-The PixelTexture node belongs to the **Texturing** component and its default container field is *texture.* It is available since X3D version 2.0 or later.
+The PixelTexture node belongs to the **Texturing** component and its default container field is *texture.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -32,7 +32,11 @@ The PixelTexture node belongs to the **Texturing** 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"}
 
 ### SFString [in, out] **description** ""
 
@@ -40,41 +44,57 @@ Author-provided prose that describes intended purpose of the url asset.
 
 #### Hint
 
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
+- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
 
 ### SFImage [in, out] **image** 0 0 0
 
-Defines image: width height number_of_components pixel_values. width and height are pixel count, number_of_components = 1 (intensity), 2 (intensity alpha), 3 (red green blue), 4 (red green blue alpha-opacity).
+Defines *image*: width, height, number_of_components per each pixel value, and list of pixel_values. Note that width and height are pixel count, and allowed values for RGBA number_of_components in each pixel value are 1 (intensity), 2 (intensity alpha), 3 (red green blue), 4 (red green blue alpha-opacity).
+
+#### Hints
+
+- It is easier to understand hexadecimal values for each pixel, but integer values are also allowed.
+- The array of pixel values has length = (width*height).
+- The full list of integers in this field has length = (width*height + 3).
+
+#### Warning
+
+- The order of initial values in PixelTexture and PixelTexture3D *image* arrays are different. Example: intensity [1 2 1 0xFF 0x00] Example: intensity-alpha [2 2 1 0 255 255 0] Example: red-green-blue [2 4 3 0xFF0000 0xFF00 0 0 0 0 0xFFFFFF 0xFFFF00] Example: red-green-blue-alpha [2 2 4 0xFFFFFFAA 0xFFFF00AA 0x11111111AA 0x787800AA]
 
 ### SFBool [ ] **repeatS** TRUE
 
-Whether to horizontally repeat texture along S axis.
+Whether to repeat texture along S axis horizontally from left to right.
 
 ### SFBool [ ] **repeatT** TRUE
 
-Whether to vertically repeat texture along T axis.
+Whether to repeat texture along T axis vertically from top to bottom.
 
 ### SFNode [ ] **textureProperties** NULL <small>[TextureProperties]</small>
 
-Field textureProperties.
+Single contained TextureProperties node that can specify additional visual attributes applied to corresponding texture images.
 
-## Description
+## Advisories
 
 ### Hints
 
 - This is a good way to bundle image(s) into a single scene file, avoiding multiple downloads.
+- [X3D-Edit includes PixelTexture image-conversion import capabilities.](https://savage.nps.edu/X3D-Edit/images/PixelTextureImportImage.png){:target="_blank"}
 - Can contain a single TextureProperties node.
 - Insert Shape and Appearance nodes before adding texture.
+- [X3D Scene Authoring Hints, Images and Videos](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images){:target="_blank"}
+- If a texture is opaque, omitting values in the alpha channel can help avoid rendering artifacts related to transparency.
+- Texture coordinates are reapplied (or else recomputed if textureTransform field initially NULL) whenever the corresponding vertex-based geometry changes.
+- [Texture mapping](https://en.wikipedia.org/wiki/Texture_mapping){: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"}
 
-### Warning
+### Warnings
 
 - Aggregate file size can grow dramatically.
+- See ComposedCubeMapTexture and TextureBackground for special containerField values.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Texturing/PixelTexture/PixelTexture.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of PixelTexture](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#PixelTexture){:target="_blank"}
-- [X3D Scene Authoring Hints, Images and Videos](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images){:target="_blank"}
+- [X3D Specification of PixelTexture node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#PixelTexture){:target="_blank"}