x_ite 8.8.7 → 8.9.0

package/docs/_posts/components/ParticleSystems/ExplosionEmitter.md

@@ -1,6 +1,6 @@
 ---
 title: ExplosionEmitter
-date: 2022-01-07
+date: 2023-01-07
 nav: components-ParticleSystems
 categories: [components, ParticleSystems]
 tags: [ExplosionEmitter, ParticleSystems]
@@ -15,7 +15,7 @@ tags: [ExplosionEmitter, ParticleSystems]
 
 ExplosionEmitter generates all particles from a specific point in space at the initial time enabled.
 
-The ExplosionEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available since X3D version 3.2 or later.
+The ExplosionEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The ExplosionEmitter node belongs to the **ParticleSystems** component and its d
 
 ### 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] **on** TRUE
 
@@ -41,7 +45,7 @@ Point from which particles emanate.
 
 ### SFFloat [in, out] **speed** 0 <small>[0,∞)</small>
 
-Initial linear speed (default is m/s) imparted to all particles along their direction of movement.
+Initial linear *speed* (default is m/s) imparted to all particles along their direction of movement.
 
 ### SFFloat [in, out] **variation** 0.25 <small>[0,∞)</small>
 
@@ -49,15 +53,17 @@ Multiplier for the randomness used to control the range of possible output value
 
 #### Hint
 
-- Variation of zero does not allow any randomness.
+- *variation* of zero does not allow any randomness.
 
 ### SFFloat [ ] **mass** 0 <small>[0,∞)</small>
 
-Basic mass of each particle in mass base units (default is grams).
+Basic *mass* of each particle, defined in *mass* base units (default is kilograms).
 
-#### Hint
+#### Hints
 
