x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/VolumeRendering/IsoSurfaceVolumeData.md

@@ -1,6 +1,6 @@
 ---
 title: IsoSurfaceVolumeData
-date: 2022-01-07
+date: 2023-01-07
 nav: components-VolumeRendering
 categories: [components, VolumeRendering]
 tags: [IsoSurfaceVolumeData, VolumeRendering]
@@ -15,7 +15,7 @@ tags: [IsoSurfaceVolumeData, VolumeRendering]
 
 IsoSurfaceVolumeData displays one or more surfaces extracted from a voxel dataset. A surface is defined as the boundary between regions in the volume where the voxel values are larger than a given value (the iso value) on one side of the boundary and smaller on the other side, and the gradient magnitude is larger than surfaceTolerance.
 
-The IsoSurfaceVolumeData node belongs to the **VolumeRendering** component and its default container field is *children.* It is available since X3D version 3.3 or later.
+The IsoSurfaceVolumeData node belongs to the **VolumeRendering** component and its default container field is *children.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -32,23 +32,27 @@ The IsoSurfaceVolumeData node belongs to the **VolumeRendering** component and i
 
 ### 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"}
 
 ### SFVec3f [in, out] **dimensions** 1 1 1 <small>(0,∞)</small>
 
-Actual-size X-Y-Z dimensions of volume data in local coordinate system.
+Actual-size X-Y-Z *dimensions* of volume data in local coordinate system.
 
 ### SFFloat [in, out] **contourStepSize** 0 <small>(-∞,∞)</small>
 
-If contourStepSize is non-zero, also render all isosurfaces that are multiples of that step size from initial surface value.
+If *contourStepSize* is non-zero, also render all isosurfaces that are multiples of that step size from initial surface value.
 
 #### Hint
 
-- ContourStepSize can be negative so that steppping can proceed in a negative direction.
+- *contourStepSize* can be negative so that steppping can proceed in a negative direction.
 
 ### MFFloat [in, out] **surfaceValues** [ ] <small>(-∞,∞)</small>
 
-If surfaceValues has one value defined, render corresponding isosurface plus any isosurfaces based on contourStepSize. If surfaceValues has more than one value defined, ignore contourStepSize and render surfaces corresponding to listed surfaceValues.
+If *surfaceValues* has one value defined, render corresponding isosurface plus any isosurfaces based on contourStepSize. If *surfaceValues* has more than one value defined, ignore contourStepSize and render surfaces corresponding to listed *surfaceValues*.
 
 ### SFFloat [in, out] **surfaceTolerance** 0 <small>[0,∞)</small>
 
@@ -56,16 +60,16 @@ Threshold for gradient magnitude for voxel inolusion in isosurface.
 
 #### Hint
 
-- Contained Texture3D node with containerField='gradients' can provide explicit per-voxel gradient direction information for determining surface boundaries.
+- Contained Texture3D node with `containerField='gradients'` can provide explicit per-voxel gradient direction information for determining surface boundaries.
 
 ### SFBool [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
 ### SFBool [in, out] **bboxDisplay** FALSE
 
@@ -79,38 +83,56 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 Bounding box size is usually omitted, and can easily be calculated automatically by an X3D player at scene-loading time with minimal computational cost. Bounding box size can also be defined as an optional authoring hint that suggests an optimization or constraint.
 
-#### Hint
+#### Hints
 
 - Can be useful for collision computations or inverse-kinematics (IK) engines.
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
+
+#### Hints
+
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### MFNode [in, out] **renderStyle** [ ] <small>[X3DVolumeRenderStyleNode]</small>
 
-Input/Output field renderStyle.
+Multiple contained X3DVolumeRenderStyleNode nodes corresponding to each isosurface that define specific rendering technique for this volumetric object.
+
+#### Warning
+
+- If not defined, no default renderStyle is defined.
 
 ### SFNode [in, out] **gradients** NULL <small>[X3DTexture3DNode]</small>
 
-Input/Output field gradients.
+Single contained X3DTexture3DNode (ComposedTexture3D, ImageTexture3D, PixelTexture3D) that provides explicit per-voxel gradient direction information for determining surface boundaries, rather than having it implicitly calculated by the implementation.
 
 ### SFNode [in, out] **voxels** NULL <small>[X3DTexture3DNode]</small>
 
