x_ite 8.8.7 → 8.9.1

package/docs/_posts/components/NURBS/Contour2D.md

@@ -1,6 +1,6 @@
 ---
 title: Contour2D
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [Contour2D, NURBS]
@@ -15,7 +15,7 @@ tags: [Contour2D, NURBS]
 
 Contour2D groups a set of curve segments into a composite contour. The children segments form a closed loop, with first point of first child repeated as last point of last child, and last point of each segment repeated as the first point of the next consecutive segment. The children segments are type NurbsCurve2D or ContourPolyline2D, enumerated in the consecutive order of contour topology.
 
-The Contour2D node belongs to the **NURBS** component and its default container field is *trimmingContour.* It is available since X3D version 3.0 or later.
+The Contour2D node belongs to the **NURBS** component and its default container field is *trimmingContour.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -28,21 +28,29 @@ The Contour2D node belongs to the **NURBS** component and its default container
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### MFNode [in] **addChildren**
 
-Input field addChildren.
+Input field *addChildren*.
 
 ### MFNode [in] **removeChildren**
 
-Input field removeChildren.
+Input field *removeChildren*.
 
 ### MFNode [in, out] **children** [ ] <small>[NurbsCurve2D|ContourPolyline2D]</small>
 
-Input/Output field children.
+The *children* form a closed loop with first point of first child repeated as last point of last child, and the last point of a segment repeated as first point of the consecutive one.
+
+#### Hint
+
+- *children* nodes are listed in consecutive order according to topology of the contour.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -52,6 +60,6 @@ Input/Output field children.
 
 - Contour2D is not a renderable geometry node.
 
-## External Links
+## See Also
 
