[ < ] | [ Up ] | [ > ] |  |  |  |  |  |  |  | [Top] | [Contents] | [Index] | [ ? ]

### 3.2.4 Standard Particle Emitters

Ogre comes preconfigured with a few particle emitters. New ones can be added by creating plugins: see the Plugin_ParticleFX project as an example of how you would do this (this is where these emitters are implemented).

- Point Emitter
- Box Emitter
- Cylinder Emitter
- Ellipsoid Emitter
- Hollow Ellipsoid Emitter
- Ring Emitter

### Point Emitter

This emitter emits particles from a single point, which is it's position. This emitter has no additional attributes over an above the standard emitter attributes.

To create a point emitter, include a section like this within your particle system script:

    emitter Point
    {
        // Settings go here
    }

Please note that the name of the emitter ('Point') is case-sensitive.

### Box Emitter

This emitter emits particles from a random location within a 3-dimensional box. It's extra attributes are:

width
  Sets the width of the box (this is the size of the box along it's local X axis, which is dependent on the 'direction' attribute which forms the box's local Z).
  format: width <units>
  example: width 250
  default: 100
height
  Sets the height of the box (this is the size of the box along it's local Y axis, which is dependent on the 'direction' attribute which forms the box's local Z).
  format: height <units>
  example: height 250
  default: 100
depth
  Sets the depth of the box (this is the size of the box along it's local Z axis, which is the same as the 'direction' attribute).
  format: depth <units>
  example: depth 250
  default: 100

To create a box emitter, include a section like this within your particle system script:

    emitter Box
    {
        // Settings go here
    }

### Cylinder Emitter

This emitter emits particles in a random direction from within a cylinder area, where the cylinder is oriented along the Z-axis. This emitter has exactly the same parameters as the Box Emitter so there are no additional parameters to consider here - the width and height determine the shape of the cylinder along it's axis (if they are different it is an ellipsoid cylinder), the depth determines the length of the cylinder.

### Ellipsoid Emitter

This emitter emits particles from within an ellipsoid shaped area, ie a sphere or squashed-sphere area. The parameters are again identical to the Box Emitter, except that the dimensions describe the widest points along each of the axes.

### Hollow Ellipsoid Emitter

This emitter is just like Ellipsoid Emitter except that there is a hollow area in the centre of the ellipsoid from which no particles are emitted. Therefore it has 3 extra parameters in order to define this area:

inner_width
  The width of the inner area which does not emit any particles.
inner_height
  The height of the inner area which does not emit any particles.
inner_depth
  The depth of the inner area which does not emit any particles.

### Ring Emitter

This emitter emits particles from a ring-shaped area, ie a little like Hollow Ellipsoid Emitter except only in 2 dimensions.

inner_width
  The width of the inner area which does not emit any particles.
inner_height
  The height of the inner area which does not emit any particles.

See also: 3.2 Particle Scripts, 3.2.2 Particle Emitters

[ < ] | [ Up ] | [ > ] |  |  |  |  |  |  |  | [Top] | [Contents] | [Index] | [ ? ]

This document was generated by Steve Streeting on , 28 2004 using texi2html