GPU Particles

Heaps supports rendering particles on the GPU. This allows for an extremely high amount of particles to be rendered on screen with very little performance impact.

Setting up your GPU particles involves first creating a particle system.

  1. //Create a particle system and pass it our 3d scene
  2. var particles = new h3d.parts.GpuParticles(s3d);

From there you add particle groups to the system. Each group is it’s own separate bundle of particles that work independently. A particle system can support multiple groups.

  1. //Create a particle group with a reference to our particle system
  2. var particleGroup = new h3d.parts.GpuParticles.GpuPartGroup(particles);

When you are ready to see your particle group on screen you just need to add it to the system.

  1. particles.addGroup(particleGroup);

Customizing Particles

GPU Particles have a lot of properties that can be modified to give your particles different behavior. See the API docs for a full list.

  1. //The shape at which the particles will be emitted each ar of type GPUEmitMode
  2. particleGroup.emitMode = Cone;
  4. //The angle which the paricles will be emitted
  5. particleGroup.emitAngle = 0.5;
  7. //The distance from the initial spawn location of each particle
  8. particleGroup.emitDist = 0;
  10. //Fade in and fade out time for each particle
  11. particleGroup.fadeIn = 0.8;
  12. particleGroup.fadeOut = 0.8;
  13. particleGroup.fadePower = 10;
  15. //How much the particles are effective by gravity
  16. particleGroup.gravity = 5;
  18. //The initial size of each particle
  19. particleGroup.size = 0.1;
  20. //Random size offset of each particle
  21. particleGroup.sizeRand = 0.5;
  23. //How fast the particles will rotate
  24. particleGroup.rotSpeed = 10;
  26. //The speed of each particle
  27. particleGroup.speed = 2;
  29. //Random variation in speed for each particle
  30. particleGroup.speedRand = 0.5;
  32. //The lifespan of the particle in seconds
  33. particleGroup.life = 2;
  35. //Random variance in lifespan
  36. particleGroup.lifeRand = 0.5;
  38. //The number of particles in a group - these all get uploaded to the GPU
  39. particleGroup.nparts = 10000;
  41. //You can assign a texture to the particle group
  42. //Every particle will have the texture appllied.
  43. particleGroup.texture = hxd.Res.hxlogo.toTexture();
  45. //Use Texture.fromColor to set the color of each particle.
  46. particleGroup.texture = h3d.mat.Texture.fromColor(0xEA8220);

10000 textured particles running on the GPU Haxe Logo particle group

Looping

By default the particle groups will loop. You can disable this with the following

  1. particleGroup.emitLoop = false;

If your particle groups are not set to looping you can listen for a completion event to know when the particle system is done emitting. Note that

  1. particles.onEnd = function(){
  2.     //If none of the groups in this particle system are set to looping
  3.     //this method will fire once the system is done emitting particles
  4. }