-Input/Output field voxels.
+Single contained X3DTexture3DNode (ComposedTexture3D, ImageTexture3D, PixelTexture3D) that provides raw voxel information utilized by corresponding rendering styles. Any number of color components (1-4) may be defined.
 
-## Description
+## Advisories
 
 ### Hints
 
-- IsoSurfaceVolumeData can contain a single Texture3D node with containerField='gradients' that is used to provide explicit per-voxel gradient direction information for determining surface boundaries, rather than having values implicitly calculated by the implementation.
-- IsoSurfaceVolumeData can contain another Texture3D node with containerField='voxels' containing voxel data.
+- IsoSurfaceVolumeData can contain a single Texture3D node with `containerField='gradients'` that is used to provide explicit per-voxel gradient direction information for determining surface boundaries, rather than having values implicitly calculated by the implementation.
+- IsoSurfaceVolumeData can contain another Texture3D node with `containerField='voxels'` containing voxel data.
 - IsoSurfaceVolumeData can contain multiple VolumeStyle nodes.
 
+### Warnings
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+- Requires X3D `profile='Full'` or else include `<component name='VolumeRendering' level='2'/>`
+
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/VolumeRendering/IsoSurfaceVolumeData/IsoSurfaceVolumeData.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of IsoSurfaceVolumeData](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#IsoSurfaceVolumeData){:target="_blank"}
+- [X3D Specification of IsoSurfaceVolumeData node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#IsoSurfaceVolumeData){:target="_blank"}

package/docs/_posts/components/VolumeRendering/OpacityMapVolumeStyle.md

@@ -1,6 +1,6 @@
 ---
 title: OpacityMapVolumeStyle
-date: 2022-01-07
+date: 2023-01-07
 nav: components-VolumeRendering
 categories: [components, VolumeRendering]
 tags: [OpacityMapVolumeStyle, VolumeRendering]
@@ -15,7 +15,7 @@ tags: [OpacityMapVolumeStyle, VolumeRendering]
 
 OpacityMapVolumeStyle specifies that volumetric data is rendered using opacity mapped to a transfer function texture.
 
-The OpacityMapVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available since X3D version 3.3 or later.
+The OpacityMapVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -34,18 +34,26 @@ Enables/disables node operation.
 
 ### 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"}
 
 ### SFNode [in, out] **transferFunction** NULL <small>[X3DTexture2DNode,X3DTexture3DNode]</small>
 
-Input/Output field transferFunction.
+The *transferFunction* field holds a single texture representation in either two or three dimensions that maps the voxel data values to a specific colour output. If no value is supplied for this field, the default implementation shall generate a 256x1 alpha-only image that blends from completely transparent at pixel 0 to fully opaque at pixel 255.The texture may be any number of dimensions and any number of components. The voxel values are used as a lookup coordinates into the transfer function texture, where the texel value represents the output colour.
 
-## Description
+## Advisories
 
 ### Hint
 
-- Contains a single ImageTexture2D or ImageTexture3D node with containerField='transferFunction'. Voxel values are used as lookup coordinates into the transfer function texture, where the texel value represents the output color.
+- Contains a single ImageTexture2D or ImageTexture3D node with `containerField='transferFunction'.` Voxel values are used as lookup coordinates into the transfer function texture, where the texel value represents the output color.
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='VolumeRendering' level='2'/>`
 
-## External Links
+## See Also
 
-- [X3D Specification of OpacityMapVolumeStyle](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#OpacityMapVolumeStyle){:target="_blank"}
+- [X3D Specification of OpacityMapVolumeStyle node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#OpacityMapVolumeStyle){:target="_blank"}

package/docs/_posts/components/VolumeRendering/ProjectionVolumeStyle.md

@@ -1,6 +1,6 @@
 ---
 title: ProjectionVolumeStyle
-date: 2022-01-07
+date: 2023-01-07
 nav: components-VolumeRendering
 categories: [components, VolumeRendering]
 tags: [ProjectionVolumeStyle, VolumeRendering]
@@ -15,7 +15,7 @@ tags: [ProjectionVolumeStyle, VolumeRendering]
 
 ProjectionVolumeStyle uses voxel data to directly generate output color.
 
-The ProjectionVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available since X3D version 3.3 or later.
+The ProjectionVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The ProjectionVolumeStyle node belongs to the **VolumeRendering** component and
 
 ### 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] **enabled** TRUE
 
@@ -37,11 +41,11 @@ Enables/disables node operation.
 
 ### SFString [in, out] **type** "MAX" <small>["MAX"|"MIN"|"AVERAGE"]</small>
 
-If type=MAX then Maximum Intensity Projection (MIP) or Least MIP (LMIP) algorithm is used to generate output color. If type=MIN then Minimum Intensity Projection algorithm is used. If type=AVERAGE then all voxels along ray are averaged.
+If *type*=MAX then Maximum Intensity Projection (MIP) or Least MIP (LMIP) algorithm is used to generate output color. If *type*=MIN then Minimum Intensity Projection algorithm is used. If *type*=AVERAGE then all voxels along ray are averaged.
 
 #### Hint
 
-- type=AVERAGE matches a simple approximation of an X-ray.
+- *type*=AVERAGE matches a simple approximation of an X-ray.#10;
 
 #### Warning
 
@@ -55,6 +59,12 @@ Threshold value used when type=MIN (LMIP) or type=MAX (MIP).
 
 - Ignored if type=AVERAGE (no thresholding).
 
-## External Links
+## Advisories
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='VolumeRendering' level='2'/>`
+
+## See Also
 
-- [X3D Specification of ProjectionVolumeStyle](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#ProjectionVolumeStyle){:target="_blank"}
+- [X3D Specification of ProjectionVolumeStyle node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#ProjectionVolumeStyle){:target="_blank"}

package/docs/_posts/components/VolumeRendering/SegmentedVolumeData.md

@@ -1,6 +1,6 @@
 ---
 title: SegmentedVolumeData
-date: 2022-01-07
+date: 2023-01-07
 nav: components-VolumeRendering
 categories: [components, VolumeRendering]
 tags: [SegmentedVolumeData, VolumeRendering]
@@ -15,7 +15,7 @@ tags: [SegmentedVolumeData, VolumeRendering]
 
 SegmentedVolumeData displays a segmented voxel dataset with different RenderStyle nodes.
 
-The SegmentedVolumeData node belongs to the **VolumeRendering** component and its default container field is *children.* It is available since X3D version 3.3 or later.
+The SegmentedVolumeData node belongs to the **VolumeRendering** component and its default container field is *children.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -30,24 +30,32 @@ The SegmentedVolumeData node belongs to the **VolumeRendering** component and it
 
 ### 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"}
 
 ### SFVec3f [in, out] **dimensions** 1 1 1 <small>(0,∞)</small>
 
-Actual-size X-Y-Z dimensions of volume data in local coordinate system.
+Actual-size X-Y-Z *dimensions* of volume data in local coordinate system.
 
 ### MFBool [in, out] **segmentEnabled** [ ]
 
-Input/Output field segmentEnabled.
+Array of boolean values that indicates whether to draw each segment, with indices corresponding to the segment identifier.
+
+#### Hint
+
+- If a segment index is found greater than the array length, it shall be rendered.
 
 ### SFBool [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
 ### SFBool [in, out] **bboxDisplay** FALSE
 
@@ -61,37 +69,62 @@ 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] **segmentIdentifiers** NULL <small>[X3DTexture3DNode]</small>
 
-Input/Output field segmentIdentifiers.
+Single contained X3DTexture3DNode (ComposedTexture3D, ImageTexture3D, PixelTexture3D) holds component texture that provides corresponding segment identifier.
+
+#### Hint
+
+- If more than one color component is contained, only initial color component defines the segment identifier.
+
+#### Warning
+
+- If *segmentIdentifiers* texture is not identical in size to the main voxels, it shall be ignored.
 
 ### MFNode [in, out] **renderStyle** [ ] <small>[X3DVolumeRenderStyleNode]</small>
 
-Input/Output field renderStyle.
+Multiple contained X3DVolumeRenderStyleNode nodes corresponding to each isosurface that define specific rendering technique for this volumetric object.
+
+#### Warning
+
+- If not defined, no default renderStyle is defined.
 
 ### SFNode [in, out] **voxels** NULL <small>[X3DTexture3DNode]</small>
 
-Input/Output field voxels.
+Single contained X3DTexture3DNode (ComposedTexture3D, ImageTexture3D, PixelTexture3D) that provides raw voxel information utilized by corresponding rendering styles. Any number of color components (1-4) may be defined.
 
-## Description
+## Advisories
 
 ### Hints
 
-- SegmentedVolumeData can contain a single ComposedTexture3D, ImageTexture3D or PixelTexture3D node with containerField='segmentIdentifiers' and another with containerField='voxels'.
+- SegmentedVolumeData can contain a single ComposedTexture3D, ImageTexture3D or PixelTexture3D node with `containerField='segmentIdentifiers'` and another with `containerField='voxels'.`
 - SegmentedVolumeData can contain multiple RenderStyle nodes.
 
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='VolumeRendering' level='2'/>`
+
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/VolumeRendering/SegmentedVolumeData/SegmentedVolumeData.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of SegmentedVolumeData](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#SegmentedVolumeData){:target="_blank"}
+- [X3D Specification of SegmentedVolumeData node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#SegmentedVolumeData){:target="_blank"}

package/docs/_posts/components/VolumeRendering/ShadedVolumeStyle.md

@@ -1,6 +1,6 @@
 ---
 title: ShadedVolumeStyle
-date: 2022-01-07
+date: 2023-01-07
 nav: components-VolumeRendering
 categories: [components, VolumeRendering]
 tags: [ShadedVolumeStyle, VolumeRendering]
@@ -15,7 +15,7 @@ tags: [ShadedVolumeStyle, VolumeRendering]
 
 ShadedVolumeStyle applies Blinn-Phong illumination model to volume rendering.
 
-The ShadedVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available since X3D version 3.3 or later.
+The ShadedVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -30,7 +30,11 @@ The ShadedVolumeStyle node belongs to the **VolumeRendering** 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"}
 
 ### SFBool [in, out] **enabled** TRUE
 
@@ -42,7 +46,7 @@ Whether rendering calculates and applies shading effects to visual output.
 
 ### SFBool [in, out] **shadows** FALSE
 
-Whether rendering calculates and applies shadows to visual output (using global illumination model).
+Whether rendering calculates and applies *shadows* to visual output (using global illumination model).
 
 ### SFString [ ] **phaseFunction** "Henyey-Greenstein" <small>["Henyey-Greenstein"|"NONE"|...]</small>
 
@@ -54,22 +58,26 @@ Define scattering model for implementations using global illumination (NONE or H
 
 ### SFNode [in, out] **material** NULL <small>[X3DMaterialNode]</small>
 
-Input/Output field material.
+Colour and opacity is determined based on whether a value has been specified for the *material* field.
 
 ### SFNode [in, out] **surfaceNormals** NULL <small>[X3DTexture3DNode]</small>
 
-Input/Output field surfaceNormals.
+The *surfaceNormals* field contains a 3D texture with at least three component values. Each voxel in the texture represents the surface normal direction for the corresponding voxel in the base data source.
 
-## Description
+## Advisories
 
 ### Hint
 
-- ShadedVolumeStyle can contain a single Texture3D node with containerField='surfaceNormals' and a single Material node.
+- ShadedVolumeStyle can contain a single Texture3D node with `containerField='surfaceNormals'` and a single Material node.
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='VolumeRendering' level='3'/>` or level='4' to include shadows.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/VolumeRendering/ShadedVolumeStyle/ShadedVolumeStyle.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ShadedVolumeStyle](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#ShadedVolumeStyle){:target="_blank"}
+- [X3D Specification of ShadedVolumeStyle node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#ShadedVolumeStyle){:target="_blank"}

package/docs/_posts/components/VolumeRendering/SilhouetteEnhancementVolumeStyle.md

@@ -1,6 +1,6 @@
 ---
 title: SilhouetteEnhancementVolumeStyle
-date: 2022-01-07
+date: 2023-01-07
 nav: components-VolumeRendering
 categories: [components, VolumeRendering]
 tags: [SilhouetteEnhancementVolumeStyle, VolumeRendering]
@@ -15,7 +15,7 @@ tags: [SilhouetteEnhancementVolumeStyle, VolumeRendering]
 
 SilhouetteEnhancementVolumeStyle specifies that volumetric data is rendered with silhouette enhancement.
 
-The SilhouetteEnhancementVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available since X3D version 3.3 or later.
+The SilhouetteEnhancementVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -30,7 +30,11 @@ The SilhouetteEnhancementVolumeStyle node belongs to the **VolumeRendering** com
 
 ### 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] **enabled** TRUE
 
@@ -50,14 +54,18 @@ Power function to control sharpness of the silhouette.
 
 ### SFNode [in, out] **surfaceNormals** NULL <small>[X3DTexture3DNode]</small>
 
-Input/Output field surfaceNormals.
+The *surfaceNormals* field contains a 3D texture with at least three component values. Each voxel in the texture represents the surface normal direction for the corresponding voxel in the base data source.
 
-## Description
+## Advisories
 
 ### Hint
 
-- SilhouetteEnhancementVolumeStyle can contain a single Texture3D node with containerField='surfaceNormals'
+- SilhouetteEnhancementVolumeStyle can contain a single Texture3D node with `containerField='surfaceNormals'`
+
+### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='VolumeRendering' level='2'/>`
 
-## External Links
+## See Also
 
-- [X3D Specification of SilhouetteEnhancementVolumeStyle](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#SilhouetteEnhancementVolumeStyle){:target="_blank"}
+- [X3D Specification of SilhouetteEnhancementVolumeStyle node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#SilhouetteEnhancementVolumeStyle){:target="_blank"}

package/docs/_posts/components/VolumeRendering/ToneMappedVolumeStyle.md

@@ -1,6 +1,6 @@
 ---
 title: ToneMappedVolumeStyle
-date: 2022-01-07
+date: 2023-01-07
 nav: components-VolumeRendering
 categories: [components, VolumeRendering]
 tags: [ToneMappedVolumeStyle, VolumeRendering]
@@ -15,7 +15,7 @@ tags: [ToneMappedVolumeStyle, VolumeRendering]
 
 ToneMappedVolumeStyle specifies that volumetric data is rendered with Gooch shading model of two-toned warm/cool coloring.
 
-The ToneMappedVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available since X3D version 3.3 or later.
+The ToneMappedVolumeStyle node belongs to the **VolumeRendering** component and its default container field is *renderStyle.* It is available from X3D version 3.3 or higher.
 
 ## Hierarchy
 
@@ -30,7 +30,11 @@ The ToneMappedVolumeStyle node belongs to the **VolumeRendering** component and
 
 ### 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] **enabled** TRUE
 
@@ -40,7 +44,7 @@ Enables/disables node operation.
 
 *coolColor* is used for surfaces facing away from the light direction.
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
@@ -48,24 +52,29 @@ Enables/disables node operation.
 
 *warmColor* is used for surfaces facing towards the light.
 
-#### See Also
+#### Hint
 
 - [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
 ### SFNode [in, out] **surfaceNormals** NULL <small>[X3DTexture3DNode]</small>
 
-Input/Output field surfaceNormals.
+The *surfaceNormals* field contains a 3D texture with at least three component values. Each voxel in the texture represents the surface normal direction for the corresponding voxel in the base data source.
+
+## Advisories
+
+### Hints
 
-## Description
+- ToneMappedVolumeStyle can contain a single Texture3D node with `containerField='surfaceNormals'`
+- [Gooch shading](https://en.wikipedia.org/wiki/Gooch_shading){:target="_blank"}
 
-### Hint
+### Warning
 
-- ToneMappedVolumeStyle can contain a single Texture3D node with containerField='surfaceNormals'
+- Requires X3D `profile='Full'` or else include `<component name='VolumeRendering' level='2'/>`
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/VolumeRendering/ToneMappedVolumeStyle/ToneMappedVolumeStyle.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ToneMappedVolumeStyle](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#ToneMappedVolumeStyle){:target="_blank"}
+- [X3D Specification of ToneMappedVolumeStyle node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/volume.html#ToneMappedVolumeStyle){:target="_blank"}