-- [X3D Specification of Contour2D](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#Contour2D){:target="_blank"}
+- [X3D Specification of Contour2D node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#Contour2D){:target="_blank"}

package/docs/_posts/components/NURBS/ContourPolyline2D.md

@@ -1,6 +1,6 @@
 ---
 title: ContourPolyline2D
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [ContourPolyline2D, NURBS]
@@ -15,7 +15,7 @@ tags: [ContourPolyline2D, NURBS]
 
 ContourPolyline2D defines a linear curve segment as part of a trimming contour in the u-v domain of a NURBS surface. NurbsCurve2D and ContourPolyline2D nodes that together form a closed contour, defined in the u-v parametric space of a NURBS surface, may be used as children in a Contour2D node.
 
-The ContourPolyline2D node belongs to the **NURBS** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The ContourPolyline2D node belongs to the **NURBS** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -29,18 +29,22 @@ The ContourPolyline2D node belongs to the **NURBS** component and its default co
 
 ### 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"}
 
 ### MFVec2d [in, out] **controlPoint** [ ] <small>(-∞,∞)</small>
 
 *controlPoint* specifies the end points of each segment of the piecewise linear curve.
 
-## Description
+## Advisories
 
 ### Warning
 
 - ContourPolyline2D is not a renderable geometry node.
 
-## External Links
+## See Also
 
-- [X3D Specification of ContourPolyline2D](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#ContourPolyline2D){:target="_blank"}
+- [X3D Specification of ContourPolyline2D node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#ContourPolyline2D){:target="_blank"}

package/docs/_posts/components/NURBS/CoordinateDouble.md

@@ -1,6 +1,6 @@
 ---
 title: CoordinateDouble
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [CoordinateDouble, NURBS]
@@ -13,9 +13,9 @@ tags: [CoordinateDouble, NURBS]
 
 ## Overview
 
-CoordinateDouble builds geometry by defining a set of 3D coordinate triplet values. CoordinateDouble is used by IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle\* and IndexedTriangle\* nodes. CoordinateDouble is also used by NurbsPositionInterpolator and NurbsOrientationInterpolator.
+CoordinateDouble builds geometry by defining a set of 3D coordinate (triplet) point values. CoordinateDouble is used by IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle* and IndexedTriangle* nodes. CoordinateDouble is also used by NurbsPositionInterpolator and NurbsOrientationInterpolator.
 
-The CoordinateDouble node belongs to the **NURBS** component and its default container field is *coord.* It is available since X3D version 3.0 or later.
+The CoordinateDouble node belongs to the **NURBS** component and its default container field is *coord.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,18 +30,22 @@ The CoordinateDouble node belongs to the **NURBS** 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"}
 
 ### MFVec3d [in, out] **point** [ ] <small>(-∞,∞)</small>
 
-*point* contains a set of 3D coordinate triplet values.
+*point* contains a set of 3D coordinate (triplet) *point* values.
 
-## Description
+## Advisories
 
 ### Warning
 
-- CoordinateDouble requires NURBS component level 1, otherwise Full profile.
+- CoordinateDouble requires Rendering component level 1, otherwise Full profile.
 
-## External Links
+## See Also
 
-- [X3D Specification of CoordinateDouble](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#CoordinateDouble){:target="_blank"}
+- [X3D Specification of CoordinateDouble node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#CoordinateDouble){:target="_blank"}

package/docs/_posts/components/NURBS/NurbsCurve.md

@@ -1,6 +1,6 @@
 ---
 title: NurbsCurve
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [NurbsCurve, NURBS]
@@ -15,7 +15,7 @@ tags: [NurbsCurve, NURBS]
 
 NurbsCurve is a 3D curve analogous to NurbsPatchSurface.
 
-The NurbsCurve node belongs to the **NURBS** component and its default container field is *geometry.* It is available since X3D version 3.0 or later.
+The NurbsCurve node belongs to the **NURBS** component and its default container field is *geometry.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,19 +30,23 @@ The NurbsCurve node belongs to the **NURBS** component and its default container
 
 ### 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"}
 
 ### SFInt32 [in, out] **tessellation** 0 <small>(-∞,∞)</small>
 
-Hint for surface tesselation.
+Hint for surface *tessellation*.
 
 ### SFBool [ ] **closed** FALSE
 
-Whether or not the curve is closed (i.e. matching end values).
+Whether or not the curve is *closed* (i.e. matching end values).
 
 ### SFInt32 [ ] **order** 3 <small>[2,∞)</small>
 
-Define order of surface by polynomials of degree = order-1.
+Define *order* of surface by polynomials of degree = *order*-1.
 
 ### MFDouble [ ] **knot** [ ] <small>(-∞,∞)</small>
 
@@ -50,13 +54,13 @@ Define order of surface by polynomials of degree = order-1.
 
 ### MFDouble [in, out] **weight** [ ] <small>(0,∞)</small>
 
-Vector assigning relative weight value to each control point.
+Vector assigning relative *weight* value to each control point.
 
 ### SFNode [in, out] **controlPoint** NULL <small>[X3DCoordinateNode]</small>
 
-Input/Output field controlPoint.
+Single contained Coordinate or CoordinateDouble node that can specify control points for NURBS geometry definitions.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -66,6 +70,6 @@ Input/Output field controlPoint.
 
 <x3d-canvas src="https://create3000.github.io/media/examples/NURBS/NurbsCurve/NurbsCurve.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of NurbsCurve](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsCurve){:target="_blank"}
+- [X3D Specification of NurbsCurve node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsCurve){:target="_blank"}

package/docs/_posts/components/NURBS/NurbsCurve2D.md

@@ -1,6 +1,6 @@
 ---
 title: NurbsCurve2D
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [NurbsCurve2D, NURBS]
@@ -15,7 +15,7 @@ tags: [NurbsCurve2D, NURBS]
 
 NurbsCurve2D defines a trimming segment that is part of a trimming contour in the u-v domain of a surface. NurbsCurve2D and ContourPolyline2D nodes that together form a closed contour, defined in the u-v parametric space of a NURBS surface, may be used as children in a Contour2D node.
 
-The NurbsCurve2D node belongs to the **NURBS** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The NurbsCurve2D node belongs to the **NURBS** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -29,19 +29,23 @@ The NurbsCurve2D node belongs to the **NURBS** component and its default contain
 
 ### 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"}
 
 ### SFInt32 [in, out] **tessellation** 0 <small>(-∞,∞)</small>
 
-Hint for surface tesselation.
+Hint for surface *tessellation*.
 
 ### SFBool [ ] **closed** FALSE
 
-Whether or not the curve is closed (i.e. matching end values).
+Whether or not the curve is *closed* (i.e. matching end values).
 
 ### SFInt32 [ ] **order** 3 <small>[2,∞)</small>
 
-Define order of surface by polynomials of degree = order-1.
+Define *order* of surface by polynomials of degree = *order*-1.
 
 ### MFDouble [ ] **knot** [ ] <small>(-∞,∞)</small>
 
@@ -49,18 +53,18 @@ Define order of surface by polynomials of degree = order-1.
 
 ### MFDouble [in, out] **weight** [ ] <small>(0,∞)</small>
 
-Vector assigning relative weight value to each control point.
+Vector assigning relative *weight* value to each control point.
 
 ### MFVec2d [in, out] **controlPoint** [ ] <small>(-∞,∞)</small>
 
 *controlPoint* defines a set of control points of dimension uDimension by vDimension, and defines a mesh where the points do not have uniform spacing.
 
-## Description
+## Advisories
 
 ### Warning
 
 - NurbsCurve2D is not a renderable geometry node.
 
-## External Links
+## See Also
 
-- [X3D Specification of NurbsCurve2D](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsCurve2D){:target="_blank"}
+- [X3D Specification of NurbsCurve2D node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsCurve2D){:target="_blank"}

package/docs/_posts/components/NURBS/NurbsOrientationInterpolator.md

@@ -1,6 +1,6 @@
 ---
 title: NurbsOrientationInterpolator
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [NurbsOrientationInterpolator, NURBS]
@@ -15,7 +15,7 @@ tags: [NurbsOrientationInterpolator, NURBS]
 
 NurbsOrientationInterpolator describes a 3D NURBS curve and outputs interpolated orientation values.
 
-The NurbsOrientationInterpolator node belongs to the **NURBS** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The NurbsOrientationInterpolator node belongs to the **NURBS** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -29,15 +29,27 @@ The NurbsOrientationInterpolator node belongs to the **NURBS** 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"}
 
 ### SFFloat [in] **set_fraction** <small>(-∞,∞)</small>
 
-Setting fraction in range [0,1] selects input key for corresponding keyValue output, computing a 3D position on the curve.
+Setting *fraction* in range [0,1] selects input key for corresponding keyValue output, computing a 3D position on the curve.
+
+#### Hint
+
+- *set_fraction* values are typically in same range interval as values in the key array. Response to an input *set_fraction* value less than minimum is equivalent to minimum key, and response to an input *set_fraction* value greater than maximum is equivalent to maximum key.
+
+#### Warning
+
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
 ### SFInt32 [in, out] **order** 3 <small>(2,∞)</small>
 
-Define order of surface by polynomials of degree = order-1.
+Define *order* of surface by polynomials of degree = *order*-1.
 
 ### MFDouble [in, out] **knot** [ ] <small>(-∞,∞)</small>
 
@@ -45,7 +57,7 @@ Define order of surface by polynomials of degree = order-1.
 
 ### MFDouble [in, out] **weight** [ ] <small>(-∞,∞)</small>
 
-Output values for linear interpolation, each corresponding to knots.
+Output values for computational interpolation, each corresponding to knots.
 
 #### Hint
 
@@ -53,18 +65,22 @@ Output values for linear interpolation, each corresponding to knots.
 
 ### SFNode [in, out] **controlPoint** NULL <small>[X3DCoordinateNode]</small>
 
-Input/Output field controlPoint.
+Single contained Coordinate or CoordinateDouble node that can specify control points for NURBS geometry definitions.
 
 ### SFRotation [out] **value_changed**
 
-Linearly interpolated output value determined by current key time and corresponding keyValue pair.
+Computationaly interpolated output value determined by current key time and corresponding keyValue pair.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
-## Description
+## Advisories
 
 ### Hint
 
-- The SFNode controlPoints field can contain a single Coordinate or CoordinateDouble node.
+- The SFNode controlPoint field can contain a single Coordinate or CoordinateDouble node.
 
-## External Links
+## See Also
 
-- [X3D Specification of NurbsOrientationInterpolator](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsOrientationInterpolator){:target="_blank"}
+- [X3D Specification of NurbsOrientationInterpolator node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsOrientationInterpolator){:target="_blank"}

package/docs/_posts/components/NURBS/NurbsPatchSurface.md

@@ -1,6 +1,6 @@
 ---
 title: NurbsPatchSurface
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [NurbsPatchSurface, NURBS]
@@ -15,7 +15,7 @@ tags: [NurbsPatchSurface, NURBS]
 
 NurbsPatchSurface defines a contiguous 3D Non-Uniform Rational B-Spline (NURBS) surface.
 
-The NurbsPatchSurface node belongs to the **NURBS** component and its default container field is *geometry.* It is available since X3D version 3.0 or later.
+The NurbsPatchSurface node belongs to the **NURBS** component and its default container field is *geometry.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -31,23 +31,29 @@ The NurbsPatchSurface node belongs to the **NURBS** component and its default co
 
 ### 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"}
 
 ### SFInt32 [in, out] **uTessellation** 0 <small>(-∞,∞)</small>
 
-Hint for surface tesselation.
+Hint for surface tessellation.
 
 ### SFInt32 [in, out] **vTessellation** 0 <small>(-∞,∞)</small>
 
-Hint for surface tesselation.
+Hint for surface tessellation.
 
 ### SFBool [ ] **solid** TRUE
 
-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.
 
 #### Warning
 
@@ -87,20 +93,20 @@ Knot vector, where size = number of control points + order of curve.
 
 ### MFDouble [in, out] **weight** [ ] <small>(0,∞)</small>
 
-Vector assigning relative weight value to each control point.
+Vector assigning relative *weight* value to each control point.
 
 ### SFNode [in, out] **texCoord** NULL <small>[X3DTextureCoordinateNode|NurbsTextureCoordinate]</small>
 
-Input/Output field texCoord.
+Single contained NurbsTextureCoordinate, TextureCoordinate, TextureCoordinateGenerator or MultiTextureCoordinate node that can specify coordinates for texture mapping onto corresponding geometry.
 
 ### SFNode [in, out] **controlPoint** NULL <small>[X3DCoordinateNode]</small>
 
-Input/Output field controlPoint.
+Single contained Coordinate or CoordinateDouble node that can specify control points for NURBS geometry definitions.
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/NURBS/NurbsPatchSurface/NurbsPatchSurface.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of NurbsPatchSurface](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsPatchSurface){:target="_blank"}
+- [X3D Specification of NurbsPatchSurface node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsPatchSurface){:target="_blank"}

package/docs/_posts/components/NURBS/NurbsPositionInterpolator.md

@@ -1,6 +1,6 @@
 ---
 title: NurbsPositionInterpolator
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [NurbsPositionInterpolator, NURBS]
@@ -15,7 +15,7 @@ tags: [NurbsPositionInterpolator, NURBS]
 
 NurbsPositionInterpolator describes a 3D NURBS curve and outputs interpolated position values.
 
-The NurbsPositionInterpolator node belongs to the **NURBS** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The NurbsPositionInterpolator node belongs to the **NURBS** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -29,15 +29,27 @@ The NurbsPositionInterpolator node belongs to the **NURBS** component and its de
 
 ### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
 
-Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.
+Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFFloat [in] **set_fraction** <small>(-∞,∞)</small>
 
-Setting fraction in range [0,1] selects input key for corresponding keyValue output, computing a 3D position on the curve.
+Setting *fraction* in range [0,1] selects input key for corresponding keyValue output, computing a 3D position on the curve.
+
+#### Hint
+
+- *set_fraction* values are typically in same range interval as values in the key array. Response to an input *set_fraction* value less than minimum is equivalent to minimum key, and response to an input *set_fraction* value greater than maximum is equivalent to maximum key.
+
+#### Warning
+
+- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
 
 ### SFInt32 [in, out] **order** 3 <small>(2,∞)</small>
 
-Define order of surface by polynomials of degree = order-1.
+Define *order* of surface by polynomials of degree = *order*-1.
 
 ### MFDouble [in, out] **knot** [ ] <small>(-∞,∞)</small>
 
@@ -53,18 +65,22 @@ Output values for linear interpolation, each corresponding to knots.
 
 ### SFNode [in, out] **controlPoint** NULL <small>[X3DCoordinateNode]</small>
 
-Input/Output field controlPoint.
+Single contained Coordinate or CoordinateDouble node that can specify control points for NURBS geometry definitions.
 
 ### SFVec3f [out] **value_changed**
 
-Linearly interpolated output value determined by current key time and corresponding keyValue pair.
+Computationaly interpolated output value determined by current key time and corresponding keyValue pair.
+
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
 
-## Description
+## Advisories
 
 ### Hint
 
-- The SFNode controlPoints field can contain a single Coordinate or CoordinateDouble node.
+- The SFNode controlPoint field can contain a single Coordinate or CoordinateDouble node.
 
-## External Links
+## See Also
 
-- [X3D Specification of NurbsPositionInterpolator](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsPositionInterpolator){:target="_blank"}
+- [X3D Specification of NurbsPositionInterpolator node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsPositionInterpolator){:target="_blank"}

package/docs/_posts/components/NURBS/NurbsSet.md

@@ -1,6 +1,6 @@
 ---
 title: NurbsSet
-date: 2022-01-07
+date: 2023-01-07
 nav: components-NURBS
 categories: [components, NURBS]
 tags: [NurbsSet, NURBS]
@@ -15,7 +15,7 @@ tags: [NurbsSet, NURBS]
 
 NurbsSet collects a set of NurbsSurface nodes into a common group and treats NurbsSurface set as a unit during tessellation, thereby enforcing tessellation continuity along borders.
 
-The NurbsSet node belongs to the **NURBS** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+The NurbsSet node belongs to the **NURBS** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -31,20 +31,24 @@ The NurbsSet node belongs to the **NURBS** 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.
+
+#### Hint
+
+- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
 
 ### SFFloat [in, out] **tessellationScale** 1 <small>(0,∞)</small>
 
-Scale for surface tesselation in children NurbsSurface nodes.
+Scale for surface tessellation in children NurbsSurface nodes.
 
 ### 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
 
@@ -58,26 +62,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] **addGeometry**
 
-Input field addGeometry.
+Input field *addGeometry*.
 
 ### MFNode [in] **removeGeometry**
 
-Input field removeGeometry.
+Input field *removeGeometry*.
 
 ### MFNode [in, out] **geometry** [ ] <small>[X3DNurbsSurfaceGeometryNode]</small>
 
-Input/Output field geometry.
+The children form a closed loop with first point of first child repeated as last point of last child, and the last point of a segment repeated as first point of the consecutive one.
+
+#### Hints
+
+- Children nodes are listed in consecutive order according to topology of the contour.
+- Utilizing USE nodes for *geometry* can ensure that rendered *geometry* occurs elsewhere in the model.
+
+#### Warnings
+
+- *geometry* represented in children of this node shall not be directly rendered. It is an informational node only.
+- Surfaces not represented elsewhere in transformation hierarchy shall not be rendered.
+
+## Advisories
+
+### Hint
+
+- USE nodes for geometry ensure renderable versions occur elsewhere in the model. The bounds information is provided for optimization purposes only. A browser may choose to use this information about when to apply trimming or smooth tessellation between patches based on the bounds information.
+
+### Warnings
+
+- Geometry represented in children of this node shall not be directly rendered. It is an informational node only.
+- Surfaces not represented elsewhere in transformation hierarchy shall not be rendered.
 
-## External Links
+## See Also
 
-- [X3D Specification of NurbsSet](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsSet){:target="_blank"}
+- [X3D Specification of NurbsSet node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsSet){:target="_blank"}