x_ite 8.8.6 → 8.9.0

package/docs/_posts/components/Shaders/ShaderProgram.md

@@ -1,6 +1,6 @@
 ---
 title: ShaderProgram
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shaders
 categories: [components, Shaders]
 tags: [ShaderProgram, Shaders]
@@ -15,7 +15,7 @@ tags: [ShaderProgram, Shaders]
 
 ShaderProgram is contained by ProgramShader and provides the source and interface to a self-contained program that occupies one part of the rendering process: either a vertex or fragment shader.
 
-The ShaderProgram node belongs to the **Shaders** component and its default container field is *programs.* It is available since X3D version 3.0 or later.
+The ShaderProgram node belongs to the **Shaders** component and its default container field is *programs.* It is available from X3D version 3.0 or higher.
 
 ## Hierarchy
 
@@ -30,7 +30,11 @@ The ShaderProgram node belongs to the **Shaders** component and its default cont
 
 ### 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.
+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** ""
 
@@ -38,7 +42,7 @@ Author-provided prose that describes intended purpose of the url asset.
 
 #### Hint
 
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
+- 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).
 
 ### SFString [ ] **type** "VERTEX" <small>["VERTEX"|"FRAGMENT"]</small>
 
@@ -50,11 +54,11 @@ Author-provided prose that describes intended purpose of the url asset.
 
 ### SFBool [in, out] **load** TRUE
 
-*load*=true means load immediately, load=false means defer loading or else unload a previously loaded asset.
+*load*=true means *load* immediately, *load*=false means defer loading or else unload a previously loaded scene.
 
 #### Hints
 
-- Allows author to design when ImageTextureAtlas loading occurs via user interaction, event chains or scripting.
+- Allows author to design when Inline loading occurs via user interaction, event chains or scripting.
 - Use a separate LoadSensor node to detect when loading is complete.
 
 ### MFString [in, out] **url** [ ] <small>[URI]</small>
@@ -63,15 +67,15 @@ Location and filename of shader. Multiple locations are more reliable, and inclu
 
 #### Hints
 
-- MFString arrays can have multiple values, so separate each individual string by quote marks "https://www.web3d.org" "https://www.web3d.org/about" "etc." XML encoding for quotation mark " is &amp;quot; (which is called a character entity). Can replace embedded blank(s) in url queries with %20 for each blank character.
+- Embedded ecmascript: source can also be contained in the sourceCode pseudo-field without escape characters, equivalent to last entry in the *url* list, when using other API codebases and file encodings.
+- MFString arrays can have multiple values, so separate each individual string by quote marks "https://www.web3d.org" "https://www.web3d.org/about" "etc."
+- Alternative XML encoding for quotation mark " is &amp;quot; (which is an example of a character entity).
+- Can replace embedded blank(s) in *url* queries with %20 for each blank character.
+- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
 
 #### Warning
 
-- Strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https and other operating systems are not.
-
-#### See Also
-
-- [X3D Scene Authoring Hints, urls](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#urls){:target="_blank"}
+- Strictly match directory and filename capitalization for http links! This is important for portability. Some operating systems are forgiving of capitalization mismatches, but http/https *url* addresses and paths in Unix-based operating systems are all case sensitive and intolerant of uppercase/lowercase mismatches.
 
 ### SFTime [in, out] **autoRefresh** 0 <small>[0,∞)</small>
 
@@ -98,13 +102,20 @@ Location and filename of shader. Multiple locations are more reliable, and inclu
 
 - Automatically reloading content has security considerations and needs to be considered carefully.
 
-## Description
+## Advisories
 
 ### Hints
 
-- ShaderProgram contains IS/connect and field definitions.
-- ShaderProgram can contain a CDATA section of plain-text source code.
+- ShaderProgram contains field declarations and then corresponding IS/connect statements (if any).
+- Insert an XML Character Data (CDATA) block within the Script node to contain source code embedded within an X3D scene, avoiding the need for escape characters.
+- A contained XML Character Data (CDATA) block for source code protects whitespace, line breaks, and literal characters (such as &amp; for ampersand character, \< for less-than-sign character, and \> for greater-than-sign character) from unintended escape-character modifications by XML parsers.
+- [When parent node is LoadSensor, apply `containerField='children'` (X3Dv4) or `containerField='watchList'` (X3Dv3).](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#fieldNameChanges){:target="_blank"}
+- Embedded ecmascript: source can also be contained in the sourceCode pseudo-field without escape characters, equivalent to last entry in the url list, when using other API codebases and file encodings.
+
+### Warning
+
+- Strict order is required for contained constructs: first field declarations (if any), then IS/connect statements (if any), and finally CDATA source-code block.
 
-## External Links
+## See Also
 
-- [X3D Specification of ShaderProgram](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#ShaderProgram){:target="_blank"}
+- [X3D Specification of ShaderProgram node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shaders.html#ShaderProgram){:target="_blank"}

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

@@ -13,21 +13,27 @@ tags: [AcousticProperties, Shape]
 
 ## Overview
 
-AcousticProperties ...
+AcousticProperties specifies the interaction of sound waves with characteristics of geometric objects in the scene. Acoustic coefficient values are expected to fully account for physical and structural characteristics of associated geometry such as width, height, thickness, shape, softness and/or hardness, and density variations.
 
-The AcousticProperties node belongs to the **Shape** component and its default container field is *AcousticProperties.* It is available since X3D version 4.0 or later.
+The AcousticProperties node belongs to the **Shape** component and its default container field is *acousticProperties.* It is available from X3D version 4.0 or higher.
 
 ## Hierarchy
 
 ```
 + X3DNode
+  + X3DAppearanceChildNode
+    + AcousticProperties
 ```
 
 ## 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.
+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** ""
 
@@ -35,18 +41,40 @@ Author-provided prose that describes intended purpose of the url asset.
 
 #### Hint
 
-- Many XML tools substitute XML character references for special characters automatically if needed within an attribute value (such as &amp;#38; for & ampersand character, or &amp;#34; for " quotation-mark character).
+- 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).
 
 ### SFBool [in, out] **enabled** TRUE
 
-### SFFloat [in, out] **absorption** 0 <small></small>
+Enables/disables node operation.
+
+### SFFloat [in, out] **absorption** 0 <small>[0,1]</small>
+
+Specifies the sound *absorption* coefficient of a surface, meaning the ratio of sound intensity not reflected by a surface.
+
+### SFFloat [in, out] **refraction** 0 <small>[0,1]</small>
+
+Sound *refraction* coefficient of a medium, which determines change in propagation direction of sound wave when obliquely crossing boundary between two mediums where its speed is different.
+
+#### Hint
+
+- [Relationships described by Snell's Law](https://en.wikipedia.org/wiki/Snell%27s_law){:target="_blank"}
+
+### SFFloat [in, out] **diffuse** 0 <small>[0,1]</small>
+
+*diffuse* coefficient of sound reflection indicates how much of the incident sound energy is reflected back in multiple directions.
+
+### SFFloat [in, out] **specular** 0 <small>[0,1]</small>
+
+*specular* coefficient of sound reflection striking a plane surface, directly reflected back into space, where angle of reflection equals angle of incidence.
 
-### SFFloat [in, out] **refraction** 0 <small></small>
+## Advisories
 
-### SFFloat [in, out] **diffuse** 0 <small></small>
+### Hints
 
-### SFFloat [in, out] **specular** 0 <small></small>
+- AcousticProperties must have a parent Appearance node, and only affects geometry within the same Shape.
+- Proxy geometry for acoustic response can be far simpler than geometry needed for visual rendering.
+- [X3D Architecture Figure 16.2 Sound Propagation Phenomena](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/sound.html#f-SoundPropagationPhenomena){:target="_blank"}
 
-## External Links
+## See Also
 
-- [X3D Specification of AcousticProperties](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#AcousticProperties){:target="_blank"}
+- [X3D Specification of AcousticProperties node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#AcousticProperties){:target="_blank"}

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

@@ -1,6 +1,6 @@
 ---
 title: Appearance
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [Appearance, Shape]
@@ -13,9 +13,9 @@ tags: [Appearance, Shape]
 
 ## Overview
 
-Appearance specifies the visual properties of geometry by containing the Material, ImageTexture/MovieTexture/PixelTexture, FillProperties, LineProperties, and TextureTransform nodes.
+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 since X3D version 2.0 or later.
+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
 
@@ -29,15 +29,23 @@ The Appearance node belongs to the **Shape** component and its default container
 
 ### 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.
+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 compatibility 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.
+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"}
+- [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>
 
@@ -45,7 +53,7 @@ Threshold value used for pixel rendering either transparent or opaque, used when
 
 #### Hint
 
-- [glTF version 2 Alpha Coverage](https://www.khronos.org/registry/glTF/specs/2.0/glTF-2.0.html#alpha-coverage){:target="_blank"}
+- [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>
 
@@ -65,30 +73,31 @@ Single contained Material node that can specify visual attributes for lighting r
 
 #### Warning
 
-- If material is NULL or unspecified, lighting is off (all lights ignored) for this Shape and unlit object color is (1, 1, 1).
+- 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>
 
-Single contained Material node that can specify visual attributes for lighting response (color types, transparency, etc.) applied to corresponding geometry.
+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.
+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.
+- 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"}
-- [3D Architecture 18 Texturing component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/texturing.html){: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.
 
-#### Hint
+#### Hints
 
-- If textureTransform array is empty, then this field has no effect.
+- 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>
 
@@ -96,28 +105,26 @@ Zero or more contained programmable shader nodes (ComposedShader, PackagedShader
 
 #### Hint
 
-- [X3D Architecture 31 Programmable shaders component](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/shaders.html){:target="_blank"}
+- [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] <span class="yellow">non standard</span></small>
+### SFNode [in, out] **blendMode** NULL <small>[BlendMode]</small> <small class="yellow">non standard</small>
 
 Single contained BlendMode node that defines blend mode properties.
 
-### SFNode [in, out] **acousticProperties** NULL <small>[AcousticProperties]</small>
-
-Single contained acousticProperties node that can specify additional acoustic attributes applied to associated surface geometry.
-
-## Description
+## 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>
 
-## External Links
+## See Also
 
-- [X3D Specification of Appearance](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#Appearance){:target="_blank"}
+- [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,6 +1,6 @@
 ---
 title: FillProperties
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [FillProperties, Shape]
@@ -15,7 +15,7 @@ tags: [FillProperties, Shape]
 
 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 since X3D version 3.0 or later.
+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
 
@@ -29,39 +29,46 @@ The FillProperties node belongs to the **Shape** component and its default conta
 
 ### 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.
+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.
+Whether or not associated geometry is *filled*.
 
 ### SFBool [in, out] **hatched** TRUE
 
-Whether or not associated geometry is hatched.
+Whether or not associated geometry is *hatched*.
 
 ### SFInt32 [in, out] **hatchStyle** 1 <small>[0,∞)</small>
 
-*hatchStyle* selects a hatch pattern from 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).
+*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 International Register of Graphical Items](https://www.iso.org/jtc1/sc24/register){:target="_blank"} (may require login)
+- [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.
 
-## Description
+## Advisories
 
-### Hints
+### Hint
 
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-- Include `<component name='Shape' level='3'/>`
+
+### 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>
 
-## External Links
+## See Also
 
-- [X3D Specification of FillProperties](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#FillProperties){:target="_blank"}
+- [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,6 +1,6 @@
 ---
 title: LineProperties
-date: 2022-01-07
+date: 2023-01-07
 nav: components-Shape
 categories: [components, Shape]
 tags: [LineProperties, Shape]
@@ -13,9 +13,9 @@ tags: [LineProperties, Shape]
 
 ## Overview
 
-LineProperties allows fine control over rendering of lines and edges for associated geometry nodes inside the same Shape.
+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 since X3D version 3.0 or later.
+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
 
@@ -29,11 +29,15 @@ The LineProperties node belongs to the **Shape** component and its default conta
 
 ### 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.
+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.
+Whether or not LineProperties are *applied* to associated geometry.
 
 ### SFInt32 [in, out] **linetype** 1 <small>[1,∞)</small>
 
@@ -41,23 +45,27 @@ Whether or not LineProperties are applied to associated geometry.
 
 #### Hint
 
-- Detailed descriptions of lineType values are found at the [ISO/IEC International Register of Graphical Items](https://www.iso.org/jtc1/sc24/register){:target="_blank"} (may require login)
+- [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.
 
-## Description
+## Advisories
 
 ### Hints
 
 - DEF/USE copies of a single node can provide a similar "look + feel" style for related shapes in a scene.
-- Include `<component name='Shape' level='2'/>`
+- [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>
 
-## External Links
+## See Also
 
-- [X3D Specification of LineProperties](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#LineProperties){:target="_blank"}
+- [X3D Specification of LineProperties node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/shape.html#LineProperties){:target="_blank"}