x_ite 8.4.3 → 8.5.3

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

@@ -0,0 +1,69 @@
+---
+title: NurbsSweptSurface
+date: 2022-01-07
+nav: components-NURBS
+categories: [components, NURBS]
+tags: [NurbsSweptSurface, NURBS]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+NurbsSweptSurface contains a crossSectionCurve [X3DNurbsControlCurveNode] and a trajectoryCurve [NurbsCurve].
+
+The NurbsSweptSurface node belongs to the **NURBS** component and its default container field is *geometry.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DGeometryNode
+    + X3DParametricGeometryNode
+      + NurbsSweptSurface
+```
+
+## Fields
+
+### 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.
+
+### 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).
+
+#### Hint
+
+- If in doubt, use solid='false' for maximum visibility.
+
+#### Warning
+
+- Default value true can completely hide geometry if viewed from wrong side!
+
+### SFBool [ ] **ccw** TRUE
+
+*ccw* = counterclockwise: ordering of vertex coordinates orientation.
+
+#### Hint
+
+- Ccw false can reverse solid (backface culling) and normal-vector orientation.
+
+### SFNode [in, out] **crossSectionCurve** NULL <small>[X3DNurbsControlCurveNode]</small>
+
+Input/Output field crossSectionCurve.
+
+### SFNode [in, out] **trajectoryCurve** NULL <small>[NurbsCurve]</small>
+
+Input/Output field trajectoryCurve.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/NURBS/NurbsSweptSurface/NurbsSweptSurface.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of NurbsSweptSurface](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsSweptSurface){:target="_blank"}

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

@@ -0,0 +1,65 @@
+---
+title: NurbsSwungSurface
+date: 2022-01-07
+nav: components-NURBS
+categories: [components, NURBS]
+tags: [NurbsSwungSurface, NURBS]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+NurbsSwungSurface contains a profileCurve [X3DNurbsControlCurveNode] and a trajectoryCurve [X3DNurbsControlCurveNode].
+
+The NurbsSwungSurface node belongs to the **NURBS** component and its default container field is *geometry.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DGeometryNode
+    + X3DParametricGeometryNode
+      + NurbsSwungSurface
+```
+
+## Fields
+
+### 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.
+
+### 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).
+
+#### Hint
+
+- If in doubt, use solid='false' for maximum visibility.
+
+#### Warning
+
+- Default value true can completely hide geometry if viewed from wrong side!
+
+### SFBool [ ] **ccw** TRUE
+
+*ccw* = counterclockwise: ordering of vertex coordinates orientation.
+
+#### Hint
+
+- Ccw false can reverse solid (backface culling) and normal-vector orientation.
+
+### SFNode [in, out] **profileCurve** NULL <small>[X3DNurbsControlCurveNode]</small>
+
+Input/Output field profileCurve.
+
+### SFNode [in, out] **trajectoryCurve** NULL <small>[X3DNurbsControlCurveNode]</small>
+
+Input/Output field trajectoryCurve.
+
+## External Links
+
+- [X3D Specification of NurbsSwungSurface](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsSwungSurface){:target="_blank"}

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

