x_ite 8.11.7 → 8.11.8

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

@@ -1,156 +0,0 @@
----
-title: Collision
-date: 2023-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 reports collision detection for its children.
-
-The Collision node belongs to the **Navigation** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DChildNode
-    + X3DGroupingNode
-      + Collision (X3DSensorNode)*
-```
-
-<small>\* Derived from multiple interfaces.</small>
-
-## 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"}
-
-### 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.
-
-#### 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] **collideTime**
-
-Time of collision between camera (avatar) and geometry.
-
-#### 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 [in, out] **visible** TRUE
-
-Whether or not renderable content within this node is visually displayed.
-
-#### 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.
-
-### SFBool [in, out] **bboxDisplay** FALSE
-
-Whether to display bounding box for associated geometry, aligned with world coordinates.
-
-#### Hint
-
-- The bounding box is displayed regardless of whether contained content is visible.
-
-### 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.
-
-#### 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 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 [ ] **proxy** NULL <small>[X3DChildNode]</small>
-
-The *proxy* node is used as a substitute for Collision children during collision detection, simplifying collision-intersection computations.
-
-#### Hint
-
-- The *proxy* node is used strictly for collision detection and is not drawn.
-
-#### Warnings
-
-- The *proxy* node must have `containerField='proxy'` or it is simply treated like other children nodes.
-- Insert a Shape node before adding geometry or Appearance.
-
-### MFNode [in] **addChildren**
-
-Input field *addChildren*.
-
-### MFNode [in] **removeChildren**
-
-Input field *removeChildren*.
-
-### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
-
-Grouping nodes contain an ordered list of *children* nodes.
-
-#### Hints
-
-- 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.
-- InputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
-- InputOnly MFNode removeChildren field can remove nodes from the *children* list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
-- [X3D Architecture 10.2.1 Grouping and *children* node types](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#GroupingAndChildrenNodes){:target="_blank"}
-
-## Advisories
-
-### Hints
-
-- Collision can contain a single proxy child node for substitute collision-detection geometry. Improve run-time performance by using proxy with simpler contact-calculation geometry.
-- Proxy shapes are not rendered and remain invisible.
-- Apply `containerField='proxy'` to uniquely identify the proxy child Shape or grouping node.
-- NavigationInfo types '"WALK" "FLY"' support camera-to-object collision detection.
-- Content must be visible to be collidable and to be pickable.
-- Insert a Shape node before adding geometry or Appearance.
-
-### Warning
-
-- PointSet, IndexedLineSet, LineSet and Text are not collidable geometry do not trigger collisions.
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Navigation/Collision/Collision.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of Collision node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#Collision){:target="_blank"}

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

@@ -1,146 +0,0 @@
----
-title: LOD
-date: 2023-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 from X3D version 2.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DChildNode
-    + X3DGroupingNode
-      + LOD
-```
-
-## 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"}
-
-### 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**
-
-Output event that reports current level of LOD children whenever switching occurs.
-
-#### Hint
-
-- LOD level index counting starts at zero. Thus *level_changed* value of -1 means no choice, 0 means initial child, 1 means second child, etc.
-
-#### 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 [in, out] **visible** TRUE
-
-Whether or not renderable content within this node is visually displayed.
-
-#### 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.
-
-### SFBool [in, out] **bboxDisplay** FALSE
-
-Whether to display bounding box for associated geometry, aligned with world coordinates.
-
-#### Hint
-
-- The bounding box is displayed regardless of whether contained content is visible.
-
-### 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.
-
-#### 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 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] **addChildren**
-
-Input field *addChildren*.
-
-### MFNode [in] **removeChildren**
-
-Input field *removeChildren*.
-
-### MFNode [in, out] **children** [ ] <small>[X3DChildNode]</small>
-
-Grouping nodes contain an ordered list of *children* nodes.
-
-#### Hints
-
-- 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.
-- InputOnly MFNode addChildren field can append new X3DChildNode nodes via a ROUTE connection, duplicate input nodes (i.e. matching DEF, USE values) are ignored.
-- InputOnly MFNode removeChildren field can remove nodes from the *children* list, unrecognized input nodes (i.e. nonmatching DEF, USE values) are ignored.
-- [X3D Architecture 10.2.1 Grouping and *children* node types](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#GroupingAndChildrenNodes){:target="_blank"}
-
-## Advisories
-
-### 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.
-- GeoViewpoint OrthoViewpoint and Viewpoint share the same binding stack, so no more than one of these nodes can be bound and active at a given time.
-- 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.
-- Contained nodes must have type X3DChildNode, such as Group or Transform or Shape.
-- Apply `containerField='shape'` if parent node is CADFace.
-- [ConformanceNist X3D Examples Archive](https://www.web3d.org/x3d/content/examples/ConformanceNist/SpecialGroups/LOD){:target="_blank"}
-
-### Warnings
-
-- Do not include GeoViewpoint OrthoViewpoint or Viewpoint 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 (Background, Fog, NavigationInfo, OrthoViewpoint, TextureBackground, Viewpoint) is a contained descendant node of either LOD or Switch. Avoid this authoring pattern.
-- Nested LOD (and/or GeoLOD) nodes with overlapping range intervals can lead to unexpected or undefined behavior.
-- LOD is not allowed as a direct parent of Appearance, Material, Color, Coordinate, Normal or Texture nodes, instead ensure that a Shape is present.
-
-## See Also
-
-- [X3D Specification of LOD node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#LOD){:target="_blank"}

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

@@ -1,170 +0,0 @@
----
-title: NavigationInfo
-date: 2023-01-07
-nav: components-Navigation
-categories: [components, Navigation]
-tags: [NavigationInfo, Navigation]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-NavigationInfo describes the user's viewing model, user navigation-interaction modalities, and also dimensional characteristics of the user's (typically invisible) avatar.
-
-The NavigationInfo node belongs to the **Navigation** component and its default container field is *children.* It is available from X3D version 2.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DChildNode
-    + X3DBindableNode
-      + NavigationInfo
-```
-
-## 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"}
-
-### SFBool [in] **set_bind**
-
-Receiving event *set_bind*=true activates and binds this node at the top of the binding stack. Receiving event *set_bind*=false deactivates and unbinds this node from the top of the binding stack. Thus setting *set_bind* to true/false will enable/disable the effect of this node.
-
-#### Hint
-
-- Paired node operations can be established by connecting *set_bind* and isBound fields of corresponding bindable nodes.
-
-#### Warning
-
-- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
-
-### MFString [in, out] **type** [ "EXAMINE", "ANY" ] <small>["EXAMINE", "WALK", "FLY", "PLANE_create3000.github.io", "LOOKAT", "EXPLORE", "ANY", "NONE"]</small>
-
-Enter one or more quoted SFString values: "EXAMINE" "WALK" "FLY" "LOOKAT" "EXPLORE" "ANY" "NONE".
-
-#### Hints
-
-- For inspection of simple objects, usability often improves with *type*="EXAMINE" "ANY".
-- Types WALK and FLY force strict camera-to-object collision detection.
-- See Collision node for further details on camera-to-object collision detection.
-- MFString arrays can have multiple values, so separate each individual string by quote marks "https://www.web3d.org" "https://www.web3d.org/about" "etc." ] Interchange profile hint: this field may be ignored, applying the default value regardless.
-
-### MFFloat [in, out] **avatarSize** [ 0.25, 1.6, 0.75 ] <small>[0,∞)</small>
-
-*avatarSize* triplet values define three separate parameters: (a) collisionDistance between user and geometry, i.e. near clipping plane of view frustrum, default 0.25m, (b) viewer height above terrain, default 1.6m, and (c) tallest height viewer can WALK over, default 0.75m.
-
-#### Hints
-
-- X3D specification recommends that browsers set near clipping plane to one-half of *avatarSize*.CollisionDistance value.
-- [Aliasing](https://en.wikipedia.org/wiki/Aliasing){:target="_blank"} and [Clipping](https://en.wikipedia.org/wiki/Clipping_(computer_graphics)){:target="_blank"} Interchange profile hint: this field may be ignored, applying the default value regardless.
-- Transformation hierarchy of currently bound Viewpoint node scales *avatarSize*, but translations and rotations have no effect.
-- Content must be visible to be collidable and to be pickable.
-
-#### Warnings
-
-- Important design thumbrule is to keep (visibilityLimit / *avatarSize*.CollisionDistance) \< 10,000 to avoid aliasing artifacts (i.e. polygon "tearing").
-- Data type is MFFloat rather than SFVec3f, be sure that three values are provided in the array since validation tools are typically unable to detect erroneous data prior to run time.
-
-### SFFloat [in, out] **speed** 1 <small>[0,∞)</small>
-
-Default rate at which viewer travels through scene, meters/second.
-
-#### Warning
-
-- Default 1 m/s usually seems slow for ordinary navigation. Interchange profile hint: this field may be ignored, applying the default value regardless.
-
-### SFBool [in, out] **headlight** TRUE
-
-Enable/disable directional light that always points in the direction the user is looking.
-
-### SFFloat [in, out] **visibilityLimit** 0 <small>[0,∞)</small>
-
-Geometry beyond the *visibilityLimit* may not be rendered (far clipping plane of the view frustrum).
-
-#### Hints
-
-- *visibilityLimit*=0.0 indicates an infinite visibility limit (no far clipping plane).
-- Set *visibilityLimit* to appropriate positive value in meters to define far culling plane of view frustum.
-- X3D specification recommends that browsers set near clipping plane to one-half of avatarSize.CollisionDistance value.
-- [Aliasing](https://en.wikipedia.org/wiki/Aliasing){:target="_blank"} and [Clipping](https://en.wikipedia.org/wiki/Clipping_(computer_graphics)){:target="_blank"} Interchange profile hint: this field may be ignored, applying the default value regardless.
-
-#### Warning
-
-- Important design thumbrule is to keep (*visibilityLimit* / avatarSize.CollisionDistance) \< 10,000 to avoid aliasing artifacts (i.e. polygon "tearing").
-
-### MFString [in, out] **transitionType** "LINEAR" <small>["TELEPORT"|"LINEAR"|"ANIMATE"]</small>
-
-Camera transition between viewpoints. Enter one or more quoted SFString values: "ANIMATE" "TELEPORT" "LINEAR".
-
-#### Hint
-
-- "ANIMATE" behavior is browser-specific, "TELEPORT" is immediate, and "LINEAR" may proceed directly through intervening objects.
-
-### SFTime [in, out] **transitionTime** 1 <small>[0,∞)</small>
-
-*transitionTime* defines the expected duration of viewpoint transition in seconds.
-
-#### Hint
-
-- If transitionType is "ANIMATE", *transitionTime* provides browser-dependent animation parameters. Interchange profile hint: this field may be ignored, applying the default value regardless.
-
-### SFBool [out] **transitionComplete**
-
-Event signaling viewpoint transition complete. Interchange profile hint: this field may be ignored.
-
-#### 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] **isBound**
-
-Output event true gets sent when node becomes bound and activated, otherwise output event false gets sent when node becomes unbound and deactivated.
-
-#### Hint
-
-- Paired node operations can be established by connecting set_bind and *isBound* fields of corresponding bindable nodes.
-
-#### 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] **bindTime**
-
-Event sent reporting timestamp when node becomes active/inactive.
-
-#### Warning
-
-- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
-
-## Advisories
-
-### Hints
-
-- For inspection of simple objects, usability often improves with type="EXAMINE" "ANY"
-- Background, Fog, GeoViewpoint, NavigationInfo, OrthoViewpoint, TextureBackground and Viewpoint are bindable nodes, meaning that no more than one of each node type can be active at a given time.
-- NavigationInfo types '"WALK" "FLY"' support camera-to-object collision detection.
-- Regardless of viewpoint jump value at bind time, the relative viewing transformation between user's view and defined position/orientation is stored for later use when un-jumping (returning to the viewpoint when subsequent viewpoint is unbound).
-- Customizable design pattern for dedicated Viewpoint/NavigationInfo pair: \<Viewpoint DEF='SpecialView'/\> \<NavigationInfo DEF='SpecialNav'/\> \<ROUTE fromNode='SpecialView' fromField='isBound' toNode='SpecialNav' toField='set_bind'/\>
-- [X3D Scene Authoring Hints, Viewpoints](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Viewpoints){:target="_blank"}
-
-### Warning
-
-- Results are undefined if a bindable node (Background, Fog, NavigationInfo, OrthoViewpoint, TextureBackground, Viewpoint) is a contained descendant node of either LOD or Switch. Avoid this authoring pattern.
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Navigation/NavigationInfo/NavigationInfo.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of NavigationInfo node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/navigation.html#NavigationInfo){:target="_blank"}