x_ite 8.11.7 → 8.11.9

package/docs/_posts/components/Rendering/ClipPlane.md

@@ -1,72 +0,0 @@
----
-title: ClipPlane
-date: 2023-01-07
-nav: components-Rendering
-categories: [components, Rendering]
-tags: [ClipPlane, Rendering]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-ClipPlane specifies a single plane equation used to clip (i.e. cull or hide) displayed geometry. The plane field specifies a four-component plane equation that describes both inside and outside half space.
-
-The ClipPlane node belongs to the **Rendering** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DChildNode
-    + ClipPlane
-```
-
-## 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 node operation.
-
-### SFVec4f [in, out] **plane** 0 1 0 0 <small>[0,1] or (-∞,∞)</small>
-
-If (a,b,c,d) is the *plane*, with the first three components being a normalized vector describing the *plane*'s normal direction (and thus the fourth component d being distance from the origin), a point (x,y,z) is visible to the user, with regards to the clipping *plane*, if a*x+b*y+c*z+d is greater than 0.
-
-#### Hints
-
-- Negate all *plane* values to reverse which side of *plane* has visibility clipped.
-- [*plane*-geometry equations](https://en.wikipedia.org/wiki/Plane_(geometry)#Point-normal_form_and_general_form_of_the_equation_of_a_plane){:target="_blank"}
-- [*plane*-geometry distance to point](https://en.wikipedia.org/wiki/Plane_(geometry)#Distance_from_a_point_to_a_plane){:target="_blank"}
-
-#### Warning
-
-- (a, b, c) value of (0, 0, 0) is forbidden since the zero vector has ambiguous direction and is thus degenerate, not defining a *plane*.
-
-## Advisories
-
-### Hint
-
-- ClipPlane nodes only affect peer and descendant nodes, thus a parent grouping node can limit its effect.
-
-### Warning
-
-- [Requires X3D `profile='Full'` or else include `<component name='Rendering' level='5'/>` Examples: X3D Example Archives, Basic, CAD, Clip Plane Example](https://www.web3d.org/x3d/content/examples/Basic/CAD/ClipPlaneExampleIndex.html){:target="_blank"}
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Rendering/ClipPlane/ClipPlane.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of ClipPlane node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rendering.html#ClipPlane){:target="_blank"}

package/docs/_posts/components/Rendering/Color.md

@@ -1,56 +0,0 @@
----
-title: Color
-date: 2023-01-07
-nav: components-Rendering
-categories: [components, Rendering]
-tags: [Color, Rendering]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-Color node defines a set of RGB color values that apply either to a sibling Coordinate or CoordinateDouble node, or else to a parent ElevationGrid node. Color is only used by ElevationGrid, IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle* and IndexedTriangle* nodes.
-
-The Color node belongs to the **Rendering** component and its default container field is *color.* It is available from X3D version 2.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DGeometricPropertyNode
-    + X3DColorNode
-      + Color
-```
-
-## 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"}
-
-### MFColor [in, out] **color** [ ] <small>[0,1]</small>
-
-The *color* field defines an array of 3-tuple RGB colors.
-
-## Advisories
-
-### Hints
-
-- Colors are often controlled by Material instead.
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Rendering/Color/Color.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of Color node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rendering.html#Color){:target="_blank"}

package/docs/_posts/components/Rendering/ColorRGBA.md

@@ -1,65 +0,0 @@
----
-title: ColorRGBA
-date: 2023-01-07
-nav: components-Rendering
-categories: [components, Rendering]
-tags: [ColorRGBA, Rendering]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-ColorRGBA node defines a set of RGBA color values that apply either to a sibling Coordinate or CoordinateDouble node, or else to a parent ElevationGrid node. ColorRGBA is only used by ElevationGrid, IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle* and IndexedTriangle* nodes.
-
-The ColorRGBA node belongs to the **Rendering** component and its default container field is *color.* It is available from X3D version 3.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DGeometricPropertyNode
-    + X3DColorNode
-      + ColorRGBA
-```
-
-## 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"}
-
-### MFColorRGBA [in, out] **color** [ ] <small>[0,1]</small>
-
-The *color* field defines an array of 4-tuple RGBA colors.
-
-#### Warning
-
-- ColorRGBA requires Rendering component level 3 (alpha fully supported), Rendering component level 1 (alpha optional), otherwise Full profile.
-
-## Advisories
-
-### Hints
-
-- Colors are often controlled by Material instead.
-- Alpha channel may be ignored under Interchange profile.
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
-
-### Warning
-
-- ColorRGBA requires Rendering component level 3 (alpha fully supported), Rendering component level 1 (alpha optional), otherwise Full profile.
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Rendering/ColorRGBA/ColorRGBA.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of ColorRGBA node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rendering.html#ColorRGBA){:target="_blank"}

package/docs/_posts/components/Rendering/Coordinate.md

@@ -1,49 +0,0 @@
----
-title: Coordinate
-date: 2023-01-07
-nav: components-Rendering
-categories: [components, Rendering]
-tags: [Coordinate, Rendering]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-Coordinate builds geometry by defining a set of 3D coordinate (triplet) point values. Coordinate is used by IndexedFaceSet, IndexedLineSet, LineSet, PointSet, Triangle* and IndexedTriangle* nodes. Coordinate is also used by HAnimHumanoid, HAnimSegment, and various Nurbs nodes.
-
-The Coordinate node belongs to the **Rendering** component and its default container field is *coord.* It is available from X3D version 2.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DGeometricPropertyNode
-    + X3DCoordinateNode
-      + Coordinate
-```
-
-## 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"}
-
-### MFVec3f [in, out] **point** [ ] <small>(-∞,∞)</small>
-
-*point* contains a set of 3D coordinate (triplet) *point* values.
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Rendering/Coordinate/Coordinate.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of Coordinate node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rendering.html#Coordinate){:target="_blank"}

