x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/Sound/WaveShaper.md

@@ -13,9 +13,9 @@ tags: [WaveShaper, Sound]
 
 ## Overview
 
-WaveShaper ...
+WaveShaper node represents a nonlinear distorter that applies a wave-shaping distortion curve to the signal. Non-linear waveshaping distortion is commonly used for both subtle non-linear warming, or more obvious distortion effects. Arbitrary non-linear shaping curves may be specified.
 
-The WaveShaper node belongs to the **Sound** component and its default container field is *children.* It is available since X3D version 4.0 or later.
+The WaveShaper node belongs to the **Sound** component and its default container field is *children.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
@@ -31,40 +31,159 @@ The WaveShaper node belongs to the **Sound** component and its default container
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
+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** ""
 
+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 &amp; ampersand character, or &amp;#34; for " quotation-mark character).
+
 ### SFBool [in, out] **enabled** TRUE
 
+Enables/disables node operation.
+
 ### 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.
+
 ### MFFloat [in, out] **curve** [ ] <small>[-1,-1]</small>
 
+The *curve* field is an array of floating-point numbers describing the distortion to apply.
+
 ### SFString [in, out] **oversample** "NONE" <small>["NONE", "2x", "4x"]</small>
 
+The *oversample* field is specifies what type of oversampling (if any) should be used when applying the shaping curve. Allowed values follow. Note that for some applications, avoiding oversampling can produce a precise shaping curve.
+
+#### Hint
+
+- [W3C Web Audio API](https://www.w3.org/TR/webaudio/#enumdef-oversampletype){:target="_blank"}
+
 ### SFTime [in, out] **tailTime** 0 <small>[0,∞)</small>
 
+*tailTime* is duration of time that a node continues to provide output signal after the input signal becomes silent.
+
 ### SFInt32 [out] **channelCount**
 
+*channelCount* reports number of channels provided by input nodes.
+
+#### Hint
+
+- [W3C Web Audio API](https://www.w3.org/TR/webaudio/#dom-audionode-channelcount){:target="_blank"}
+
 ### SFString [in, out] **channelCountMode** "MAX" <small>["MAX", "CLAMPED-MAX", "EXPLICIT"]</small>
 
+*channelCountMode* determines how individual channels are counted when up-mixing and down-mixing connections to any inputs.
+
+#### Hint
+
+- [W3C Web Audio API](https://www.w3.org/TR/webaudio/#dom-audionode-channelcountmode){:target="_blank"}
+
 ### SFString [in, out] **channelInterpretation** "SPEAKERS" <small>["SPEAKERS", "DISCRETE"]</small>
 
+*channelInterpretation* determines how individual channels are treated when up-mixing and down-mixing connections to any inputs.
+
+#### Hint
+
+- [W3C Web Audio API](https://www.w3.org/TR/webaudio/#dom-audionode-channelinterpretation){:target="_blank"}
+
 ### SFTime [in, out] **startTime** 0 <small>(-∞,∞)</small>
 
+Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
+
+#### Hint
+
+- 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 AudioClip becomes active. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
+
+#### Hint
+
+- ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
+
 ### SFTime [in, out] **pauseTime** 0 <small>(-∞,∞)</small>
 
+When time now \>= *pauseTime*, isPaused becomes true and AudioClip becomes paused. Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
+
+#### Hint
+
+- ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
+
 ### SFTime [in, out] **stopTime** 0 <small>(-∞,∞)</small>
 
+Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
+
+#### Hint
+
+- 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.
+
 ### SFBool [out] **isPaused**
 
+*isPaused* true/false events are sent when AudioClip is paused/resumed.
+
+#### Warning
+
+- 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 AudioClip activated/running, cumulative in seconds, and not counting any paused time.
+
+#### Hint
+
+- *elapsedTime* is a nonnegative SFTime duration interval, not an absolute clock time.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### MFNode [in, out] **children** [ ] <small>[X3DSoundChannelNode,X3DSoundProcessingNode,X3DSoundSourceNode]</small>
 
-## External Links
+The *children* field specifies audio-graph sound sources providing input signals for this node. If multiple input signals are provided by the inputs *children* field, all channels are mixed together and merged prior to presentation.
+
+#### Hint
+
+- Can be original (DEF) or referenced (USE) nodes.
+
+#### Warning
+
+- Contained AudioClip or MovieTexture nodes must have `containerField='children'` to override otherwise-incorrect defaults.
+
+## Advisories
+
+### Hint
+
+- [W3C Web Audio API](https://www.w3.org/TR/webaudio/#waveshapernode){:target="_blank"}
+
+## See Also
 
-- [X3D Specification of WaveShaper](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#WaveShaper){:target="_blank"}
+- [X3D Specification of WaveShaper node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#WaveShaper){:target="_blank"}

package/docs/_posts/components/Text/FontStyle.md

@@ -1,6 +1,6 @@
 ---
 title: FontStyle
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Text
 categories: [components, Text]
 tags: [FontStyle, Text]
@@ -15,7 +15,7 @@ tags: [FontStyle, Text]
 
 FontStyle is an X3DFontStyleNode that defines the size, family, justification, and other styles used by Text nodes.
 
-The FontStyle node belongs to the **Text** component and its default container field is *fontStyle.* It is available since X3D version 2.0 or later.
+The FontStyle node belongs to the **Text** component and its default container field is *fontStyle.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -29,106 +29,138 @@ The FontStyle node belongs to the **Text** component and its default container f
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
 
-### 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"}
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
-#### 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] **size** 1 <small>(0,∞)</small>
 
-Nominal height (in local coordinate system) of text glyphs Also sets default spacing between adjacent lines of text.
+Nominal height (in local coordinate system) of text glyphs, also sets default spacing between adjacent lines of text.
 
-### SFFloat [in, out] **spacing** 1 <small>[0,∞)</small>
+#### Hint
 
-Adjustment factor for line spacing between adjacent lines of text.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
 
-### SFBool [in, out] **horizontal** TRUE
+### SFFloat [in, out] **spacing** 1 <small>[0,∞)</small>
 
-Whether text direction is horizontal (true) or vertical (false).
+Adjustment factor for line *spacing* between adjacent lines of text.
 
 #### Hint
 
-- 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.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and user accessibility.
+
+### SFBool [in, out] **horizontal** TRUE
+
+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
 
 ### Hints
 
 - Full internationalization (i18n) and localization (l10n) features are available for any written language.
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes.
+- [Relates to Internationalization (i18n)](http://www.w3.org/standards/webdesign/i18n){:target="_blank"}
 - First add a Text node as a parent node for FontStyle.
+- [Wikipedia](https://en.wikipedia.org/wiki/Font){:target="_blank"}
 
 ## Example
 
@@ -136,10 +168,4 @@ The justify field determines alignment of the above text layout relative to the
 
 ## See Also
 
-- [ScreenFontStyle](/x_ite/components/layout/screenfontstyle)
-- [Text](/x_ite/components/text/text)
-
-## External Links
-
-- [X3D Specification of FontStyle](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/text.html#FontStyle){:target="_blank"}
-- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- [X3D Specification of FontStyle node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/text.html#FontStyle){:target="_blank"}

package/docs/_posts/components/Text/Text.md

@@ -1,6 +1,6 @@
 ---
 title: Text
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Text
 categories: [components, Text]
 tags: [Text, Text]
@@ -15,7 +15,7 @@ tags: [Text, Text]
 
 Text is a 2D (flat) geometry node that can contain multiple lines of string values. Layout and styling is controlled by a contained FontStyle node.
 
-The Text node belongs to the **Text** component and its default container field is *geometry.* It is available since X3D version 2.0 or later.
+The Text node belongs to the **Text** component and its default container field is *geometry.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -29,63 +29,91 @@ The Text node belongs to the **Text** component and its default container field
 
 ### 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.
 
-### MFString [in, out] **string** [ ]
+#### Hint
 
-Single or multiple string values to present as Text. Each value in the string array (including empty strings) gets displayed on a separate line.
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
-#### Hints
+### MFString [in, out] **string** [ ]
 
-- MFString arrays can have multiple values, so separate each individual string by quote marks. Strings can contain quote marks by first escaping them with a backslash example: "say "hello" please" Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+Single or multiple *string* values to present as Text. Each value in the *string* array (including empty strings) gets displayed on a separate line.
 
-#### See Also
+#### Hints
 
-- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- MFString arrays can have multiple values, so separate each individual *string* by quote marks.
+- Strings can contain quote marks by first escaping them with a backslash example: "say \"hello\" please"
+- 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).
+- [Relates to Internationalization (i18n)](http://www.w3.org/standards/webdesign/i18n){:target="_blank"} [Example](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter02-GeometryPrimitives/TextIndex.html){:target="_blank"} [Example](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter02-GeometryPrimitives/TextSpecialCharactersIndex.html){:target="_blank"}
 
 ### MFFloat [in, out] **length** [ ] <small>[0,∞)</small>
 
-Array of length values for each text string in the local coordinate system. Each string is stretched or compressed to fit.
+Array of *length* values for each text string in the local coordinate system. Each string is stretched or compressed to fit.
 
 ### SFFloat [in, out] **maxExtent** 0 <small>[0,∞)</small>
 
-Limits/compresses all text strings if max string length is longer than maxExtent, as measured in local coordinate system.
+Limits/compresses all text strings if max string length is longer than *maxExtent*, as measured in local coordinate system.
 
 ### SFBool [ ] **solid** FALSE
 
-Setting solid true means draw only one side of polygons (backface culling on), setting solid false means draw both sides of polygons (backface culling off).
+Setting *solid* true means draw only one side of polygons (backface culling on), setting *solid* false means draw both sides of polygons (backface culling off).
 
-#### Hint
+#### Hints
 
-- If in doubt, use solid='false' for maximum visibility.
+- Mnemonic "this geometry is *solid* like a brick" (you don't render the inside of a brick).
+- If in doubt, use *solid*='false' for maximum visibility.
+- (X3D version 4.0 draft) accessType relaxed to inputOutput in order to support animation and visualization.
 
 #### Warnings
 
-- Default value true can completely hide geometry if viewed from wrong side! Solid false not supported in VRML97.
+- Default value true can completely hide geometry if viewed from wrong side!
+- *solid* false not supported in VRML97.
 
 ### SFVec3f [out] **origin**
 
-*origin* of the text local coordinate system, in units of the coordinate system in which the Text node is embedded. The value of the origin field represents the upper left corner of the textBounds.
+*origin* of the text local coordinate system, in units of the coordinate system in which the Text node is embedded. The value of the *origin* field represents the upper left corner of the textBounds.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
 ### SFVec2f [out] **textBounds**
 
 2D bounding box value for all lines of text in the local coordinate system.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### MFVec2f [out] **lineBounds**
 
 Array of 2D bounding box values for each line of text in the local coordinate system.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFNode [in, out] **fontStyle** NULL <small>[X3DFontStyleNode]</small>
 
-Input/Output field fontStyle.
+The *fontStyle* field can contain a FontStyle or ScreenFontStyle node defining size, family, and style for presented text.
+
+#### Hint
+
+- [Wikipedia](https://en.wikipedia.org/wiki/Font){:target="_blank"}
 
-## Description
+## Advisories
 
 ### Hints
 
+- [String (computer science)](https://en.wikipedia.org/wiki/String_(computer_science)){:target="_blank"}
 - Full internationalization (i18n) and localization (l10n) features are available for any written language.
+- [Relates to Internationalization (i18n)](http://www.w3.org/standards/webdesign/i18n){:target="_blank"}
 - Insert a Shape node before adding geometry or Appearance.
-- You can also substitute a type-matched ProtoInstance node for contained content.
+- For advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
+
+### Warning
+
+- Text node requires X3D `profile='Immersive'` or `<component name='Text' level='1'/>`
 
 ## Example
 
@@ -93,10 +121,4 @@ Input/Output field fontStyle.
 
 ## See Also
 
-- [FontStyle](/x_ite/components/text/fontstyle)
-- [ScreenFontStyle](/x_ite/components/layout/screenfontstyle)
-
-## External Links
-
-- [X3D Specification of Text](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/text.html#Text){:target="_blank"}
-- [Relates to Internationalization (i18n)](https://www.w3.org/standards/webdesign/i18n){:target="_blank"}
+- [X3D Specification of Text node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/text.html#Text){:target="_blank"}

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

@@ -13,9 +13,9 @@ tags: [TextureProjector, TextureProjector]
 
 ## Overview
 
-TextureProjector ...
+TextureProjector is similar to a light that projects a texture into the scene, illuminating geometry that intersects the perspective projection volume.
 
-The TextureProjector node belongs to the **TextureProjector** component and its default container field is *children.* It is available since X3D version 4.0 or later.
+The TextureProjector 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 TextureProjector node belongs to the **TextureProjector** component and its
 
 ### 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,73 @@ 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.
+
 ### SFFloat [in, out] **fieldOfView** π/4 <small>(0,π)</small>
 
+Preferred minimum viewing angle for this projection in radians, providing minimum height or minimum width (whichever is smaller). Small field of view roughly corresponds to a telephoto lens, large field of view roughly corresponds to a wide-angle lens.
+
+#### Warning
+
+- 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/ptmperspective.png
+
+### Warning
+
+- Add textureTransform field?
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/TextureProjector/TextureProjector/TextureProjector.x3d" update="auto"></x3d-canvas>
+
+## See Also
 
-- [X3D Specification of TextureProjector](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/textureprojector.html#TextureProjector){:target="_blank"}
+- [X3D Specification of TextureProjector node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/textureprojector.html#TextureProjector){:target="_blank"}