Titania X3D Editor

It starts with you!

Titania v3.0.4

It starts with you!

X3D Reference

PolylineEmitter

PolylineEmitter

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 container field is emitter. It is available since X3D version 3.2 or later.

Hierarchy

Fields

SFNode [in, out] metadata NULL [X3DMetadataObject]

Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.

SFVec3f [in, out] direction 0 1 0 [-1,1]

Initial direction from which particles emanate.

SFFloat [in, out] speed [0,∞)

Initial linear speed (default is m/s) imparted to all particles along their direction of movement.

SFFloat [in, out] variation 0.25 [0,∞)

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 possible initial values possible.

Hint

Variation of zero does not allow any randomness.

SFFloat [ ] mass [0,∞)

Basic mass of each particle in mass base units (default is grams).

Hint

Mass is needed if gravity or other force-related calculations are performed per-particle.

SFFloat [ ] surfaceArea [0,∞)

Particle surface area in area base units (default is meters squared). Surface area is used for calculations such as wind effects per particle.

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).

MFInt32 [in, out] coordIndex -1 [0,∞) or -1

CoordIndex indices are applied to contained Coordinate values in order to define randomly generated initial geometry of the particles.

Warning

If no coordinates are available, PolylineEmitter acts like a point source located at local origin.

SFNode [in, out] coord NULL [X3DCoordinateNode]

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

Hint

  • If no coordinates are available, PolylineEmitter acts like a point source located at local origin.

Browser Compatibility

Titania X_ITE
yes yes

External Links