x_ite 8.8.6 → 8.9.0

package/docs/_posts/components/Shape/Shape.md

@@ -1,6 +1,6 @@
 ---
 title: Shape
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [Shape, Shape]
@@ -13,9 +13,9 @@ tags: [Shape, Shape]
 
 ## Overview
 
-Shape can appear under any grouping node. Shape can contain an Appearance node and a geometry node (Box Cone Cylinder ElevationGrid Extrusion IndexedFaceSet IndexedLineSet LineSet PointSet Sphere Text).
+Shape can appear under any grouping node. Shape can contain an Appearance node and a geometry node (for example one of the primitives Box Cone Cylinder Sphere Text, one of ElevationGrid Extrusion IndexedFaceSet IndexedLineSet LineSet PointSet, or one of the other geometry nodes).
 
-The Shape node belongs to the **Shape** component and its default container field is *children.* It is available since X3D version 2.0 or later.
+The Shape node belongs to the **Shape** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
 
 ## Hierarchy
 
@@ -30,27 +30,31 @@ The Shape node belongs to the **Shape** component and its default container fiel
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
 
-### SFBool [ ] **visible** TRUE
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
+
+### SFBool [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
-### SFBool [ ] **castShadow** TRUE
+### SFBool [in, out] **castShadow** TRUE
 
 *castShadow* defines whether this Shape casts shadows as produced by lighting nodes.
 
-#### Hint
+#### Hints
 
 - If the visible field is FALSE, then the Shape does not cast any shadows.
 - If prior X3D3 content is loaded into an X3D4 model, then legacy Shape nodes have shadows set to true.
 
-### SFBool [ ] **bboxDisplay** FALSE
+### SFBool [in, out] **bboxDisplay** FALSE
 
 Whether to display bounding box for associated geometry, aligned with world coordinates.
 
@@ -62,28 +66,42 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
 
-#### Hint
+#### Hints
 
 - Can be useful for collision computations or inverse-kinematics (IK) engines.
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
+
+#### Hints
+
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFNode [in, out] **appearance** NULL <small>[X3DAppearanceNode]</small>
 
-Input/Output field appearance.
+Single contained Appearance node that can specify visual attributes (such as material, texture, fillProperties and lineProperties) applied to corresponding geometry.
 
 ### SFNode [in, out] **geometry** NULL <small>[X3DGeometryNode]</small>
 
-Input/Output field geometry.
+Single contained *geometry* node that is rendered according to corresponding appearance.
 
-## Description
+## Advisories
 
-### Hint
+### Hints
 
