Advanced Particle Grabber

This tool is used to grab some particles of the simulation mesh of an Actor. Unlike the Simple Particle Grabber, this tool allows you to grab particles using joints. This allows for more flexibility and control over the grabbed particles, by specifying break forces, and more. A guide on how to setup and use the Advanced Particle Grabber tool is provided below:

  1. Add the Advanced Particle Grabber component on a GameObject.

    To add the Advanced Particle Grabber component, click on Add Component > MAGES > Mesh Deformations > Tools > Advanced Particle Grabber.

  2. Assign the PhysicsWorld that you want to use in the inspector of the Advanced Particle Grabber component.

    Drag and drop the PhysicsWorld in the Physics World field:

    ../../../_images/AdvancedParticleGrabberInspector.PNG

  3. Adjust the Grab Radius.

    Adjust the Grab Radius so that the sphere displayed on the scene best matches the tool shape.

  4. Adjust other properties as needed.

    You may adjust the Grab Layer to specify which particles the tool can grab. You may also adjust the Break Force property to control the maximum force acted on the grabbed particles before they are released.

You have now successfully setup the Advanced Particle Grabber tool. In the section is a guide on how to use it.

How to Use?

When you want to grab some particles you can call void Grab() public function of the AdvancedParticleGrabber component. If you want to release the particles grabbed, you can call void Release() public function of the AdvancedParticleGrabber component.

Note

  • You can observe specific actors, and raise an event when they are grabbed or released using the ObserverParticles list in the inspector.

  • Additionally, you can specify the particles the tool can grab by setting the GrabLayer to the Layer of the particle group you want to grab.