x_ite 8.4.3 → 8.5.3

package/docs/_posts/components/CADGeometry/CADPart.md

@@ -0,0 +1,117 @@
+---
+title: CADPart
+date: 2022-01-07
+nav: components-CADGeometry
+categories: [components, CADGeometry]
+tags: [CADPart, CADGeometry]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+CADPart is an atomic part that defines both coordinate-system location and the faces that constitute a part in a Computer-Aided Design (CAD) model. CADPart contains multiple CADFace nodes that make up a single part.
+
+The CADPart node belongs to the **CADGeometry** component and its default container field is *children.* It is available since X3D version 3.1 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DChildNode
+    + X3DGroupingNode
+      + CADPart (X3DProductStructureChildNode)*
+```
+
+<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.
+
+### SFString [in, out] **name** ""
+
+Optional name for this particular CAD node.
+
+#### Warning
+
+- Name is not included if this instance is a USE node.
+
+### 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 system 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.
+
+### SFVec3f [in, out] **center** 0 0 0 <small>(-∞,∞)</small>
+
+Translation offset from origin of local coordinate system, applied prior to rotation or scaling.
+
+#### 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 [ ] **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>[CADFace]</small>
+
+Input/Output field children.
+
+## Description
+
+### Hint
+
+- Include `<component name='CADGeometry' level='2'/>`
+
+## External Links
+
+- [X3D Specification of CADPart](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/CADGeometry.html#CADPart){:target="_blank"}

package/docs/_posts/components/CADGeometry/IndexedQuadSet.md

@@ -0,0 +1,125 @@
+---
+title: IndexedQuadSet
+date: 2022-01-07
+nav: components-CADGeometry
+categories: [components, CADGeometry]
+tags: [IndexedQuadSet, CADGeometry]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+IndexedQuadSet is a geometry node that defines quadrilaterals. IndexedQuadSet can contain Color/ColorRGBA, Coordinate/CoordinateDouble, Normal and TextureCoordinate nodes.
+
+The IndexedQuadSet node belongs to the **CADGeometry** component and its default container field is *geometry.* It is available since X3D version 3.1 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DGeometryNode
+    + X3DComposedGeometryNode
+      + IndexedQuadSet
+```
+
+## 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.
+
+### MFInt32 [in] **set_index** <small>[0,∞)</small>
+
+*index* values provide order in which coordinates are applied. Order starts at index 0, commas are optional between sets. Four unique indices are defined for each quadrilateral.
+
+#### Warning:
+
+- -1 sentinel values are not allowed.
+
+### 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.
+
+### SFBool [ ] **colorPerVertex** TRUE
+
+Whether Color node color values are applied to each vertex (true) or to each polygon face (false).
+
+#### See Also
+
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+
+### SFBool [ ] **normalPerVertex** TRUE
+
+Whether Normal node vector values are applied to each vertex (true) or to each polygon face (false).
+
+### MFInt32 [ ] **index** [ ] <small>[0,∞)</small>
+
+*index* values provide order in which coordinates are applied. Order starts at index 0, commas are optional between sets. Four unique indices are defined for each quadrilateral.
+
+#### Warning:
+
+- -1 sentinel values are not allowed.
+
+### MFNode [in, out] **attrib** [ ] <small>[X3DVertexAttributeNode]</small>
+
+Multiple contained FloatVertexAttribute nodes that can specify list of per-vertex attribute information for programmable shaders.
+
+#### Hint
+
+- [X3D Architecture 32.2.2.4 Per-vertex attributes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shaders.html#Pervertexattributes){:target="_blank"}
+
+### SFNode [in, out] **fogCoord** NULL <small>[FogCoordinate]</small>
+
+Single contained FogCoordinate node that can specify depth parameters for fog in corresponding geometry.
+
+### SFNode [in, out] **color** NULL <small>[X3DColorNode]</small>
+
+Single contained Color or ColorRGBA node that can specify color values applied to corresponding vertices according to colorIndex and colorPerVertex fields.
+
+### SFNode [in, out] **texCoord** NULL <small>[X3DTextureCoordinateNode]</small>
+
+Single contained TextureCoordinate, TextureCoordinateGenerator or MultiTextureCoordinate node that can specify coordinates for texture mapping onto corresponding geometry.
+
+### SFNode [in, out] **normal** NULL <small>[X3DNormalNode]</small>
+
+Single contained Normal node that can specify perpendicular vectors for corresponding vertices to support rendering computations, applied according to the normalPerVertex field.
+
+#### Hint
+
+- Useful for special effects. Normal vector computation by 3D graphics hardware is quite fast so adding normals to a scene is typically unnecessary.
+
+### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
+
+Single contained Coordinate or CoordinateDouble node that can specify a list of vertex values.
+
+## Description
+
+### Hints
+
+- Insert a Shape node before adding geometry or Appearance.
+- You can also substitute a type-matched ProtoInstance node for contained content.
+- Include `<component name='CADGeometry' level='1'/>`
+
+## External Links
+
+- [X3D Specification of IndexedQuadSet](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/CADGeometry.html#IndexedQuadSet){:target="_blank"}

package/docs/_posts/components/CADGeometry/QuadSet.md

@@ -0,0 +1,113 @@
+---
+title: QuadSet
+date: 2022-01-07
+nav: components-CADGeometry
+categories: [components, CADGeometry]
+tags: [QuadSet, CADGeometry]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+QuadSet is a geometry node that defines quadrilaterals. QuadSet can contain Color/ColorRGBA, Coordinate/CoordinateDouble, Normal and TextureCoordinate nodes.
+
+The QuadSet node belongs to the **CADGeometry** component and its default container field is *geometry.* It is available since X3D version 3.1 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + X3DGeometryNode
+    + X3DComposedGeometryNode
+      + QuadSet
+```
+
+## 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.
+
+### SFBool [ ] **colorPerVertex** TRUE
+
+Whether Color node color values are applied to each vertex (true) or to each polygon face (false).
+
+#### See Also
+
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+
+### SFBool [ ] **normalPerVertex** TRUE
+
+Whether Normal node vector values are applied to each vertex (true) or to each polygon face (false).
+
+### MFNode [in, out] **attrib** [ ] <small>[X3DVertexAttributeNode]</small>
+
+Multiple contained FloatVertexAttribute nodes that can specify list of per-vertex attribute information for programmable shaders.
+
+#### Hint
+
+- [X3D Architecture 32.2.2.4 Per-vertex attributes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shaders.html#Pervertexattributes){:target="_blank"}
+
+### SFNode [in, out] **fogCoord** NULL <small>[FogCoordinate]</small>
+
+Single contained FogCoordinate node that can specify depth parameters for fog in corresponding geometry.
+
+### SFNode [in, out] **color** NULL <small>[X3DColorNode]</small>
+
+Single contained Color or ColorRGBA node that can specify color values applied to corresponding vertices according to colorIndex and colorPerVertex fields.
+
+### SFNode [in, out] **texCoord** NULL <small>[X3DTextureCoordinateNode]</small>
+
+Single contained TextureCoordinate, TextureCoordinateGenerator or MultiTextureCoordinate node that can specify coordinates for texture mapping onto corresponding geometry.
+
+### SFNode [in, out] **normal** NULL <small>[X3DNormalNode]</small>
+
+Single contained Normal node that can specify perpendicular vectors for corresponding vertices to support rendering computations, applied according to the normalPerVertex field.
+
+#### Hint
+
+- Useful for special effects. Normal vector computation by 3D graphics hardware is quite fast so adding normals to a scene is typically unnecessary.
+
+### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
+
+Single contained Coordinate or CoordinateDouble node that can specify a list of vertex values.
+
+## Description
+
+### Hints
+
+- Insert a Shape node before adding geometry or Appearance.
+- You can also substitute a type-matched ProtoInstance node for contained content.
+- Include `<component name='CADGeometry' level='1'/>`
+
+## Example
+
+<x3d-canvas src="https://create3000.github.io/media/examples/CADGeometry/QuadSet/QuadSet.x3d"></x3d-canvas>
+
+## External Links
+
+- [X3D Specification of QuadSet](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/CADGeometry.html#QuadSet){:target="_blank"}

package/docs/_posts/components/Core/MetadataBoolean.md

@@ -0,0 +1,90 @@
+---
+title: MetadataBoolean
+date: 2022-01-07
+nav: components-Core
+categories: [components, Core]
+tags: [MetadataBoolean, Core]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+MetadataBoolean contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata node may be provided by a single child Metadata node with containerField="metadata".
+
+The MetadataBoolean node belongs to the **Core** component and its default container field is *metadata.* It is available since X3D version 3.3 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + MetadataBoolean (X3DMetadataObject)*
+```
+
+<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.
+
+### SFString [in, out] **name** ""
+
+Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.
+
+#### Warning
+
+- Name is not included if this instance is a USE node.
+
+### SFString [in, out] **reference** ""
+
+*reference* to the metadata standard or definition defining this particular metadata value.
+
+### MFBool [in, out] **value** [ ]
+
+The value attribute is a strictly typed data array providing relevant metadata information.
+
+#### Warning
+
+- Use lower-case values ("true false") for .x3d XML encoding, and upper-case values ("TRUE FALSE") for .x3dv ClassicVRML encoding.
+
+### 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.
+
+### SFString [in, out] **name** ""
+
+Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.
+
+#### Warning
+
+- Name is not included if this instance is a USE node.
+
+### SFString [in, out] **reference** ""
+
+*reference* to the metadata standard or definition defining this particular metadata value.
+
+### MFBool [in, out] **value** [ ]
+
+The value attribute is a strictly typed data array providing relevant metadata information.
+
+#### Warning
+
+- Use lower-case values ("true false") for .x3d XML encoding, and upper-case values ("TRUE FALSE") for .x3dv ClassicVRML encoding.
+
+## Description
+
+### Hints
+
+- Use containerField="value" if the parent node is MetadataSet.
+- If a metadata node is needed as a top-level root node for the scene, first insert a parent WorldInfo (or WorldInfo/MetadataSet) to contain it.
+- An IS statement precedes any sibling Metadata node, which in turn precedes any other sibling nodes.
+
+## External Links
+
+- [X3D Specification of MetadataBoolean](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataBoolean){:target="_blank"}
+- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}

package/docs/_posts/components/Core/MetadataDouble.md

@@ -0,0 +1,67 @@
+---
+title: MetadataDouble
+date: 2022-01-07
+nav: components-Core
+categories: [components, Core]
+tags: [MetadataDouble, Core]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+MetadataDouble contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata node may be provided by a single child Metadata node with containerField="metadata".
+
+The MetadataDouble node belongs to the **Core** component and its default container field is *metadata.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + MetadataDouble (X3DMetadataObject)*
+```
+
+<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.
+
+### SFString [in, out] **name** ""
+
+Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.
+
+#### Warning
+
+- Name is not included if this instance is a USE node.
+
+### SFString [in, out] **reference** ""
+
+*reference* to the metadata standard or definition defining this particular metadata value.
+
+### MFDouble [in, out] **value** [ ]
+
+The value attribute is a strictly typed data array providing relevant metadata information.
+
+#### Hint
+
+- Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+
+## Description
+
+### Hints
+
+- Use containerField="value" if the parent node is MetadataSet.
+- If a metadata node is needed as a top-level root node for the scene, first insert a parent WorldInfo (or WorldInfo/MetadataSet) to contain it.
+- An IS statement precedes any sibling Metadata node, which in turn precedes any other sibling nodes.
+- The choice of MetadataDouble versus MetadataFloat usually depends on the relevant tool utilizing the value, or else the relevant metadata reference defining the value.
+
+## External Links
+
+- [X3D Specification of MetadataDouble](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataDouble){:target="_blank"}
+- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}

package/docs/_posts/components/Core/MetadataFloat.md

@@ -0,0 +1,67 @@
+---
+title: MetadataFloat
+date: 2022-01-07
+nav: components-Core
+categories: [components, Core]
+tags: [MetadataFloat, Core]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+MetadataFloat contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata node may be provided by a single child Metadata node with containerField="metadata".
+
+The MetadataFloat node belongs to the **Core** component and its default container field is *metadata.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + MetadataFloat (X3DMetadataObject)*
+```
+
+<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.
+
+### SFString [in, out] **name** ""
+
+Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.
+
+#### Warning
+
+- Name is not included if this instance is a USE node.
+
+### SFString [in, out] **reference** ""
+
+*reference* to the metadata standard or definition defining this particular metadata value.
+
+### MFFloat [in, out] **value** [ ]
+
+The value attribute is a strictly typed data array providing relevant metadata information.
+
+#### Hint
+
+- Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+
+## Description
+
+### Hints
+
+- Use containerField="value" if the parent node is MetadataSet.
+- If a metadata node is needed as a top-level root node for the scene, first insert a parent WorldInfo (or WorldInfo/MetadataSet) to contain it.
+- An IS statement precedes any sibling Metadata node, which in turn precedes any other sibling nodes.
+- The choice of MetadataDouble versus MetadataFloat usually depends on the relevant tool utilizing the value, or else the relevant metadata reference defining the value.
+
+## External Links
+
+- [X3D Specification of MetadataFloat](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataFloat){:target="_blank"}
+- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}