-- Mass is needed if gravity or other force-related calculations are performed per-particle.
+- *mass* is needed if gravity or other force-related calculations are performed on a per-particle basis.
+- [Kilogram](https://en.wikipedia.org/wiki/Kilogram){:target="_blank"}
+- [X3D Architecture 4.3.6 Standard units and coordinate system](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/concepts.html#Standardunitscoordinates){:target="_blank"}
 
 ### SFFloat [ ] **surfaceArea** 0 <small>[0,∞)</small>
 
@@ -65,12 +71,13 @@ Particle surface area in area base units (default is meters squared). Surface ar
 
 #### Hints
 
-- SurfaceArea value represents average frontal area presented to the wind. Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
+- *surfaceArea* value represents average frontal area presented to the wind.
+- Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/ExplosionEmitter/ExplosionEmitter.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ExplosionEmitter](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#ExplosionEmitter){:target="_blank"}
+- [X3D Specification of ExplosionEmitter node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#ExplosionEmitter){:target="_blank"}

package/docs/_posts/components/ParticleSystems/ForcePhysicsModel.md

@@ -1,6 +1,6 @@
 ---
 title: ForcePhysicsModel
-date: 2022-01-07
+date: 2023-01-07
 nav: components-ParticleSystems
 categories: [components, ParticleSystems]
 tags: [ForcePhysicsModel, ParticleSystems]
@@ -15,7 +15,7 @@ tags: [ForcePhysicsModel, ParticleSystems]
 
 ForcePhysicsModel applies a constant force value to the particles.
 
-The ForcePhysicsModel node belongs to the **ParticleSystems** component and its default container field is *physics.* It is available since X3D version 3.2 or later.
+The ForcePhysicsModel node belongs to the **ParticleSystems** component and its default container field is *physics.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The ForcePhysicsModel node belongs to the **ParticleSystems** component and its
 
 ### 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] **enabled** TRUE
 
@@ -37,13 +41,16 @@ Enables/disables node operation.
 
 ### SFVec3f [in, out] **force** 0 -9.8 0 <small>(∞,∞)</small>
 
-Force field indicates strength and direction of the propelling force on the particles (e.g. default is Earth's gravity).
+*force* field indicates strength and direction of the propelling *force* on the particles (for example, default is Earth's gravity).
 
 #### Hints
 
-- Force is specified in force base units (usually newtons). If particles have zero mass, ForcePhysicsModel node has no effect.
+- If particles have zero mass, ForcePhysicsModel node has no effect.
+- *force* is specified in *force* base units (usually newtons, acceleration of one kilogram at rate of one meter per second squared).
+- [Https://en.wikipedia.org/wiki/Newton_(unit) and Kilogram](https://en.wikipedia.org/wiki/Kilogram){:target="_blank"}
+- [X3D Architecture 4.3.6 Standard units and coordinate system](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/concepts.html#Standardunitscoordinates){:target="_blank"}
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -53,6 +60,6 @@ Force field indicates strength and direction of the propelling force on the part
 
 <x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/ForcePhysicsModel/ForcePhysicsModel.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ForcePhysicsModel](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#ForcePhysicsModel){:target="_blank"}
+- [X3D Specification of ForcePhysicsModel node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#ForcePhysicsModel){:target="_blank"}

package/docs/_posts/components/ParticleSystems/ParticleSystem.md

@@ -1,6 +1,6 @@
 ---
 title: ParticleSystem
-date: 2022-01-07
+date: 2023-01-07
 nav: components-ParticleSystems
 categories: [components, ParticleSystems]
 tags: [ParticleSystem, ParticleSystems]
@@ -13,9 +13,9 @@ tags: [ParticleSystem, ParticleSystems]
 
 ## Overview
 
-ParticleSystem specifies a complete particle system. It can contain Appearance for particle appearance, a geometry node if gemoetryType='GEOMETRY', a colorRamp Color/ColorRGBA node for changing base color over each particle's lifetime, a texcoordRamp TextureCoordinate node to control texture coordinates of provided texture(s) in the Appearance node over time, a single emitter X3DParticleEmitterNode, and an array of physics X3DParticlePhysicsModelNode nodes.
+ParticleSystem specifies a complete particle system. It can contain Appearance for particle appearance, a geometry node if geometryType='GEOMETRY', a color field with Color or ColorRGBA node for changing base color over each particle's lifetime, a texcoord TextureCoordinate node to control texture coordinates of provided texture(s) in the Appearance node over time, a single emitter X3DParticleEmitterNode, and an array of physics X3DParticlePhysicsModelNode nodes.
 
-The ParticleSystem node belongs to the **ParticleSystems** component and its default container field is *children.* It is available since X3D version 3.2 or later.
+The ParticleSystem node belongs to the **ParticleSystems** component and its default container field is *children.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -32,7 +32,11 @@ The ParticleSystem node belongs to the **ParticleSystems** component and its def
 
 ### 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] **enabled** TRUE
 
@@ -48,7 +52,22 @@ Enables/disables creation of new particles, while any existing particles remain
 
 ### SFString [ ] **geometryType** "QUAD" <small>["LINE"|"POINT"|"QUAD"|"SPRITE"|"TRIANGLE"|"GEOMETRY"|...]</small>
 
-Field geometryType.
+Specifies type of geometry used to represent individual particles. Typically, a particle is calculated as point in space at which the geometry is placed. Changing the value of the geometry field or the definition of the geometry node shall be applied during current computation of the next frame to be rendered.
+
+#### Hints
+
+- LINE means that a line is drawn along the particle's current velocity vector, for this frame, centered about the particle's position. The length of the line is specified by the particle's height from the particleSize field value.
+- POINT means that a point geometry is rendered at the particle's position.
+- QUAD means that a 2D quad is rendered aligned in the local coordinate space of the particle system with the face normal pointing along the positive Z axis. Individual quads are not aligned to the user's eye position but are affected in depth by the physics model. The particle's position is at the center of the quad.
+- SPRITE means that a point sprite that uses a 2D point position to locate a screen-aligned quad at the center of the particle's location is rendered.
+- TRIANGLE means that a 2D quad is rendered using a pair of triangles aligned in the local coordinate space of the particle system with the face normal pointing along the positive Z axis. Individual triangles are not aligned to the user's eye position, but are affected in depth by the physics model. The particle's position is at the center of the triangle.
+- GEOMETRY means that the geometry specified by the geometry field is rendered for each particle using the local coordinate system.
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
+
+#### Warnings
+
+- Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
 
 ### SFInt32 [in, out] **maxParticles** 200 <small>[0,∞)</small>
 
@@ -56,11 +75,11 @@ Maximum number of particles to be generated at one time (subject to player limit
 
 ### SFFloat [in, out] **particleLifetime** 5 <small>[0,∞)</small>
 
-TODO not properly defined in X3D spedification. Particle animation lifetime in base time units (default is seconds).
+TODO not properly defined in X3D specification. Particle animation lifetime in base time units (default is seconds).
 
 ### SFFloat [in, out] **lifetimeVariation** 0.25 <small>[0,1]</small>
 
-TODO not properly defined in X3D spedification. Multiplier for the randomness used to control the range of possible output values. The bigger the value, the more random the output and the bigger the range of initial values possible.
+TODO not properly defined in X3D specification. Multiplier for the randomness used to control the range of possible output values. The bigger the value, the more random the output and the bigger the range of initial values possible.
 
 #### Hint
 
@@ -72,55 +91,56 @@ TODO not properly defined in X3D spedification. Multiplier for the randomness us
 
 #### Hints
 
-- Particles created before this timestamp will remain at the old size. His field only effects particles using LINE, QUAD, SPRITE, and TRIANGLE geometry types.
+- Particles created before this timestamp will remain at the old size.
+- His field only effects particles using LINE, QUAD, SPRITE, and TRIANGLE geometry types.
 
 ### SFNode [ ] **emitter** NULL <small>[X3DParticleEmitterNode]</small>
 
-The emitter field specifies the type of emitter geometry and properties that the particles are given for their initial positions.
+The *emitter* field specifies the type of *emitter* geometry and properties that the particles are given for their initial positions.
 
 ### MFNode [ ] **physics** [ ] <small>[X3DParticlePhysicsModelNode]</small>
 
-After being created, the individual particles are then manipulated according to the physics model(s) specified in the physics field.
+After being created, the individual particles are then manipulated according to the *physics* model(s) specified in the *physics* field.
 
 ### MFFloat [ ] **colorKey** [ ] <small>[0,∞)</small>
 
-Array of time intervals in seconds, corresponding to particle lifetime, that are used to interpolate colorRamp array values.
+Array of time intervals in seconds, corresponding to particle lifetime, that are used to interpolate color array values.
 
 #### Hints
 
-- Color values are interpolated in linear Hue Saturation Value (HSV) space, similar to ColorInterpolator node. Color values are defined as per-vertex colour values. Number of colorKey values must match length of the per-vertex colorRamp arrays!
+- Color values are interpolated in linear Hue Saturation Value (HSV) space, similar to ColorInterpolator node.
+- Color values are defined as per-vertex color values.
+- Number of *colorKey* values must match length of the per-vertex color field array values!
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
 #### Warning
 
-- If an Appearance and Material nodes are provided, those material properties override colorRamp interpolation.
-
-#### See Also
-
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+- If an Appearance and Material nodes are provided, those material properties override color field interpolation.
 
 ### SFNode [ ] **color** NULL <small>[X3DColorNode]</small>
 
-The colorRamp Color/ColorRGBA node holds a series of colour values to be used at the given colorKey points in time.
+The *color* field contains Color or ColorRGBA nodes as a series of *color* values to be used at the given colorKey points in time.
 
 #### Hints
 
-- Color values are defined as per-vertex colour values. Number of colorKey values must match length of the per-vertex colorRamp arrays!
-
-#### Warning
-
-- If an Appearance and Material nodes are provided, those material properties override colorRamp interpolation.
+- *color* values are defined as per-vertex *color* values.
+- Number of colorKey values must match length of the per-vertex *color* field array values!
+- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
 
-#### See Also
+#### Warnings
 
-- [X3D Scene Authoring Hints, Color](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#Color){:target="_blank"}
+- [Field originally named 'colorRamp' in X3Dv3.](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#fieldNameChanges){:target="_blank"}
+- If an Appearance and Material nodes are provided, those material properties override *color* field interpolation.
 
 ### MFFloat [ ] **texCoordKey** [ ] <small>[0,∞)</small>
 
-Array of time intervals in seconds, corresponding to particle lifetime, that are used to sequence texCoordRamp array values.
+Array of time intervals in seconds, corresponding to particle lifetime, that are used to sequence texCoord array values.
 
 #### Hints
 
-- No interpolation is performed, texture coordinates are simply sequenced in order. Texture-coordinate values map textures to vertices in the geometry. Number of texCoordKey values must match length of the per-vertex texCoordRamp arrays!
+- No interpolation is performed, texture coordinates are simply sequenced in order.
+- Texture-coordinate values map textures to vertices in the geometry.
+- Number of *texCoordKey* values must match length of the per-vertex texCoord arrays!
 
 ### SFNode [ ] **texCoord** NULL <small>[TextureCoordinate]</small>
 
@@ -128,28 +148,37 @@ Texture coordinates of the provided texture(s) in the Appearance node, over time
 
 #### Hints
 
-- Texture-coordinate values map textures to vertices in the geometry. Number of texCoordKey values must match length of the per-vertex texCoordRamp arrays!
+- Texture-coordinate values map textures to vertices in the geometry.
+- Number of texCoordKey values must match length of the per-vertex *texCoord* arrays!
+
+#### Warning
+
+- [Field originally named 'texCoordRamp' in X3Dv3.](https://www.web3d.org/x3d/content/examples/X3dSceneAuthoringHints.html#fieldNameChanges){:target="_blank"}
 
 ### SFBool [out] **isActive**
 
 *isActive* true/false events are sent when playback starts/stops.
 
+#### Warning
+
+- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
+
 ### SFBool [in, out] **visible** TRUE
 
 Whether or not renderable content within this node is visually displayed.
 
-#### Hint
+#### Hints
 
-- The visible field has no effect on animation behaviors, event passing or other non-visual characteristics.
-- Content must be visible to be collidable and to be pickable.
+- The *visible* field has no effect on animation behaviors, event passing or other non-visual characteristics.
+- Content must be *visible* to be collidable and to be pickable.
 
 ### SFBool [in, out] **castShadow** TRUE
 
-*castShadow* defines whether this Shape casts shadows as produced by lighting nodes.
+The *castShadow* field defines whether this Shape casts shadows as produced by lighting nodes.
 
-#### Hint
+#### Hints
 
-- If the visible field is FALSE, then the Shape does not cast any shadows.
+- If the visible field is FALSE, then the Shape does not cast any shadows, regardless of the *castShadow* value.
 - If prior X3D3 content is loaded into an X3D4 model, then legacy Shape nodes have shadows set to true.
 
 ### SFBool [in, out] **bboxDisplay** FALSE
@@ -164,40 +193,57 @@ Whether to display bounding box for associated geometry, aligned with world coor
 
 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
+#### Hints
 
 - Can be useful for collision computations or inverse-kinematics (IK) engines.
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFVec3f [ ] **bboxCenter** 0 0 0 <small>(-∞,∞)</small>
 
-Bounding box center: optional hint for position offset from origin of local coordinate system.
+Bounding box center accompanies bboxSize and provides an optional hint for bounding box position offset from origin of local coordinate system.
+
+#### Hints
+
+- Precomputation and inclusion of bounding box information can speed up the initialization of large detailed models, with a corresponding cost of increased file size.
+- [X3D Architecture, 10.2.2 Bounding boxes](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#BoundingBoxes){:target="_blank"}
+- [X3D Architecture, 10.3.1 X3DBoundedObject](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/components/grouping.html#X3DBoundedObject){:target="_blank"}
 
 ### SFNode [in, out] **appearance** NULL <small>[X3DAppearanceNode]</small>
 
-The appearance field holds an Appearance node that is used for the geometry. All effects, such as material colours and/or multi-textures, are applied to each particle.
+The *appearance* field holds an Appearance node that is used for the geometry. All effects, such as material colors and/or multi-textures, are applied to each particle.
 
 #### Hints
 
-- If a texture coordinate ramp and key is supplied with this geometry, it shall be used in preference to any automatic texture coordinate generation. If automatic texture coordinate generation is used, results shall be based on the entire volume that the particles consume, not locally applied to each particle.
+- If a texture coordinate ramp and key is supplied with this geometry, it shall be used in preference to any automatic texture coordinate generation.
+- If automatic texture coordinate generation is used, results shall be based on the entire volume that the particles consume, not locally applied to each particle.
 
 ### SFNode [in, out] **geometry** NULL <small>[X3DGeometryNode]</small>
 
-The geometry node provides geometry used for each particle when geometryType=GEOMETRY.
+Single contained *geometry* node provides *geometry* used for each particle when geometryType=GEOMETRY.
 
 #### Hint
 
-- Include `<component name='Geospatial' level='1'/>`
+- [X3D for Advanced Modeling (X3D4AM) slideset](https://x3dgraphics.com/slidesets/X3dForAdvancedModeling/GeospatialComponentX3dEarth.pdf){:target="_blank"}
+
+#### Warning
+
+- Requires X3D `profile='Full'` or else include `<component name='Geospatial' level='1'/>`
 
-## Hints
+## Advisories
 
-- Always adjust bboxSize and boxCenter properly; bboxSize and bboxCenter cannot be automatically determined so it's up to the author to provide proper values.
+- Always set bboxSize and boxCenter correctly; bboxSize and bboxCenter cannot be determined automatically, so it's up to the author to provide the correct values.
+
+### Hints
+
+- [Event timing details are explained in X3D Specification 4.4.8.3 Execution model](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/concepts.html#ExecutionModel){:target="_blank"}
+- [Wikipedia, particle system](https://en.wikipedia.org/wiki/Particle_system){:target="_blank"}
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/ParticleSystem/ParticleSystem.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of ParticleSystem](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#ParticleSystem){:target="_blank"}
-- [Event timing details are explained in 4.4.8.3 Execution model](https://www.web3d.org/files/specifications/19775-1/V3.3/Part01/concepts.html#ExecutionModel){:target="_blank"}
-- [Wikipedia, particle system](https://en.wikipedia.org/wiki/Particle_system){:target="_blank"}
+- [X3D Specification of ParticleSystem node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#ParticleSystem){:target="_blank"}

package/docs/_posts/components/ParticleSystems/PointEmitter.md

@@ -1,6 +1,6 @@
 ---
 title: PointEmitter
-date: 2022-01-07
+date: 2023-01-07
 nav: components-ParticleSystems
 categories: [components, ParticleSystems]
 tags: [PointEmitter, ParticleSystems]
@@ -15,7 +15,7 @@ tags: [PointEmitter, ParticleSystems]
 
 PointEmitter generates particles from a specific point in space using the specified direction and speed.
 
-The PointEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available since X3D version 3.2 or later.
+The PointEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The PointEmitter node belongs to the **ParticleSystems** component and its defau
 
 ### 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] **on** TRUE
 
@@ -41,11 +45,11 @@ Point from which particles emanate.
 
 ### SFVec3f [in, out] **direction** 0 1 0 <small>(-∞,∞)</small>
 
-Initial direction from which particles emanate.
+Initial *direction* from which particles emanate.
 
 ### SFFloat [in, out] **speed** 0 <small>[0,∞)</small>
 
-Initial linear speed (default is m/s) imparted to all particles along their direction of movement.
+Initial linear *speed* (default is m/s) imparted to all particles along their direction of movement.
 
 ### SFFloat [in, out] **variation** 0.25 <small>[0,∞)</small>
 
@@ -53,15 +57,17 @@ Multiplier for the randomness used to control the range of possible output value
 
 #### Hint
 
-- Variation of zero does not allow any randomness.
+- *variation* of zero does not allow any randomness.
 
 ### SFFloat [ ] **mass** 0 <small>[0,∞)</small>
 
-Basic mass of each particle in mass base units (default is grams).
+Basic *mass* of each particle, defined in *mass* base units (default is kilograms).
 
-#### Hint
+#### Hints
 
-- Mass is needed if gravity or other force-related calculations are performed per-particle.
+- *mass* is needed if gravity or other force-related calculations are performed on a per-particle basis.
+- [Kilogram](https://en.wikipedia.org/wiki/Kilogram){:target="_blank"}
+- [X3D Architecture 4.3.6 Standard units and coordinate system](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/concepts.html#Standardunitscoordinates){:target="_blank"}
 
 ### SFFloat [ ] **surfaceArea** 0 <small>[0,∞)</small>
 
@@ -69,12 +75,13 @@ Particle surface area in area base units (default is meters squared). Surface ar
 
 #### Hints
 
-- SurfaceArea value represents average frontal area presented to the wind. Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
+- *surfaceArea* value represents average frontal area presented to the wind.
+- Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
 
 ## Example
 
 <x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/PointEmitter/PointEmitter.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of PointEmitter](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#PointEmitter){:target="_blank"}
+- [X3D Specification of PointEmitter node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#PointEmitter){:target="_blank"}

package/docs/_posts/components/ParticleSystems/PolylineEmitter.md

@@ -1,6 +1,6 @@
 ---
 title: PolylineEmitter
-date: 2022-01-07
+date: 2023-01-07
 nav: components-ParticleSystems
 categories: [components, ParticleSystems]
 tags: [PolylineEmitter, ParticleSystems]
@@ -15,7 +15,7 @@ tags: [PolylineEmitter, ParticleSystems]
 
 PolylineEmitter emits particles along a single polyline. The coordinates for the line along which particles should be randomly generated are taken from a combination of the coord and coordIndex fields. The starting point for generating particles is randomly distributed along this line and given the initial speed and direction.
 
-The PolylineEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available since X3D version 3.2 or later.
+The PolylineEmitter node belongs to the **ParticleSystems** component and its default container field is *emitter.* It is available from X3D version 3.2 or higher.
 
 ## Hierarchy
 
@@ -29,7 +29,11 @@ The PolylineEmitter node belongs to the **ParticleSystems** component and its de
 
 ### 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] **on** TRUE
 
@@ -37,11 +41,11 @@ Enables/disables production of particles from this emitter node. If operating wh
 
 ### SFVec3f [in, out] **direction** 0 1 0 <small>(-∞,∞)</small>
 
-Initial direction from which particles emanate.
+Initial *direction* from which particles emanate.
 
 ### SFFloat [in, out] **speed** 0 <small>[0,∞)</small>
 
-Initial linear speed (default is m/s) imparted to all particles along their direction of movement.
+Initial linear *speed* (default is m/s) imparted to all particles along their direction of movement.
 
 ### SFFloat [in, out] **variation** 0.25 <small>[0,∞)</small>
 
@@ -49,15 +53,17 @@ Multiplier for the randomness used to control the range of possible output value
 
 #### Hint
 
-- Variation of zero does not allow any randomness.
+- *variation* of zero does not allow any randomness.
 
 ### SFFloat [ ] **mass** 0 <small>[0,∞)</small>
 
-Basic mass of each particle in mass base units (default is grams).
+Basic *mass* of each particle, defined in *mass* base units (default is kilograms).
 
-#### Hint
+#### Hints
 
-- Mass is needed if gravity or other force-related calculations are performed per-particle.
+- *mass* is needed if gravity or other force-related calculations are performed on a per-particle basis.
+- [Kilogram](https://en.wikipedia.org/wiki/Kilogram){:target="_blank"}
+- [X3D Architecture 4.3.6 Standard units and coordinate system](https://www.web3d.org/specifications/X3Dv4Draft/ISO-IEC19775-1v4-CD1/Part01/concepts.html#Standardunitscoordinates){:target="_blank"}
 
 ### SFFloat [ ] **surfaceArea** 0 <small>[0,∞)</small>
 
@@ -65,25 +71,27 @@ Particle surface area in area base units (default is meters squared). Surface ar
 
 #### Hints
 
-- SurfaceArea value represents average frontal area presented to the wind. Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
+- *surfaceArea* value represents average frontal area presented to the wind.
+- Assumes spherical model for each particle (i.e., surface area is the same regardless of direction).
 
 ### MFInt32 [in, out] **coordIndex** -1 <small>[0,∞) or -1</small>
 
 *coordIndex* indices are applied to contained Coordinate values in order to define randomly generated initial geometry of the particles.
 
-#### Warning
+#### Warnings
 
 - If no coordinates are available, PolylineEmitter acts like a point source located at local origin.
+- *coordIndex* is required in order to connect contained coordinate point values.
 
 ### SFNode [in, out] **coord** NULL <small>[X3DCoordinateNode]</small>
 
-*coord*inates for the line along which particles are randomly generated.
+Coordinates for the line along which particles are randomly generated.
 
 #### Warning
 
 - If no coordinates are available, PolylineEmitter acts like a point source located at local origin.
 
-## Description
+## Advisories
 
 ### Hint
 
@@ -93,6 +101,6 @@ Particle surface area in area base units (default is meters squared). Surface ar
 
 <x3d-canvas src="https://create3000.github.io/media/examples/ParticleSystems/PolylineEmitter/PolylineEmitter.x3d" update="auto"></x3d-canvas>
 
-## External Links
+## See Also
 
-- [X3D Specification of PolylineEmitter](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#PolylineEmitter){:target="_blank"}
+- [X3D Specification of PolylineEmitter node](https://www.web3d.org/documents/specifications/19775-1/V4.0/Part01/components/particleSystems.html#PolylineEmitter){:target="_blank"}