Set Emitter Region Icon Set Emitter Region

This action is used to set the region and shape of an emitter within a particle system. You supply the particle system ID that the emitter belongs to (as returned by the action Create Particle System) and then the actual emitter ID (as returned by the action Create Particle Emitter), and then give a shape for the emitter to take within the given bounding box values. The possible emitter shapes are:

Emitter Shapes ExampleTo define your shapes, you give the coordinates for a "bounding box" into which the given shape will be placed (in the case of rectangle, ellipse and diamond shapes) or the first and second coordinates for the start and finish points (in the case of a line). All particles that are burst or streamed from the emitter will be created within the confines of the shape within this bounding box. You can also set the distribution of the particles with the option of:

 

Action Syntax:

Set Emitter Region Action

Arguments:

ArgumentDescription
SystemThe unique ID of the system the emitter belongs to
EmitterThe unique ID of the emitter to set the shape of
ShapeThe particle shape that is to be used
DistributionThe distribution of particles within the given shape
LeftThe position of the left side of the shape bounding box (in pixels)
TopThe position of the top of the shape bounding box (in pixels)
RightThe position of the right side of the shape bounding box (in pixels)
BottomThe position of the bottom of the shape bounding box (in pixels)

 

Example:

Set Emitter Region ExampleThe above action block code will create a particle emitter, set it's region, and then set it to emit a stream of particles.