package/docs/_posts/components/Rendering/IndexedLineSet.md

@@ -1,156 +0,0 @@
----
-title: IndexedLineSet
-date: 2023-01-07
-nav: components-Rendering
-categories: [components, Rendering]
-tags: [IndexedLineSet, Rendering]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-IndexedLineSet defines polyline segments using index lists corresponding to vertex coordinates. IndexedLineSet is a geometry node that can contain a Coordinate or CoordinateDouble node and optionally a Color or ColorRGBA node.
-
-The IndexedLineSet node belongs to the **Rendering** component and its default container field is *geometry.* It is available from X3D version 2.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DGeometryNode
-    + IndexedLineSet
-```
-
-## 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"}
-
-### MFInt32 [in] **set_colorIndex** <small>[0,∞) or -1</small>
-
-*colorIndex* values define the order in which Color or ColorRGBA values are applied to polygons (or vertices).
-
-#### Hints
-
-- If *colorIndex* array is not provided, then Color or ColorRGBA values are indexed according to the coordIndex field.
-- If colorPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included.
-- If colorPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions.
-
-#### Warning
-
-- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
-
-### MFInt32 [in] **set_coordIndex** <small>[0,∞) or -1</small>
-
-*coordIndex* indices provide the order in which coordinates are applied to construct each polyline. Order starts at index 0, commas are optional between sets.
-
-#### Hint
-
-- Sentinel value -1 is used to separate indices for each successive polyline.
-
-#### Warning
-
-- It is an error to define this transient inputOnly field in an X3D file, instead only use it a destination for ROUTE events.
-
-### SFBool [ ] **colorPerVertex** TRUE
-
-Whether Color node color values are applied to each point vertex (true) or per polyline (false).
-
-#### Hint
-
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
-
-### MFInt32 [ ] **colorIndex** [ ] <small>[0,∞) or -1</small>
-
-*colorIndex* values define the order in which Color or ColorRGBA values are applied to polygons (or vertices).
-
-#### Hints
-
-- If *colorIndex* array is not provided, then Color or ColorRGBA values are indexed according to the coordIndex field.
-- If colorPerVertex='false' then one index is provided for each polygon defined by the coordIndex array. No sentinel -1 values are included.
-- If colorPerVertex='true' then a matching set of indices is provided, each separated by sentinel -1, that exactly corresponds to individual values in the coordIndex array polygon definitions.
-- If rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat initial each initial vertex to close the polygons.
-
-#### Warning
-
-- If child Color or ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
-
-### MFInt32 [ ] **coordIndex** [ ] <small>[0,∞) or -1</small>
-
-*coordIndex* indices provide the order in which coordinates are applied to construct each polygon face. Order starts at index 0, commas are optional between sets, use -1 to separate indices for each polyline.
-
-#### Hints
-
-- If rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat initial each initial vertex to close the polygons.
-- Sentinel value -1 is used to separate indices for each successive polyline.
-
-#### Warning
-
-- *coordIndex* is required in order to connect contained coordinate point values.
-
-### MFNode [in, out] **attrib** [ ] <small>[X3DVertexAttributeNode]</small>
-
-Single contained FloatVertexAttribute node 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] **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.
-
-#### Warning
-
-- *normal* vectors increase file size, typically doubling geometry definitions.
-
-### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
-
-Single contained Coordinate or CoordinateDouble node that can specify a list of vertex values.
-
-## Advisories
-
-### Hints
-
-- [Polygonal chain](https://en.wikipedia.org/wiki/Polygonal_chain){:target="_blank"}
-- Either values in a contained Color node, or else Material emissiveColor in corresponding Appearance node, are used for rendering lines and points.
-- Adding LineProperties to the corresponding Appearance node can modify the rendering style of these lines.
-- If rendering Coordinate points originally defined for an IndexedFaceSet, index values may need to repeat each initial vertex to close each polygon outline.
-- Step-wise variation or linear interpolation of color values can be used as a good scientific visualization technique to map arbitrary function values to a color map.
-- Insert a Shape node before adding geometry or Appearance.
-- For advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
-- Consider including Fog (with Fog color matching Background color) to provide further depth cueing for IndexedLineSet (ILS).
-
-### Warnings
-
-- Lines are not lit, are not texture-mapped, and do not participate in collision detection.
-- Use a different color (or Material emissiveColor) than the Background color, otherwise geometry is invisible.
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Rendering/IndexedLineSet/IndexedLineSet.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of IndexedLineSet node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rendering.html#IndexedLineSet){:target="_blank"}

package/docs/_posts/components/Rendering/IndexedTriangleFanSet.md

@@ -1,149 +0,0 @@
----
-title: IndexedTriangleFanSet
-date: 2023-01-07
-nav: components-Rendering
-categories: [components, Rendering]
-tags: [IndexedTriangleFanSet, Rendering]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-IndexedTriangleFanSet is a geometry node containing a Coordinate or CoordinateDouble node, and can also contain Color or ColorRGBA, Normal and TextureCoordinate nodes.
-
-The IndexedTriangleFanSet node belongs to the **Rendering** component and its default container field is *geometry.* It is available from X3D version 3.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DGeometryNode
-    + X3DComposedGeometryNode
-      + IndexedTriangleFanSet
-```
-
-## 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"}
-
-### MFInt32 [in] **set_index** <small>[0,∞) or -1</small>
-
-Input field *set_index*.
-
-### 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).
-
-#### Hints
-
-- 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
-
-- Default value true can completely hide geometry if viewed from wrong side!
-
-### SFBool [ ] **ccw** TRUE
-
-*ccw* defines clockwise/counterclockwise ordering of vertex coordinates, which in turn defines front/back orientation of polygon normals according to Right-Hand Rule (RHR).
-
-#### Hints
-
-- A good debugging technique for problematic polygons is to try changing the value of *ccw*, which can reverse solid effects (single-sided backface culling) and normal-vector direction.
-- [Clockwise](https://en.wikipedia.org/wiki/Clockwise){:target="_blank"}
-
-#### Warning
-
-- Consistent and correct ordering of left-handed or right-handed point sequences is important throughout the coord array of point values.
-
-### SFBool [ ] **colorPerVertex** TRUE
-
-Whether Color or ColorRGBA values are applied to each point vertex (true) or to each polygon face (false).
-
-#### Hint
-
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
-
-#### Warnings
-
-- The provided value of IndexedTriangleFanSet *colorPerVertex* field is ignored and always treated as true.
-- If child Color or ColorRGBA node is not provided, then geometry is rendered using corresponding Appearance and material/texture values.
-
-### SFBool [ ] **normalPerVertex** TRUE
-
-Whether Normal node vector values are applied to each point vertex (true) or to each polygon face (false).
-
-#### Hint
-
-- If no child Normal node is provided, the X3D browser shall automatically generate normals, using creaseAngle to determine smoothed shading across shared vertices.
-
-### MFInt32 [ ] **index** [ ] <small>[0,∞) or -1</small>
-
-*index* list specifies triangles by connecting Coordinate vertices, each individual fan separated by -1 sentinel value.
-
-#### Hint
-
-- First indexed coordinate in each sequence is fan center.
-
-### MFNode [in, out] **attrib** [ ] <small>[X3DVertexAttributeNode]</small>
-
-Single contained FloatVertexAttribute node 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.
-
-#### Warning
-
-- *normal* vectors increase file size, typically doubling geometry definitions.
-
-### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
-
-Single contained Coordinate or CoordinateDouble node that can specify a list of vertex values.
-
-## Advisories
-
-### Hints
-
-- Color, normal and texCoord values are applied in the same order as coord values.
-- Insert a Shape node before adding geometry or Appearance.
-- For advanced extensibility, authors can substitute a type-matched ProtoInstance node (with correct containerField value) for contained node content.
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Rendering/IndexedTriangleFanSet/IndexedTriangleFanSet.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of IndexedTriangleFanSet node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/rendering.html#IndexedTriangleFanSet){:target="_blank"}