@@ -0,0 +1,77 @@
+---
+title: NurbsTextureCoordinate
+date: 2022-01-07
+nav: components-NURBS
+categories: [components, NURBS]
+tags: [NurbsTextureCoordinate, NURBS]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+NurbsTextureCoordinate describes a 3D NURBS surface in the parametric domain of its surface host, specifying mapping of texture onto the surface.
+
+The NurbsTextureCoordinate node belongs to the **NURBS** component and its default container field is *texCoord.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + NurbsTextureCoordinate
+```
+
+## Fields
+
+### 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.
+
+### MFVec2f [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.
+
+### MFFloat [in, out] **weight** [ ] <small>(0,∞)</small>
+
+Output values for linear interpolation, each corresponding to knots.
+
+#### Hint
+
+- Number of weights must match number of knots!
+
+### SFInt32 [ ] **uDimension** <small>[0,∞)</small>
+
+Number of control points in u dimension.
+
+### MFDouble [ ] **uKnot** [ ] <small>(-∞,∞)</small>
+
+Knot vector, where size = number of control points + order of curve.
+
+### SFInt32 [ ] **uOrder** 3 <small>[2,∞)</small>
+
+Define order of surface by polynomials of degree = order-1.
+
+### SFInt32 [ ] **vDimension** <small>[0,∞)</small>
+
+Number of control points in v dimension.
+
+### MFDouble [ ] **vKnot** [ ] <small>(-∞,∞)</small>
+
+Knot vector, where size = number of control points + order of curve.
+
+### SFInt32 [ ] **vOrder** 3 <small>[2,∞)</small>
+
+Define order of surface by polynomials of degree = order-1.
+
+## Description
+
+### Hint
+
+- The SFNode controlPoints field can contain a single Coordinate or CoordinateDouble node.
+
+## External Links
+
+- [X3D Specification of NurbsTextureCoordinate](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsTextureCoordinate){:target="_blank"}

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

@@ -0,0 +1,114 @@
+---
+title: NurbsTrimmedSurface
+date: 2022-01-07
+nav: components-NURBS
+categories: [components, NURBS]
+tags: [NurbsTrimmedSurface, NURBS]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+NurbsTrimmedSurface generates texture coordinates from a Non-Uniform Rational B-Spline (NURBS) surface.
+
+The NurbsTrimmedSurface node belongs to the **NURBS** component and its default container field is *geometry.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DGeometryNode
+    + X3DParametricGeometryNode
+      + X3DNurbsSurfaceGeometryNode
+        + NurbsTrimmedSurface
+```
+
+## Fields
+
+### 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.
+
+### SFInt32 [in, out] **uTessellation** <small>(-∞,∞)</small>
+
+Hint for surface tesselation.
+
+### SFInt32 [in, out] **vTessellation** <small>(-∞,∞)</small>
+
+Hint for surface tesselation.
+
+### SFBool [ ] **uClosed** FALSE
+
+Whether opposite surface sides are closed (seamless) across u dimension.
+
+### SFBool [ ] **vClosed** FALSE
+
+Whether opposite surface sides are closed (seamless) across u dimension.
+
+### 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).
+
+#### Hint
+
+- If in doubt, use solid='false' for maximum visibility.
+
+#### Warning
+
+- Default value true can completely hide geometry if viewed from wrong side!
+
+### SFInt32 [ ] **uOrder** 3 <small>[2,∞)</small>
+
+Define order of surface by polynomials of degree = order-1.
+
+### SFInt32 [ ] **vOrder** 3 <small>[2,∞)</small>
+
+Define order of surface by polynomials of degree = order-1.
+
+### SFInt32 [ ] **uDimension** <small>[0,∞)</small>
+
+Number of control points in u dimension.
+
+### SFInt32 [ ] **vDimension** <small>[0,∞)</small>
+
+Number of control points in v dimension.
+
+### MFDouble [ ] **uKnot** [ ] <small>(-∞,∞)</small>
+
+Knot vector, where size = number of control points + order of curve.
+
+### MFDouble [ ] **vKnot** [ ] <small>(-∞,∞)</small>
+
+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.
+
+### SFNode [in, out] **texCoord** NULL <small>[X3DTextureCoordinateNode|NurbsTextureCoordinate]</small>
+
+Input/Output field texCoord.
+
+### SFNode [in, out] **controlPoint** NULL <small>[X3DCoordinateNode]</small>
+
+Input/Output field controlPoint.
+
+### MFNode [in] **addTrimmingContour**
+
+Input field addTrimmingContour.
+
+### MFNode [in] **removeTrimmingContour**
+
+Input field removeTrimmingContour.
+
+### MFNode [in, out] **trimmingContour** [ ] <small>[Contour2D]</small>
+
+Input/Output field trimmingContour.
+
+## External Links
+
+- [X3D Specification of NurbsTrimmedSurface](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/nurbs.html#NurbsTrimmedSurface){:target="_blank"}

package/docs/_posts/components/Navigation/Billboard.md

@@ -0,0 +1,88 @@
+---
+title: Billboard
+date: 2022-01-07
+nav: components-Navigation
+categories: [components, Navigation]
+tags: [Billboard, Navigation]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+Billboard is a Grouping node that can contain most nodes. Content faces the user, rotating about the specified axis. Set axisOfRotation=0 0 0 to fully face the user's camera.
+
+The Billboard node belongs to the **Navigation** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DGroupingNode
+      + Billboard
+```
+
+## Fields
+
+### 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.
+
+### SFVec3f [in, out] **axisOfRotation** 0 1 0 <small>(-∞,∞)</small>
+
+*axisOfRotation* direction is relative to local coordinate system.
+
+#### Hint
+
+- Axis 0 0 0 always faces viewer.
+
+### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
+
+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
+
+- Can be useful for collision computations or inverse-kinematics (IK) engines.
+
+### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
+
+Bounding box center: optional hint for position offset from origin of local coordinate system.
+
+### MFNode [in] **addChildren**
+
+Input field addChildren.
+
+### MFNode [in] **removeChildren**
+
+Input field removeChildren.
+
+### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
+
+Grouping nodes contain a list of children nodes.
+
+#### Hint
+
+- Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+
+## Description
+
+### Hints
+
+- Put Billboard as close to the geometry as possible, nested inside Transform for local coordinate system.
+- Insert a Shape node before adding geometry or Appearance.
+
+### Warning
+
+- Don't put Viewpoint inside a Billboard.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/Navigation/Billboard/Billboard.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of Billboard](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#Billboard){:target="_blank"}

package/docs/_posts/components/Navigation/Collision.md

@@ -0,0 +1,102 @@
+---
+title: Collision
+date: 2022-01-07
+nav: components-Navigation
+categories: [components, Navigation]
+tags: [Collision, Navigation]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+Collision detects camera-to-object contact using current view and NavigationInfo avatarSize. Collision is a Grouping node that handles collision detection for its children. Collision can contain a single proxy child node for substitute collision-detection geometry.
+
+The Collision node belongs to the **Navigation** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DGroupingNode
+      + Collision (X3DSensorNode)*
+```
+
+<small>\* Derived from multiple interfaces.</small>
+
+## Fields
+
+### 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.
+
+### SFBool [in, out] **enabled** TRUE
+
+Enables/disables collision detection for children and all descendants.
+
+#### Hint
+
+- Former name "collide" in VRML97 specification.
+
+### SFBool [out] **isActive**
+
+*isActive* true/false events are sent when triggering the sensor. isActive=true when view-object collision occurs, isActive=false when view-object collision no longer occurs.
+
+### SFTime [out] **collideTime**
+
+Time of collision between camera (avatar) and geometry.
+
+### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
+
+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
+
+- Can be useful for collision computations or inverse-kinematics (IK) engines.
+
+### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
+
+Bounding box center: optional hint for position offset from origin of local coordinate system.
+
+### SFNode [ ] **proxy** NULL <small>[X3DChildNode]</small>
+
+Field proxy.
+
+### MFNode [in] **addChildren**
+
+Input field addChildren.
+
+### MFNode [in] **removeChildren**
+
+Input field removeChildren.
+
+### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
+
+Grouping nodes contain a list of children nodes.
+
+#### Hint
+
+- Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+
+## Description
+
+### Hints
+
+- Proxy shapes are not rendered and remain invisible.
+- Apply containerField='proxy' to uniquely identify the proxy child Shape or grouping node.
+- PointSet, IndexedLineSet, LineSet and Text are not collidable geometry do not trigger collisions.
+- Improve performance using proxy for simpler contact-calculation geometry.
+- NavigationInfo types '"WALK" "FLY"' support camera-to-object collision detection.
+- Insert a Shape node before adding geometry or Appearance.
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/Navigation/Collision/Collision.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of Collision](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#Collision){:target="_blank"}

package/docs/_posts/components/Navigation/LOD.md

@@ -0,0 +1,99 @@
+---
+title: LOD
+date: 2022-01-07
+nav: components-Navigation
+categories: [components, Navigation]
+tags: [LOD, Navigation]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+LOD (Level Of Detail) uses camera-to-object distance to switch among contained child levels. (Contained nodes are now called 'children' rather than 'level', for consistent naming among all GroupingNodeType nodes.) LOD range values go from near to far (as child geometry gets simpler for better performance). For n range values, you must have n+1 children levels! Only currently selected children level is rendered, but all levels continue to send/receive events.
+
+The LOD node belongs to the **Navigation** component and its default container field is *children.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DGroupingNode
+      + LOD
+```
+
+## Fields
+
+### 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.
+
+### SFBool [ ] **forceTransitions** FALSE
+
+Whether to perform every range-based transition, regardless of browser optimizations that might otherwise occur.
+
+### SFVec3f [ ] **center** 0 0 0 <small>(-∞,∞)</small>
+
+Viewpoint distance-measurement offset from origin of local coordinate system, used for LOD node distance calculations.
+
+### MFFloat [ ] **range** [ ] <small>[0,∞) or -1</small>
+
+Specifies ideal distances at which to switch between levels. The range field is a floating-point array of camera-to-object distance transitions for each child level, where range values go from near to far. For n range values, you must have n+1 child levels!
+
+#### Hints
+
+- Can add `<WorldInfo info='null node'/>` as a nonrendering, invisible final (or initial or intermediate) child node that also documents the LOD switch-over rationale. Not setting range values indicates that level switching can be optimized automatically based on performance.
+
+### SFInt32 [out] **level_changed**
+
+Indicates current level of LOD children when activated.
+
+### SFVec3f [ ] **bboxSize** -1 -1 -1 <small>[0,∞) or −1 −1 −1</small>
+
+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
+
+- Can be useful for collision computations or inverse-kinematics (IK) engines.
+
+### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
+
+Bounding box center: optional hint for position offset from origin of local coordinate system.
+
+### MFNode [in] **addChildren**
+
+Input field addChildren.
+
+### MFNode [in] **removeChildren**
+
+Input field removeChildren.
+
+### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
+
+Grouping nodes contain a list of children nodes.
+
+#### Hint
+
+- Each grouping node defines a coordinate space for its children, relative to the coordinate space of its parent node. Thus transformations accumulate down the scene graph hierarchy.
+
+## Description
+
+### Hints
+
+- Can add `<WorldInfo info='null node'/>` as a nonrendering, invisible final (or initial or intermediate) child node that also documents the LOD switch-over rationale.
+- Insert a Shape node before adding geometry or Appearance.
+- Security mechanisms such as encryption and authentication can be applied to high levels of detail, allowing authors to protect intellectual property at high resolution for authorized users while still rendering simple unrestricted models for other users.
+
+### Warnings
+
+- Do not include Viewpoint or OrthoViewpoint as a child of LOD or Switch, instead use ViewpointGroup as parent to constrain location proximity where the viewpoint is available to user.
+- Results are undefined if a bindable node (Viewpoint, OrthoViewpoint, NavigationInfo, Fog, Background, TextureBackground) is a contained child of LOD or Switch.
+- Nested LOD nodes with overlapping range intervals can lead to unexpected or undefined behavior.
+
+## External Links
+
+- [X3D Specification of LOD](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#LOD){:target="_blank"}