x_ite 8.11.7 → 8.11.9

package/docs/_posts/components/Geospatial/GeoProximitySensor.md

@@ -1,158 +0,0 @@
----
-title: GeoProximitySensor
-date: 2023-01-07
-nav: components-Geospatial
-categories: [components, Geospatial]
-tags: [GeoProximitySensor, Geospatial]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-GeoProximitySensor generates events when the viewer enters, exits and moves within a region of space (defined by a box).
-
-The GeoProximitySensor node belongs to the **Geospatial** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DChildNode
-    + X3DSensorNode
-      + X3DEnvironmentalSensorNode
-        + GeoProximitySensor
-```
-
-## 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"}
-
-### SFNode [ ] **geoOrigin** NULL <small>[GeoOrigin] (deprecated)</small>
-
-Single contained GeoOrigin node that can specify a local coordinate frame for extended precision.
-
-#### Hint
-
-- [X3D Architecture 25.2.5 Dealing with high-precision coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#high-precisioncoords){:target="_blank"}
-
-#### Warning
-
-- XML validation requires placement as first child node following contained metadata nodes (if any).
-
-### MFString [ ] **geoSystem** [ "GD", "WE" ]
-
-Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
-
-#### Hints
-
-- [X3D Architecture 25.2.2 Spatial reference frames](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
-- [X3D Architecture 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
-- [UTM is Universal Transverse Mercator coordinate system](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system){:target="_blank"}
-
-#### Warning
-
-- Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
-
-### SFBool [in, out] **enabled** TRUE
-
-Enables/disables node operation.
-
-### SFVec3f [in, out] **size** 0 0 0 <small>[0,∞)</small>
-
-*size* of Proximity box.
-
-#### Hint
-
-- *size* 0 0 0 is same as enabled false.
-
-### SFVec3f [in, out] **center** 0 0 0 <small>(-∞,∞) (starting with vs. 3.3)</small>
-
-Position offset from origin of local coordinate system.
-
-### SFBool [out] **isActive**
-
-*isActive* true/false events are sent as viewer enters/exits Proximity box. *isActive*=true when viewer enters Proximity box, *isActive*=false when viewer exits Proximity box.
-
-#### 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] **enterTime**
-
-Time event generated when user's camera enters the box.
-
-#### 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] **exitTime**
-
-Time event generated when user's camera exits the box.
-
-#### Warning
-
-- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
-
-### SFVec3d [out] **geoCoord_changed**
-
-Sends geospatial coordinates of viewer's position corresponding to world position returned by position_changed.
-
-#### Hint
-
-- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
-
-#### Warnings
-
-- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
-- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
-
-### SFVec3f [out] **position_changed**
-
-Sends translation event relative to center.
-
-#### Warning
-
-- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
-
-### SFRotation [out] **orientation_changed**
-
-Sends rotation event relative to center.
-
-#### Warning
-
-- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
-
-### SFVec3f [out] **centerOfRotation_changed**
-
-Sends changed centerOfRotation values, likely caused by user interaction.
-
-#### 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
-
-- Multiple USEd instances are cumulative, but avoid overlaps.
-- Can first use GeoTransform to relocate/reorient box.
-- Surround entire world to start behaviors once scene is loaded.
-- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
-
-### Warning
-
-- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='2'/>`
-
-## See Also
-
-- [X3D Specification of GeoProximitySensor node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoProximitySensor){:target="_blank"}

package/docs/_posts/components/Geospatial/GeoTouchSensor.md

