x_ite 8.11.6 → 8.11.8

package/docs/_posts/components/Shape/Appearance.md

@@ -1,130 +0,0 @@
----
-title: Appearance
-date: 2023-01-07
-nav: components-Shape
-categories: [components, Shape]
-tags: [Appearance, Shape]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-Appearance specifies the visual properties of geometry by containing the Material, ImageTexture/MovieTexture/PixelTexture, FillProperties, LineProperties, programmable shader nodes (ComposedShader, PackagedShader, ProgramShader) and TextureTransform nodes.
-
-The Appearance node belongs to the **Shape** component and its default container field is *appearance.* It is available from X3D version 2.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DAppearanceNode
-    + Appearance
-```
-
-## 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 [in, out] **acousticProperties** NULL <small>[AcousticProperties]</small>
-
-Single contained *acousticProperties* node that can specify additional acoustic attributes applied to associated surface geometry.
-
-### SFString [in, out] **alphaMode** "AUTO" <small>["AUTO"|"OPAQUE"|"MASK"|"BLEND"]</small>
-
-Provides options for control of alpha transparency handling for textures. AUTO means Material transparency is applied to texture transparency for full backwards compatility with X3D3, OPAQUE means ignore alpha transparency to render texture as opaque, MASK means alpha-testing of pixels as fully transparent when alpha value is less than alphaCutoff and fully opaque when alpha value is greater than or equal to alphaCutoff, BLEND combines partial transparency of textures and materials.
-
-#### Hint
-
-- [GlTF version 2 Alpha Coverage](https://www.khronos.org/registry/glTF/specs/2.0/glTF-2.0.html#alpha-coverage){:target="_blank"}
-
-### SFFloat [in, out] **alphaCutoff** 0.5 <small>[0,1]</small>
-
-Threshold value used for pixel rendering either transparent or opaque, used when alphaMode="MASK".
-
-#### Hint
-
-- [GlTF version 2 Alpha Coverage](https://www.khronos.org/registry/glTF/specs/2.0/glTF-2.0.html#alpha-coverage){:target="_blank"}
-
-### SFNode [in, out] **pointProperties** NULL <small>[PointProperties]</small>
-
-Single contained PointProperties node that can specify additional visual attributes applied to corresponding point geometry.
-
-### SFNode [in, out] **lineProperties** NULL <small>[LineProperties]</small>
-
-Single contained LineProperties node that can specify additional visual attributes applied to corresponding line geometry.
-
-### SFNode [in, out] **fillProperties** NULL <small>[FillProperties]</small>
-
-Single contained FillProperties node that can specify additional visual attributes applied to polygonal areas of corresponding geometry, on top of whatever other appearance is already defined.
-
-### SFNode [in, out] **material** NULL <small>[X3DMaterialNode]</small>
-
-Single contained Material node that can specify visual attributes for lighting response (color types, transparency, etc.) applied to corresponding geometry.
-
-#### Warning
-
-- If *material* is NULL or unspecified, lighting is off (all lights ignored) for this Shape and unlit object color is (1, 1, 1).
-
-### SFNode [in, out] **backMaterial** NULL <small>[X3DOneSidedMaterialNode]</small>
-
-Input/Output field *backMaterial*.
-
-### SFNode [in, out] **texture** NULL <small>[X3DTextureNode]</small>
-
-Single contained *texture* node (ImageTexture, MovieTexture, PixelTexture, MultiTexture) that maps image(s) to surface geometry.
-
-#### Hints
-
-- If *texture* node is NULL or unspecified, corresponding Shape geometry for this Appearance is not textured.
-- [X3D Scene Authoring Hints, Images](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Images){:target="_blank"}
-- [X3D Architecture 18 Texturing component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html){:target="_blank"}
-- [X3D Architecture 33 Texturing3D component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texture3D.html){:target="_blank"}
-
-### SFNode [in, out] **textureTransform** NULL <small>[X3DTextureTransformNode]</small>
-
-Single contained TextureTransform node that defines 2D transformation applied to texture coordinates.
-
-#### Hints
-
-- Texture coordinates are reapplied (or else recomputed if *textureTransform* field initially NULL) whenever the corresponding vertex-based geometry changes.
-- If *textureTransform* array is empty, then this field has no effect.
-
-### MFNode [in, out] **shaders** [ ] <small>[X3DShaderNode]</small>
-
-Zero or more contained programmable shader nodes (ComposedShader, PackagedShader, ProgramShader) that specify, in order of preference, author-programmed rendering characteristics.
-
-#### Hint
-
-- [X3D Architecture 31 Programmable *shaders* component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/*shaders*.html){:target="_blank"}
-
-### SFNode [in, out] **blendMode** NULL <small>[BlendMode]</small> <small class="yellow">non standard</small>
-
-Single contained BlendMode node that defines blend mode properties.
-
-## Advisories
-
-### Hints
-
-- Insert a Shape node before adding geometry or Appearance. Interchange profile hint: only Material and ImageTexture children are allowed.
-- DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-- Advanced uses can contain MultiTexture, MultiTextureTransform/TextureTransformMatrix3D/TextureTransform3D, ComposedShader/PackagedShader/ProgramShader, ComposedTexture3D/ImageTexture3D/PixelTexture3D, or ComposedCubeMapTexture/GeneratedCubeMapTexture/ImageCubeMapTexture.
-- [X3D Architecture 12.2.2 Appearance node](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shape.html#Appearancenode){:target="_blank"}
-- [X3D Architecture 17.2.2 Lighting model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/lighting.html#Lightingmodel){:target="_blank"}
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Shape/Appearance/Appearance.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of Appearance node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Appearance){:target="_blank"}

package/docs/_posts/components/Shape/FillProperties.md

@@ -1,74 +0,0 @@
----
-title: FillProperties
-date: 2023-01-07
-nav: components-Shape
-categories: [components, Shape]
-tags: [FillProperties, Shape]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-FillProperties indicates whether appearance is filled or hatched for associated geometry nodes inside the same Shape. Hatches are applied on top of the already rendered appearance of the node, and are not affected by lighting.
-
-The FillProperties node belongs to the **Shape** component and its default container field is *fillProperties.* It is available from X3D version 3.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DAppearanceChildNode
-    + FillProperties
-```
-
-## 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] **filled** TRUE
-
-Whether or not associated geometry is *filled*.
-
-### SFBool [in, out] **hatched** TRUE
-
-Whether or not associated geometry is *hatched*.
-
-### SFInt32 [in, out] **hatchStyle** 1 <small>[0,∞)</small>
-
-*hatchStyle* selects a hatch pattern from ISO/IEC 9973 International Register of Graphical Items. 1=Horizontal equally spaced parallel lines. 2=Vertical equally spaced parallel lines. 3=Positive slope equally spaced parallel lines. 4=Negative slope equally spaced parallel lines. 5=Horizontal/vertical crosshatch. 6=Positive slope/negative slope crosshatch. 7=(cast iron or malleable iron and general use for all materials). 8=(steel). 9=(bronze, brass, copper, and compositions). 10=(white metal, zinc, lead, babbit, and alloys). 11=(magnesium, aluminum, and aluminum alloys). 12=(rubber, plastic, and electrical insulation). 13=(cork, felt, fabric, leather, and fibre). 14=(thermal insulation). 15=(titanium and refi-actory material). 16=(marble, slate, porcelain, glass, etc.). 17=(earth). 18=(sand). 19=(repeating dot).
-
-#### Hint
-
-- [Detailed descriptions of hatchstyle values are found at the ISO/IEC 9973 International Register of Graphical Items](https://www.iso.org/jtc1/sc24/register){:target="_blank"} [](https://isotc.iso.org/livelink/livelink/fetch/-8916524/8916549/8916590/6208440/class_pages/hatchstyle.html){:target="_blank"}
-
-### SFColor [in, out] **hatchColor** 1 1 1 <small>[0,1]</small>
-
-Color of the hatch pattern.
-
-## Advisories
-
-### Hint
-
-- DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-
-### Warning
-
-- Requires X3D `profile='Full'` or else include `<component name='Shape' level='3'/>`
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Shape/FillProperties/FillProperties.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of FillProperties node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#FillProperties){:target="_blank"}

package/docs/_posts/components/Shape/LineProperties.md

@@ -1,71 +0,0 @@
----
-title: LineProperties
-date: 2023-01-07
-nav: components-Shape
-categories: [components, Shape]
-tags: [LineProperties, Shape]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-LineProperties allows precise fine-grained control over the rendering style of lines and edges for associated geometry nodes inside the same Shape.
-
-The LineProperties node belongs to the **Shape** component and its default container field is *lineProperties.* It is available from X3D version 3.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DAppearanceChildNode
-    + LineProperties
-```
-
-## 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] **applied** TRUE
-
-Whether or not LineProperties are *applied* to associated geometry.
-
-### SFInt32 [in, out] **linetype** 1 <small>[1,∞)</small>
-
-*linetype* selects a line pattern, with solid default if defined value isn't supported. Values with guaranteed support are 1 Solid, 2 Dashed, 3 Dotted, 4 Dashed-dotted, 5 Dash-dot-dot. Optionally supported values are 6 single-headed arrow (arrow tip occurs at last point of each individual list of points), 7 single dot, 8 double-headed arrow, 10 chain line, 11 center line, 12 hidden line, 13 phantom line, 14 break line 1, 15 break line 2, 16 User-specified dash pattern.
-
-#### Hint
-
-- [Detailed descriptions of lineType values are found at the ISO/IEC 9973 International Register of Graphical Items](https://www.iso.org/jtc1/sc24/register){:target="_blank"} [](https://isotc.iso.org/livelink/livelink/fetch/-8916524/8916549/8916590/6208440/class_pages/*linetype*.html){:target="_blank"}
-
-### SFFloat [in, out] **linewidthScaleFactor** 0 <small>(-∞,∞)</small>
-
-*linewidthScaleFactor* is a scale factor multiplied by browser-dependent nominal linewidth, mapped to nearest available line width. Values zero or less provide minimum available line width.
-
-## Advisories
-
-### Hints
-
-- DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-- [LineProperties illustration model](https://X3dGraphics.com/examples/X3dForWebAuthors/Chapter05AppearanceMaterialTextures/LinePropertiesExampleIndex.html){:target="_blank"}
-
-### Warning
-
-- Requires X3D `profile='Full'` or else include `<component name='Shape' level='2'/>`
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Shape/LineProperties/LineProperties.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of LineProperties node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#LineProperties){:target="_blank"}

package/docs/_posts/components/Shape/Material.md

@@ -1,235 +0,0 @@
----
-title: Material
-date: 2023-01-07
-nav: components-Shape
-categories: [components, Shape]
-tags: [Material, Shape]
----
-<style>
-.post h3 {
-  word-spacing: 0.2em;
-}
-</style>
-
-## Overview
-
-Material specifies surface rendering properties for associated geometry nodes. Material attributes are used by the X3D lighting equations during rendering.
-
-The Material node belongs to the **Shape** component and its default container field is *material.* It is available from X3D version 2.0 or higher.
-
-## Hierarchy
-
-```
-+ X3DNode
-  + X3DAppearanceChildNode
-    + X3DMaterialNode
-      + X3DOneSidedMaterialNode
-        + Material
-```
-
-## 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"}
-
-### SFFloat [in, out] **ambientIntensity** 0.2 <small>[0,1]</small>
-
-How much ambient omnidirectional light is reflected from all light sources. Interchange profile hint: this field may be ignored, applying the default value regardless.
-
-### SFString [in, out] **ambientTextureMapping** ""
-
-The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
-
-#### Hint
-
-- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
-
-### SFNode [in, out] **ambientTexture** NULL <small>[X3DSingleTextureNode]</small>
-
-When applying ambientIntensity for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
-
-#### Hints
-
-- If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include `containerField='ambientTexture'`
-
-### SFColor [in, out] **diffuseColor** 0.8 0.8 0.8 <small>[0,1]</small>
-
-How much direct, angle-dependent light is reflected from all light sources.
-
-#### Hint
-
-- Only emissiveColor affects IndexedLineSet, LineSet and PointSet.
-
-### SFString [in, out] **diffuseTextureMapping** ""
-
-The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
-
-#### Hint
-
-- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
-
-### SFNode [in, out] **diffuseTexture** NULL <small>[X3DSingleTextureNode]</small>
-
-When applying diffuseColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
-
-#### Hints
-
-- If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include `containerField='diffuseTexture'`
-
-### SFColor [in, out] **specularColor** 0 0 0 <small>[0,1]</small>
-
-Specular highlights are brightness reflections (example: shiny spots on an apple). Interchange profile hint: this field may be ignored, applying the default value regardless.
-
-### SFString [in, out] **specularTextureMapping** ""
-
-The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
-
-#### Hint
-
-- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
-
-### SFNode [in, out] **specularTexture** NULL <small>[X3DSingleTextureNode]</small>
-
-When applying specularColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
-
-#### Hints
-
-- If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include `containerField='specularTexture'`
-
-### SFColor [in, out] **emissiveColor** 0 0 0 <small>[0,1]</small>
-
-How much glowing light is emitted from this object.
-
-#### Hints
-
-- EmissiveColors glow even when all lights are off.
-- Reset diffuseColor from default (.8 .8 .8) to (0 0 0) to avoid washout.
-- Only *emissiveColor* affects IndexedLineSet, LineSet and PointSet.
-
-#### Warning
-
-- Bright *emissiveColor* values can wash out other colors and some textures.
-
-### SFString [in, out] **emissiveTextureMapping** ""
-
-The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
-
-#### Hint
-
-- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
-
-### SFNode [in, out] **emissiveTexture** NULL <small>[X3DSingleTextureNode]</small>
-
-When applying emissiveColor for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
-
-#### Hints
-
-- If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include `containerField='emissiveTexture'`
-
-### SFFloat [in, out] **shininess** 0.2 <small>[0,1]</small>
-
-Lower *shininess* values provide soft specular glows, while higher values result in sharper, smaller highlights. Interchange profile hint: this field may be ignored, applying the default value regardless.
-
-### SFString [in, out] **shininessTextureMapping** ""
-
-The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
-
-#### Hint
-
-- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
-
-### SFNode [in, out] **shininessTexture** NULL <small>[X3DSingleTextureNode]</small>
-
-When applying shininess for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
-
-#### Hints
-
-- If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include `containerField='shininessTexture'`
-
-### SFFloat [in, out] **occlusionStrength** 1 <small>[0,1]</small>
-
-*occlusionStrength* indicates areas of indirect lighting, typically called ambient occlusion. Higher values indicate areas that should receive full indirect lighting and lower values indicate no indirect lighting.
-
-#### Hints
-
-- Only the Red channel of the texture is used for occlusion computations, other channels are ignored.
-- Https://en.wikipedia.org/wiki/Ambient_occlusion
-
-### SFString [in, out] **occlusionTextureMapping** ""
-
-The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
-
-#### Hint
-
-- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
-
-### SFNode [in, out] **occlusionTexture** NULL <small>[X3DSingleTextureNode]</small>
-
-When applying occlusionStrength for this material node, the contained texture provides Physically Based Rendering (PBR) modulation for each pixel.
-
-#### Hints
-
-- If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include `containerField='occlusionTexture'`
-
-### SFFloat [in, out] **normalScale** 1 <small>[0,∞)</small>
-
-*normalScale* controls the degree to which normalTexture RGB values apply XYZ-normal bump mapping to pixels in the parent material.
-
-#### Hints
-
-- *normalScale* only affects computation of normalTexture modulations that affect lighting of characteristics of the parent Material and has no relation to normal vectors defined by corresponding geometry.
-- [NormalTexture techniques apply Bump mapping](https://en.wikipedia.org/wiki/Bump_mapping){:target="_blank"}
-
-### SFString [in, out] **normalTextureMapping** ""
-
-The mapping label identifies which texture coordinates and transformations are used to compute texture effects from corresponding geometry on a given material.
-
-#### Hint
-
-- [TODO support planned to perform multiple-node mapping validation checks using X3D Schematron or X3D Validator](https://savage.nps.edu/X3dValidator){:target="_blank"}
-
-### SFNode [in, out] **normalTexture** NULL <small>[X3DSingleTextureNode]</small>
-
-When applying normalScale for this material node, the contained texture modulates the texture across the surface.
-
-#### Hints
-
-- [*normalTexture* techniques apply Bump mapping](https://en.wikipedia.org/wiki/Bump_mapping){:target="_blank"}
-- If texture node is NULL or unspecified, no effect is applied to material values.
-- Contained texture node must include `containerField='normalTexture'`
-
-### SFFloat [in, out] **transparency** 0 <small>[0,1]</small>
-
-How "clear" an object is: 1.0 is completely transparent, 0.0 is completely opaque. Interchange profile hint: *transparency* \< .5 opaque, *transparency* \> .5 transparent.
-
-## Advisories
-
-### Hints
-
-- Insert Shape and Appearance nodes before adding material.
-- DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
-- [X3D Example Archives, Basic, Universal Media Materials](https://www.web3d.org/x3d/content/examples/Basic/UniversalMediaMaterials){:target="_blank"}
-- [X3D Architecture 17.2.2 Lighting model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/lighting.html#Lightingmodel){:target="_blank"}
-- [Rendering](https://en.wikipedia.org/wiki/Rendering_(computer_graphics)){:target="_blank"}
-- [3D rendering](https://en.wikipedia.org/wiki/3D_rendering){:target="_blank"}
-- [Physically based rendering (PBR)](https://en.wikipedia.org/wiki/Physically_based_rendering){:target="_blank"}
-
-## Example
-
-<x3d-canvas src="https://create3000.github.io/media/examples/Shape/Material/Material.x3d" update="auto"></x3d-canvas>
-
-## See Also
-
-- [X3D Specification of Material node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Material){:target="_blank"}