package/docs/_posts/components/Core/MetadataInteger.md

@@ -0,0 +1,66 @@
+---
+title: MetadataInteger
+date: 2022-01-07
+nav: components-Core
+categories: [components, Core]
+tags: [MetadataInteger, Core]
+---
+<style>
+.post h3 {
+  word-spacing: 0.2em;
+}
+</style>
+
+## Overview
+
+MetadataInteger contains a typed list of values providing metadata information about its parent node. Further information about this specific Metadata node may be provided by a single child Metadata node with containerField="metadata".
+
+The MetadataInteger node belongs to the **Core** component and its default container field is *metadata.* It is available since X3D version 3.0 or later.
+
+## Hierarchy
+
+```
++ X3DNode
+  + MetadataInteger (X3DMetadataObject)*
+```
+
+<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.
+
+### SFString [in, out] **name** ""
+
+Depending on the metadata vocabulary, the attribute name is usually required for metadata nodes.
+
+#### Warning
+
+- Name is not included if this instance is a USE node.
+
+### SFString [in, out] **reference** ""
+
+*reference* to the metadata standard or definition defining this particular metadata value.
+
+### MFInt32 [in, out] **value** [ ]
+
+The value attribute is a strictly typed data array providing relevant metadata information.
+
+#### Hint
+
+- Many XML tools substitute XML character references automatically if needed (such as &amp;#38; for &amp; ampersand, or &amp;#34; for " quotation mark).
+
+## Description
+
+### Hints
+
+- Use containerField="value" if the parent node is MetadataSet.
+- If a metadata node is needed as a top-level root node for the scene, first insert a parent WorldInfo (or WorldInfo/MetadataSet) to contain it.
+- An IS statement precedes any sibling Metadata node, which in turn precedes any other sibling nodes.
+
+## External Links
+
+- [X3D Specification of MetadataInteger](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/core.html#MetadataInteger){:target="_blank"}
+- [X3D for Web Authors, Chapter 15, Metadata Information](https://x3dgraphics.com/examples/X3dForWebAuthors/Chapter15-Metadata/Chapter15-MetadataInformation.html){:target="_blank"}