@@ -1,153 +0,0 @@
----
-title: GeoTouchSensor
-date: 2023-01-07
-nav: components-Geospatial
-categories: [components, Geospatial]
-tags: [GeoTouchSensor, Geospatial]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-GeoTouchSensor returns geographic coordinates for the object being selected. GeoTouchSensor can contain a GeoOrigin node.
-
-The GeoTouchSensor node belongs to the **Geospatial** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DChildNode
-    + X3DSensorNode
-      + X3DPointingDeviceSensorNode
-        + X3DTouchSensorNode
-          + GeoTouchSensor
-```
-
-## Fields
-
-### SFNode [in, out] **metadata** NULL <small>[X3DMetadataObject]</small>
-
-Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
-
-#### Hint
-
-- [X3D Architecture 7.2.4 Metadata](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/core.html#Metadata){:target="_blank"}
-
-### SFString [in, out] **description** ""
-
-Author-provided prose that describes intended purpose of this node.
-
-#### Hints
-
-- Include space characters since a *description* is not a DEF identifier. Write short phrases that make descriptions clear and readable.
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for &amp; ampersand character, or &amp;#34; for " quotation-mark character).
-
-### SFNode [ ] **geoOrigin** NULL <small>[GeoOrigin] (deprecated)</small>
-
-Single contained GeoOrigin node that can specify a local coordinate frame for extended precision.
-
-#### Hint
-
-- [X3D Architecture 25.2.5 Dealing with high-precision coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#high-precisioncoords){:target="_blank"}
-
-#### Warning
-
-- XML validation requires placement as first child node following contained metadata nodes (if any).
-
-### MFString [ ] **geoSystem** [ "GD", "WE" ]
-
-Identifies spatial reference frame: Geodetic (G D), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
-
-#### Hints
-
-- [X3D Architecture 25.2.2 Spatial reference frames](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
-- [X3D Architecture 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
-- [UTM is Universal Transverse Mercator coordinate system](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system){:target="_blank"}
-
-#### Warning
-
-- Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
-
-### SFBool [in, out] **enabled** TRUE
-
-Enables/disables node operation.
-
-### SFVec2f [out] **hitTexCoord_changed**
-
-Output event containing texture coordinates of surface at the hitGeoCoordinate.
-
-#### Warning
-
-- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
-
-### SFVec3f [out] **hitNormal_changed**
-
-Output event containing surface normal vector at the hitGeoCoordinate.
-
-#### Warning
-
-- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
-
-### SFVec3f [out] **hitPoint_changed**
-
-Output event containing 3D point on surface of underlying geometry, given in geometry coordinates (not geographic coordinates).
-
-#### Warning
-
-- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
-
-### SFVec3d [out] **hitGeoCoord_changed**
-
-Output event containing 3D point on surface of underlying geometry, given in GeoTouchSensor's local coordinate system.
-
-#### 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] **isOver**
-
-Is pointing device over sensor's 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 [out] **isActive**
-
-Select geometry by activating the pointing device (for example, clicking the mouse) to generate *isActive* events. Output event *isActive*=true is sent when geometry is selected (for example, when primary mouse button is pressed), output event *isActive*=false is sent when geometry is deselected (for example, when primary mouse button is released).
-
-#### 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] **touchTime**
-
-Time event generated when touched.
-
-#### Hint
-
-- *touchTime* event is generated when following three conditions are all met: (a) pointing device was pointing towards geometry when initially activated (isActive=true), (b) pointing device is currently pointing towards the geometry (isOver=true), and (c) pointing device selection is deactivated/deselected by user (isActive=false event is also generated).
-
-#### 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
-
-- This sensor detects user interactions affecting peer nodes and their child geometry.
-- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
-
-### Warning
-
-- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
-
-## See Also
-
-- [X3D Specification of GeoTouchSensor node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoTouchSensor){:target="_blank"}

package/docs/_posts/components/Geospatial/GeoTransform.md

@@ -1,182 +0,0 @@
----
-title: GeoTransform
-date: 2023-01-07
-nav: components-Geospatial
-categories: [components, Geospatial]
-tags: [GeoTransform, Geospatial]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-GeoTransform is a Grouping node that can contain most nodes. GeoTransform translates, orients and scales GeoCoordinate geometry within the local world coordinate system. GeoTransform coordinate system X-Z plane is tangent to ellipsoid of local spatial reference frame.
-
-The GeoTransform node belongs to the **Geospatial** component and its default container field is *children.* It is available from X3D version 3.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DChildNode
-    + X3DGroupingNode
-      + GeoTransform
-```
-
-## 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"}
-
-### SFVec3f [in, out] **translation** 0 0 0 <small>(-∞,∞)</small>
-
-Position (x, y, z in meters) of children relative to local coordinate system.
-
-#### Hint
-
-- The order of operation is first apply the center offset, then scaleOrientation and scale, then rotation, then restore the center offset, then *translation*.
-
-### SFRotation [in, out] **rotation** 0 0 1 0 <small>[-1,1] or (-∞,∞)</small>
-
-Orientation (axis, angle in radians) of children relative to local coordinate system.
-
-#### Hint
-
-- The order of operation is first apply the center offset, then scaleOrientation and scale, then *rotation*, then restore the center offset, then translation.
-
-### SFVec3f [in, out] **scale** 1 1 1 <small>(0,∞)</small>
-
-Non-uniform x-y-z *scale* of child coordinate system, adjusted by center and scaleOrientation.
-
-#### Hint
-
-- The order of operation is first apply the center offset, then scaleOrientation and *scale*, then rotation, then restore the center offset, then translation.
-
-### SFRotation [in, out] **scaleOrientation** 0 0 1 0 <small>[-1,1] or (-∞,∞)</small>
-
-Preliminary rotation of coordinate sys tem before scaling (to allow scaling around arbitrary orientations).
-
-#### Hint
-
-- The order of operation is first apply the center offset, then *scaleOrientation* and scale, then rotation, then restore the center offset, then translation.
-
-### SFNode [ ] **geoOrigin** NULL <small>[GeoOrigin] (deprecated)</small>
-
-Single contained GeoOrigin node that can specify a local coordinate frame for extended precision.
-
-#### Hint
-
-- [X3D Architecture 25.2.5 Dealing with high-precision coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#high-precisioncoords){:target="_blank"}
-
-#### Warning
-
-- XML validation requires placement as first child node following contained metadata nodes (if any).
-
-### MFString [ ] **geoSystem** [ "GD", "WE" ]
-
-Identifies spatial reference frame: Geodetic (GD), Geocentric (GC), Universal Transverse Mercator (UTM). Supported values: "GD" "UTM" or "GC" followed by additional quoted string parameters as appropriate for the type.
-
-#### Hints
-
-- [X3D Architecture 25.2.2 Spatial reference frames](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Spatialreferenceframes){:target="_blank"}
-- [X3D Architecture 25.2.4 Specifying geospatial coordinates](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/geospatial.html#Specifyinggeospatialcoords){:target="_blank"}
-- [UTM is Universal Transverse Mercator coordinate system](https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system){:target="_blank"}
-
-#### Warning
-
-- Deprecated values are GDC (replaced by GD) and GCC (replaced by GC).
-
-### SFVec3d [in, out] **geoCenter** 0 0 0 <small>(-∞,∞)</small>
-
-Translation offset from origin of local coordinate system, applied prior to rotation or scaling.
-
-#### Hints
-
-- The order of operation is first apply the center offset, then scaleOrientation and scale, then rotation, then restore the center offset, then translation.
-- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
-
-#### Warning
-
-- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
-
-### 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
-
-- +Y axis is up.
-- Insert a Shape node before adding geometry or Appearance.
-- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
-
-### Warnings
-
-- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='2'/>`
-- Avoid having GeoLocation or GeoTransform as a parent or ancestor node of each other, since multiple geospatial transformations then occur with unpredictable results.
-
-## See Also
-
-- [X3D Specification of GeoTransform node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/geospatial.html#GeoTransform){:target="_blank"}