mParticles InterCollision Test

The mParticles InterCollision test registers interparticle collision and redirects particles to other events based on the collision information. It does not control whether particles collide with each other. By definition, particles whose shape is defined with an mParticles Shape operator, and that participate in a MassFX simulation, can collide with each other.

Adding an mParticles InterCollision test to an event is roughly equivalent to turning on Test True If Particle in the mParticles Collision test—the plug-in starts collecting information about collisions. As with mParticles Collision, the job of collecting this information takes a toll on CPU resources, so if you don't need to redirect particles to other events based on collisions, you don't need to use this test.

For further information about how this test works, see mParticles InterCollision Test in Depth.

Interface

Particles In Current Event
When this first option is set to Particles In Current Event, the test checks for collisions in the event in which the mParticles InterCollision test resides. In some cases, particles in the current event might collide with nearby particles after the latter have already moved on to another event; if this option is active, such collisions would not register.
Particles In Events:
The test checks for collisions in all highlighted events in the list (the list always contains all events in the flow). To check for collisions between particles in the current event and other events, highlight the events to check. mParticles InterCollision does not check for collisions between particles in other events only.

For example, you might have a large grid of particles that fall onto an object due to gravity; most of those will collide with one or more neighboring particles at some point in the first event (Event 01); using the Collides option, each colliding particle moves on immediately to the next event. But a few might not collide until all of their neighbors move on to the next event (Event 02). If you choose Particles In Events and highlight both events, mParticles Intercollision will continue to test for collisions and the remaining particles will eventually pass the test and move to Event 02.

For a video showing the effects of the Particles In Current Event and Particles In Events options, see mP InterCollision Test Videos.

[event list]
Lists all events in the flow. When using the Particles In Events option, highlight list members to check for collisions between particles in the current event and the highlighted events.
All/None/Invert
All highlights all events in the list; None removes highlighting from all events in the list; Invert removes highlighting from highlighted events and highlights the rest.

Test True If Particle group

The Collides, Is Slow After Collision(s), Is Fast After Collision(s), and Collided Multiple Times options and controls are similar to those in the standard Collision test, with a few differences:

Report To Data Operator
When using the advanced data manipulation tools, enable this option if you need the number-of-collisions data to be used by a Data operator. You can use the Input mParticles sub-operator to retrieve these data in a Data operator.

Available when Test True If Particle is on. Typically you'd use this when the test is not wired to any following event.

Additive Count
When on, the reported data represent the total number of collisions a particle had while present in the current event. When off, the test reports only the number of collisions a particle experienced during the last integration step.

Available only when Report To Data Operator is on.