Particle Systems have the ability to trigger a Callback whenever they interact with one or more Colliders in the Scene. The Callback can be triggered when a particle enters or exits a Collider, or during the time that a particle is inside or outside of the Collider.
You can use the Callback as a simple way to destroy a particle when it enters the Collider (for example, to prevent raindrops from penetrating a rooftop), or it can be used to modify any or all particles’ properties.
The Triggers module also offers the Kill option to remove particles automatically, and the Ignore option to ignore collision events, shown below.
To use the module, first add the Colliders you wish to create triggers for, then select which events to use.
You can elect to trigger an event whenever the particle is:
Property: | Function: |
---|---|
Inside | Select Callback if you want the event to trigger when the particle is inside the Collider. Select Ignore for the event not to trigger when the particle is inside the Collider. Select Kill to destroy particles inside the Collider. |
Outside | Select Callback if you want the event to trigger when the particle is outside the Collider. Select Ignore for the event not to trigger when the particle is outside the Collider. Select Kill to destroy particles outside the Collider. |
Enter | Select Callback if you want the event to trigger when the particle enters the Collider. Select Ignore for the event not to trigger when the particle enters the Collider. Select Kill to destroy particles when they enter the Collider. |
Exit | Select Callback if you want the event to trigger when the particle exits the Collider. Select Ignore for the event not to trigger when the particle exits the Collider. Select Kill to destroy particles when they exit the Collider. |
Radius Scale | This parameter sets the particle’s Collider bounds, allowing an event to appear to happen before or after the particle touches the Collider. For example, you may want a particle to appear to penetrate a Collider object’s surface a little before bouncing off, in which case you would set the Radius Scale to be a little less than 1. Note that this setting does not change when the event actually triggers, but can delay or advance the visual effect of the trigger. - Enter 1 for the event to appear to happen as a Particle touches the Collider - Enter a value less than 1 for the trigger to appear to happen after a Particle penetrates the Collider - Enter a value greater than 1 for the trigger to appear to happen after a Particle penetrates the Collider |
Visualize Bounds | This allows you to display the Particle’s Collider bounds in the Editor window. |
Inside the Callback, use ParticlePhysicsExtensions.GetTriggerParticles() (along with the ParticleSystemTriggerEventType you want to specify) to determine which particles meet which criteria.
The example below causes particles to turn red as they enter the Collider, then turn green as they leave the Collider’s bounds.
using UnityEngine;
using System.Collections;
using System.Collections.Generic;
[ExecuteInEditMode]
public class TriggerScript : MonoBehaviour
{
ParticleSystem ps;
// these lists are used to contain the particles which match
// the trigger conditions each frame.
List<ParticleSystem.Particle> enter = new List<ParticleSystem.Particle>();
List<ParticleSystem.Particle> exit = new List<ParticleSystem.Particle>();
void OnEnable()
{
ps = GetComponent<ParticleSystem>();
}
void OnParticleTrigger()
{
// get the particles which matched the trigger conditions this frame
int numEnter = ps.GetTriggerParticles(ParticleSystemTriggerEventType.Enter, enter);
int numExit = ps.GetTriggerParticles(ParticleSystemTriggerEventType.Exit, exit);
// iterate through the particles which entered the trigger and make them red
for (int i = 0; i < numEnter; i++)
{
ParticleSystem.Particle p = enter[i];
p.startColor = new Color32(255, 0, 0, 255);
enter[i] = p;
}
// iterate through the particles which exited the trigger and make them green
for (int i = 0; i < numExit; i++)
{
ParticleSystem.Particle p = exit[i];
p.startColor = new Color32(0, 255, 0, 255);
exit[i] = p;
}
// re-assign the modified particles back into the particle system
ps.SetTriggerParticles(ParticleSystemTriggerEventType.Enter, enter);
ps.SetTriggerParticles(ParticleSystemTriggerEventType.Exit, exit);
}
}
The result of this is demonstrated in the images below:
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at issuetracker.unity3d.com.
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thanks for helping to make the Unity documentation better!