-- You can also substitute a type-matched ProtoInstance node for contained content.
+- [Shape](https://en.wikipedia.org/wiki/Shape){:target="_blank"}
+- The Shape design pattern to collect appearance and geometry together is fundamentally the same for many types of 3D graphics software and hardware.
+- For advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
+- [X3D Architecture 12.2.1 Shape nodes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shape.html#Shapenodes){: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"}
+- Apply `containerField='shape'` if parent node is CADFace.
 
-## External Links
+## See Also
 
-- [X3D Specification of Shape](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Shape){:target="_blank"}
+- [X3D Specification of Shape node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Shape){:target="_blank"}

package/docs/_posts/components/Shape/TwoSidedMaterial.md

@@ -1,6 +1,6 @@
 ---
 title: TwoSidedMaterial
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [TwoSidedMaterial, Shape]
@@ -15,9 +15,9 @@ tags: [TwoSidedMaterial, Shape]
 
 TwoSidedMaterial specifies surface rendering properties for associated geometry nodes, for outer (front) and inner (back) sides of polygons. Material attributes are used by the X3D lighting equations during rendering.
 
-The TwoSidedMaterial node belongs to the **Shape** component and its default container field is *material.* It is available since X3D version 3.2 until 4.0.
+The TwoSidedMaterial node belongs to the **Shape** component and its default container field is *material.* It is available from X3D version 3.2 to 4.0.
 
->Deprecated: This node is deprecated since X3D version 4.0. Future versions of the standard may remove this node.
+>Deprecated: This node is deprecated as of X3D version 4.0. Future versions of the standard may remove this node.
 {: .prompt-danger }
 
 ## Hierarchy
@@ -33,7 +33,11 @@ The TwoSidedMaterial node belongs to the **Shape** 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"}
 
 ### SFBool [in, out] **separateBackColor** FALSE
 
@@ -41,7 +45,7 @@ Metadata are not part of the X3D world and not interpreted by the X3D browser, b
 
 #### Warning
 
-- Backface Material values are ignored unless you set separateBackColor='true'
+- Backface Material values are ignored unless you set *separateBackColor*='true'
 
 ### SFFloat [in, out] **ambientIntensity** 0.2 <small>[0,1]</small>
 
@@ -51,9 +55,9 @@ How much ambient omnidirectional light is reflected from all light sources. Inte
 
 How much direct, angle-dependent light is reflected from all light sources.
 
-#### Hints
+#### Hint
 
-- Only emissiveColor affects IndexedLineSet, LineSet and PointSet. If a texture is present the diffuseColor is always multiplied with the texture color, in contrast to the specification. Set diffuseColor to (1 1 1) to get maximum texture color intensity.
+- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
 
 ### SFColor [in, out] **specularColor** 0 0 0 <small>[0,1]</small>
 
@@ -65,27 +69,21 @@ How much glowing light is emitted from this object.
 
 #### Hints
 
-- EmissiveColors glow even when all lights are off. Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout. Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
+- EmissiveColors glow even when all lights are off.
+- Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
+- Only *emissiveColor* affects IndexedLineSet, LineSet and PointSet.
 
 #### Warning
 
-- Bright emissiveColor values can wash out other colors and some textures.
+- Bright *emissiveColor* values can wash out other colors and some textures.
 
 ### SFFloat [in, out] **shininess** 0.2 <small>[0,1]</small>
 
-Lower shininess values provide soft specular glows, while higher values result in sharper, smaller highlights. Interchange profile hint: this field may be ignored, applying the default value regardless.
+Lower *shininess* values provide soft specular glows, while higher values result in sharper, smaller highlights. Interchange profile hint: this field may be ignored, applying the default value regardless.
 
 ### SFFloat [in, out] **transparency** 0 <small>[0,1]</small>
 
-How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque.
-
-#### Interchange profile hint:
-
-Transparency < .5 opaque, transparency > .5 transparent.
-
-#### Hint
-
-- If a texture is present the transparency is always multiplied with the texture's transparency, in contrast to the specification. Set transparency to (0) to get a full opaque texture color.
+How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile hint: *transparency* \< .5 opaque, *transparency* \> .5 transparent.
 
 ### SFFloat [in, out] **backAmbientIntensity** 0.2 <small>[0,1]</small>
 
@@ -95,9 +93,9 @@ How much ambient omnidirectional light is reflected from all light sources. Inte
 
 How much direct, angle-dependent light is reflected from all light sources.
 
-#### Hints
+#### Hint
 
-- Only emissiveColor affects IndexedLineSet, LineSet and PointSet. If a texture is present the diffuseColor is always multiplied with the texture color, in contrast to the specification. Set diffuseColor to (1 1 1) to get maximum texture color intensity.
+- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
 
 ### SFColor [in, out] **backSpecularColor** 0 0 0 <small>[0,1]</small>
 
@@ -109,7 +107,9 @@ How much glowing light is emitted from this object.
 
 #### Hints
 
-- EmissiveColors glow even when all lights are off. Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout. Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
+- EmissiveColors glow even when all lights are off.
+- Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
+- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
 
 #### Warning
 
@@ -121,29 +121,28 @@ Lower shininess values provide soft specular glows, while higher values result i
 
 ### SFFloat [in, out] **backTransparency** 0 <small>[0,1]</small>
 
-How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque.
-
-#### Interchange profile hint
-
-Transparency < .5 opaque, transparency > .5 transparent.
-
-#### Hint
+How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile hint: transparency \< .5 opaque, transparency \> .5 transparent.
 
-- If a texture is present the transparency is always multiplied with the texture's transparency, in contrast to the specification. Set transparency to (0) to get a full opaque texture color.
-
-## Description
+## Advisories
 
 ### Hints
 
-- Include `<component name='Shape' level='4'/>`
 - Insert Shape and Appearance nodes before adding material.
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+- [X3D Architecture 12.2.3 Two-sided materials](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shape.html#TwoSidedMaterials){: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"}
+
+### Warnings
+
+- Requires X3D `profile='Full'` or else include `<component name='Shape' level='4'/>`
+- Corresponding geometry within the parent Shape must have solid='false' for two-sided rendering, otherwise no reverse-side back geometry is displayed.
+- X3D4 Architecture has deprecated TwoSidedMaterial, preferring use of child backMaterial node in parent Appearance.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/Shape/TwoSidedMaterial/TwoSidedMaterial.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of TwoSidedMaterial](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#TwoSidedMaterial){:target="_blank"}
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+- [X3D Specification of TwoSidedMaterial node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#TwoSidedMaterial){:target="_blank"}

package/docs/_posts/components/Shape/UnlitMaterial.md

@@ -15,7 +15,7 @@ tags: [UnlitMaterial, Shape]
 
 UnlitMaterial specifies surface rendering properties for associated geometry nodes. Material attributes are used by the X3D lighting equations during rendering.
 
-The UnlitMaterial node belongs to the **Shape** component and its default container field is *material.* It is available since X3D version 4.0 or later.
+The UnlitMaterial node belongs to the **Shape** component and its default container field is *material.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
@@ -31,7 +31,11 @@ The UnlitMaterial node belongs to the **Shape** component and its default contai
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFColor [in, out] **emissiveColor** 1 1 1 <small>[0,1]</small>
 
@@ -39,18 +43,22 @@ How much glowing light is emitted from this object.
 
 #### Hints
 
-- emissiveColors glow even when all lights are off.
-- Reset diffuseColor from default (0.8 0.8 0.8) to (0 0 0) to avoid washout.
-- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
+- EmissiveColors glow even when all lights are off.
+- Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
+- Only *emissiveColor* affects IndexedLineSet, LineSet and PointSet.
 
 #### Warning
 
-- Bright emissiveColor values can wash out other colors and some textures.
+- Bright *emissiveColor* values can wash out other colors and some textures.
 
 ### SFString [in, out] **emissiveTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **emissiveTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying emissiveColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
@@ -58,7 +66,7 @@ When applying emissiveColor for this material node, the contained texture provid
 #### Hints
 
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='emissiveTexture'
+- Contained texture node must include `containerField='emissiveTexture'`
 
 ### SFFloat [in, out] **normalScale** 1 <small>[0,∞)</small>
 
@@ -66,37 +74,37 @@ When applying emissiveColor for this material node, the contained texture provid
 
 #### Hints
 
-- normalScale only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
-- normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping
+- *normalScale* only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
+- [NormalTexture techniques apply Bump mapping](https://en.wikipedia.org/wiki/Bump_mapping){:target="_blank"}
 
 ### SFString [in, out] **normalTextureMapping** ""
 
 The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
 
+#### Hint
+
+- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
+
 ### SFNode [in, out] **normalTexture** NULL <small>[X3DSingleTextureNode]</small>
 
 When applying normalScale for this material node, the contained texture modulates the texture across the surface.
 
 #### Hints
 
-- normalTexture techniques apply Bump mapping https://en.wikipedia.org/wiki/Bump_mapping
+- [*normalTexture* techniques apply Bump mapping](https://en.wikipedia.org/wiki/Bump_mapping){:target="_blank"}
 - If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include containerField='normalTexture'
+- Contained texture node must include `containerField='normalTexture'`
 
 ### SFFloat [in, out] **transparency** 0 <small>[0,1]</small>
 
-How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque.
+How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile hint: *transparency* \< .5 opaque, *transparency* \> .5 transparent.
 
-## Description
+## Advisories
 
 ### Hints
 
 - Insert Shape and Appearance nodes before adding material.
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-
-## External Links
-
-- [X3D Specification of UnlitMaterial](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#UnlitMaterial){:target="_blank"}
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 - [X3D Example Archives, Basic, Universal Media Materials](https://www.web3d.org/x3d/content/examples/Basic/UniversalMediaMaterials){: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"}
@@ -105,3 +113,7 @@ How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaqu
 - [Physically based rendering (PBR)](https://en.wikipedia.org/wiki/Physically_based_rendering){:target="_blank"}
 - [Non-photorealistic rendering (NPR)](https://en.wikipedia.org/wiki/Non-photorealistic_rendering){:target="_blank"}
 - [Cel shading (toon shading)](https://en.wikipedia.org/wiki/Cel_shading){:target="_blank"}
+
+## See Also
+
+- [X3D Specification of UnlitMaterial node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#UnlitMaterial){:target="_blank"}

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

@@ -13,60 +13,193 @@ tags: [Analyser, Sound]
 
 ## Overview
 
-Analyser ...
+Analyser provides real-time frequency and time-domain analysis information, without any change to the input.
 
-The Analyser node belongs to the **Sound** component and its default container field is *children.* It is available since X3D version 4.0 or later.
+The Analyser node belongs to the **Sound** component and its default container field is *children.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
 ```
 + X3DNode
+  + X3DChildNode
+   + X3DTimeDependentNode
+     + X3DSoundProcessingNode
+       + Analyser
 ```
 
 ## Fields
 
 ### 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
 
-### SFFloat [in, out] **gain** <small></small>
+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.
+
+### SFInt32 [in, out] **fftSize** 2048 <small>[0,∞)</small>
+
+*fftSize* represents size of Fast Fourier Transform (FFT) used to determine frequency domain.
+
+#### Hint
+
+- [Fast Fourier Transform (FFT)](https://en.wikipedia.org/wiki/Fast_Fourier_transform){:target="_blank"}
 
-### SFInt32 [in, out] **fftSize** <small></small>
+### SFInt32 [in, out] **frequencyBinCount** 1024 <small>[0,∞)</small>
 
-### SFInt32 [in, out] **frequencyBinCount** <small></small>
+*frequencyBinCount* is half of fftSize and generally equates to number of data values available for the visualization.
 
-### SFFloat [in, out] **minDecibels** <small></small>
+### SFFloat [in, out] **minDecibels** -100 <small>(-∞,∞)</small>
 
-### SFFloat [in, out] **maxDecibels** <small></small>
+*minDecibels* represents minimum power value in scaling range for FFT analysis data.
 
-### SFFloat [in, out] **smoothingTimeConstant** <small></small>
+### SFFloat [in, out] **maxDecibels** -30 <small>(-∞,∞)</small>
 
-### SFTime [in, out] **tailTime** <small></small>
+*maxDecibels* represents maximum power value in scaling range for FFT analysis data.
+
+### SFFloat [in, out] **smoothingTimeConstant** 0.8<small>[0,∞)</small>
+
+*smoothingTimeConstant* represents averaging constant during last analysis frame.
+
+### 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.
+
+#### Hint
+
+- *tailTime* always has a value of zero for Analyser.
 
 ### SFInt32 [out] **channelCount**
 
-### SFString [in, out] **channelCountMode** <small></small>
+*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"}
 
-### SFString [in, out] **channelInterpretation** <small></small>
+### SFTime [in, out] **startTime** 0 <small>(-∞,∞)</small>
 
-### SFTime [in, out] **startTime** <small>(-∞,∞)</small>
+Absolute time: number of seconds since January 1, 1970, 00:00:00 GMT.
 
-### SFTime [in, out] **resumeTime** <small>(-∞,∞)</small>
+#### Hint
 
-### SFTime [in, out] **pauseTime** <small>(-∞,∞)</small>
+- ROUTE a time value matching system clock to this field, such as output event from TouchSensor touchTime or TimeTrigger triggerTime.
 
-### SFTime [in, out] **stopTime** <small>(-∞,∞)</small>
+### 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**
 
-### MFNode [in, out] **children** <small></small>
+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>
+
+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/#analysernode){:target="_blank"}
 
-## External Links
+## See Also
 
-- [X3D Specification of Analyser](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#Analyser){:target="_blank"}
+- [X3D Specification of Analyser node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/sound.html#Analyser){:target="_blank"}