Name

Name of the event property. By default, this is called Particle_Event but you can/really should rename it.

Mute

Temporarily deactivates the event.

Trigger

The condition at which the event happen (triggers the Action that you set): Particle Age %, Particle Age, Every N Particle, Every N Frame, XYZ Position, XYZ Speed, Speed, Collision, Interparticle Collision, and Interparticle Avoidance.

When you set an object as an obstacle for particles, an event is automatically created with Collision set as the trigger.

For information on the Var parameter, see Particle Variance and Seed Parameters for more information.

Value

Value at which the event happens. An event will only do something if the value of the parameter used as a trigger reaches the this Value. For example, if you set this to 50% with Age as the trigger, the specified action happens every time a particle reaches 50% of its age (Max Lifetime value).

Action

The action that happens when the trigger Value is reached. You can make particles Emit (another particle), Disappear, Emit & Disappear, Bounce, Bounce & Emit, Stick, or run a Script.

- If you select Emit, Bounce & Emit, or Emit & Disappear, you must create or select the particle type to be emitted. You do this by defining the Source, below.

- If you select Bounce or Stick, you must define an Obstacle, below.

- If you select Script, you must select a predefined script or write one on the Script page.

Emission

Name of the particle type to be emitted.

Create

Creates a new particle type to be emitted. You must define its emission properties on the Event Emission page (see Event Emissions) that appears.

Del

Removes the currently emitted particle type from the event.

Edit

Opens the PType (Particle Type) Property Editor so that you can edit its properties.

Obstacle

Name of the obstacle used for the collision.

Pick

Initiates a picking session in which you can pick the obstacle object to use in the collision.

Del

Removes the current obstacle from the event.

Edit

Opens the Obstacle Property Editor in which you can edit its properties.

Use Script File

Activates a predefined script that you must select.

Language

Select either VBScript or Jscript as the language for the script.

File

File name of the script you want to use. Click the browser button (...) to search for the script.

Proc(edure)

Subroutine name that calls the script file. The subroutine must have these three parameters in this order:

• Parameter 1- the particle cloud primitive that triggered the event.

• Parameter 2- An array containing the indices of the particles that triggered the event.

• Parameter 3- The current simulation frame.

Script Context

Activates the script in these contexts: Per Trigger Particle (every particle at which the event is triggered), Per Particle (every particle), Per Cloud (for the whole simulation).

Text Box

If you don’t use a predefined script, you can write a script directly in this box. The Script Context defines how the script is called:

• Per trigger particle: the script is called once for each particle that triggers the event. In this context, you can use these variables:

- inParticle: One particle that triggered the event.

- inTriggerParticleCnt: The index of the particle within the array of particles that triggered the event.

• Per particle: The script is called once for every particle in the cloud, whether it triggered the event or not. In this context, you can use these variables:

- inParticle: One particle in the cloud

- inParticleCnt: The index of the particle within the cloud

• Per cloud: This script is called once for the cloud. No extra variables are accessible here.

In all three contexts, the following variables are available:

• inParticleCloud : the cloud primitive

• inTriggerParticleIndices: the array of indices of the particles that triggered the event (whatever the context)

• inSimFrame: The current simulation frame when the event occured

• inParticleCollection: The particle collection object

Uniform

Numbers are distributed uniformly around the parameter’s value using the Variance value. The parameter will always be in the range [value - variance; value + variance], never outside of it.

Gaussian

Numbers are distributed as a Gaussian bell curve around the parameter’s value using the Variance value. Most numbers will be in the range [value - variance; value + variance], but they may be outside of that range with [value - variance], and they will be outside of that range with [value + variance].

Rate

The number of particles emitted at event time. Note that this is different from Rate for regular emissions, which is the number of particles emitted per second.

Azimuth

Determines the azimuth vector along which the emitted particle type is generated. Range is 0 to 180 degrees.

Declination

Determines the degree of declination of the vector along which the emitted particle is propelled. Range is 0 to 180 degrees.

Radius

Offsets the emitted particle type in a radius around the original particle type. Values are in Softimage units.