x_ite 8.8.7 → 8.9.1

package/docs/_posts/components/TextureProjector/TextureProjectorParallel.md

@@ -13,9 +13,9 @@ tags: [TextureProjectorParallel, TextureProjector]
 
 ## Overview
 
-TextureProjectorParallel ...
+TextureProjectorParallel is similar to a light that projects a texture into the scene, illuminating geometry that intersects the parallel projection volume.
 
-The TextureProjectorParallel node belongs to the **TextureProjector** component and its default container field is *children.* It is available since X3D version 4.0 or later.
+The TextureProjectorParallel node belongs to the **TextureProjector** component and its default container field is *children.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
@@ -27,7 +27,11 @@ The TextureProjectorParallel node belongs to the **TextureProjector** component
 
 ### 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** ""
 
@@ -35,28 +39,74 @@ 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] **on** TRUE
 
+Enables/disables this texture projection source.
+
 ### SFBool [in, out] **global** TRUE
 
+Global texture projection illuminates all objects within their volume of influence. Scoped texture projection (*global* false) only illuminates objects within the same transformation hierarchy.
+
 ### SFVec3f [in, out] **location** 0 0 0 <small>(-∞,∞)</small>
 
+Position of center of texture projection relative to local coordinate system.
+
 ### SFVec3f [in, out] **direction** 0 0 1 <small>(-∞,∞)</small>
 
+Direction for projection.
+
 ### SFVec3f [in, out] **upVector** 0 0 1 <small>(-∞,∞)</small>
 
+*upVector* describes the roll of the camera by saying which direction is up for the camera's orientation.
+
 ### MFFloat [in, out] **fieldOfView** [ -1, -1, 1, 1 ] <small>(-∞,∞)</small>
 
+Minimum and maximum extents of projection texture in units of local coordinate system. Small field of view roughly corresponds to a telephoto lens, large field of view roughly corresponds to a wide-angle lens.
+
+#### Hint
+
+- Rectangular display width/height = (maxX-minX) / (maxY-minY).
+
+#### Warnings
+
+- Minimum corner values must remain less than maximum corner values.
+- This field differs for TextureProjectorParallel and TextureProjector.
+
 ### SFFloat [in, out] **nearDistance** -1 <small>-1 or (0,∞)</small>
 
+Minimum distance necessary for texture display.
+
 ### SFFloat [in, out] **farDistance** -1 <small>-1 or (0,∞)</small>
 
+Maximum distance necessary for texture display.
+
 ### SFFloat [out] **aspectRatio**
 
+*aspectRatio* is the ratio of width and height that is projected.
+
 ### SFNode [in, out] **texture** NULL <small>[X3DTexture2DNode]</small>
 
-## External Links
+Single contained *texture* node (ImageTexture, MovieTexture, PixelTexture, MultiTexture) that maps image(s) to surface geometry.
+
+#### Hints
+
+- If *texture* node is NULL or unspecified, corresponding Shape geometry for this Appearance is not textured.
+- [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"}
+
+## Advisories
+
+### Hint
+
+- Https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Images/ptmparallel.png
+
+### Warning
+
+- Add textureTransform field?
+
+## See Also
 
-- [X3D Specification of TextureProjectorParallel](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/textureprojector.html#TextureProjectorParallel){:target="_blank"}
+- [X3D Specification of TextureProjectorParallel node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/textureprojector.html#TextureProjectorParallel){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: ImageTexture
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Texturing
 categories: [components, Texturing]
 tags: [ImageTexture, Texturing]
@@ -13,9 +13,9 @@ tags: [ImageTexture, Texturing]
 
 ## Overview
 
-ImageTexture maps a 2D-image file onto a geometric shape. 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.
+ImageTexture maps a 2D-image file onto a geometric shape. 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 ImageTexture node belongs to the **Texturing** component and its default container field is *texture.* It is available since X3D version 2.0 or later.
+The ImageTexture 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 ImageTexture 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,15 @@ 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] **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 ImageTexture 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 +63,14 @@ Location and filename of image. Multiple locations are more reliable, and includ
 
 #### 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>
 
@@ -96,17 +99,17 @@ Location and filename of image. Multiple locations are more reliable, and includ
 
 ### 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
 
@@ -114,6 +117,12 @@ Field textureProperties.
 - Insert Shape and Appearance nodes before adding texture.
 - Authors can provide multiple image formats for the same image, with each source address listed separately in the url field.
 - Player support is required for .png and .jpg formats, support is suggested for .gif format. Other image formats are optionally supported.
+- [X3D Scene Authoring Hints, Images](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 and reduce file size by 25%.
+- 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"}
+- [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"}
 
 ### Warnings
 
@@ -124,7 +133,6 @@ Field textureProperties.
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Texturing/ImageTexture/ImageTexture.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ImageTexture](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#ImageTexture){:target="_blank"}
-- [X3D Scene Authoring Hints, Images](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images){:target="_blank"}
+- [X3D Specification of ImageTexture node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/texturing.html#ImageTexture){:target="_blank"}

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,7 +46,7 @@ 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
 
@@ -50,11 +54,11 @@ 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>
@@ -63,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>
 
@@ -100,11 +103,11 @@ Location and filename of movie file or stream. Multiple locations are more relia
 
 ### 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.
+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.
+- Negative *gain* factors negate the input signal.
 
 #### Warning
 
@@ -116,15 +119,20 @@ 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** 0 <small>(-∞,∞)</small>
 
@@ -132,15 +140,15 @@ 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** 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
 
@@ -148,11 +156,11 @@ When resumeTime becomes\<= time now, isPaused becomes false and MovieTexture bec
 
 ### 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
 
@@ -164,70 +172,93 @@ 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"}