Packageorg.flintparticles.twoD.actions
Classpublic class MouseGravity
InheritanceMouseGravity Inheritance ActionBase
SubclassesMouseAntiGravity

The MouseGravity action applies a force on the particle to draw it towards the mouse. The force applied is inversely proportional to the square of the distance from the particle to the mouse, in accordance with Newton's law of gravity.



Public Properties
 PropertyDefined by
  epsilon : Number
The minimum distance for which the gravity force is calculated.
MouseGravity
  power : Number
The strength of the gravity force.
MouseGravity
 Inheritedpriority : int
Returns a default priority of 0 for this action.
ActionBase
  renderer : DisplayObject
The display object whose coordinate system the mouse position is converted to.
MouseGravity
Protected Properties
 PropertyDefined by
 Inherited_priority : int = 0
ActionBase
Public Methods
 MethodDefined by
  
MouseGravity(power:Number = 0, renderer:DisplayObject = null, epsilon:Number = 100)
The constructor creates a MouseGravity action for use by an emitter.
MouseGravity
 Inherited
addedToEmitter(emitter:Emitter):void
This method does nothing.
ActionBase
 Inherited
This method does nothing.
ActionBase
  
update(emitter:Emitter, particle:Particle, time:Number):void
Calculates the gravity force on the particle and applies it for the period of time indicated.
MouseGravity
Property detail
epsilonproperty
epsilon:Number  [read-write]

The minimum distance for which the gravity force is calculated. Particles closer than this distance experience the gravity as it they were this distance away. This stops the gravity effect blowing up as distances get small.

Implementation
    public function get epsilon():Number
    public function set epsilon(value:Number):void
powerproperty 
power:Number  [read-write]

The strength of the gravity force.

Implementation
    public function get power():Number
    public function set power(value:Number):void
rendererproperty 
renderer:DisplayObject  [read-write]

The display object whose coordinate system the mouse position is converted to. This is usually the renderer for the particle system created by the emitter.

Implementation
    public function get renderer():DisplayObject
    public function set renderer(value:DisplayObject):void
Constructor detail
MouseGravity()constructor
public function MouseGravity(power:Number = 0, renderer:DisplayObject = null, epsilon:Number = 100)

The constructor creates a MouseGravity action for use by an emitter. To add a MouseGravity to all particles created by an emitter, use the emitter's addAction method.

Parameters
power:Number (default = 0) — The strength of the gravity force - larger numbers produce a stronger force.
 
renderer:DisplayObject (default = null) — The display object whose coordinate system the mouse position is converted to. This is usually the renderer for the particle system created by the emitter.
 
epsilon:Number (default = 100) — The minimum distance for which gravity is calculated. Particles closer than this distance experience a gravity force as if they were this distance away. This stops the gravity effect blowing up as distances get small. For realistic gravity effects you will want a small epsilon ( ~1 ), but for stable visual effects a larger epsilon (~100) is often better.

See also

Method detail
update()method
public override function update(emitter:Emitter, particle:Particle, time:Number):void

Calculates the gravity force on the particle and applies it for the period of time indicated.

This method is called by the emitter and need not be called by the user.

Parameters
emitter:Emitter — The Emitter that created the particle.
 
particle:Particle — The particle to be updated.
 
time:Number — The duration of the frame - used for time based updates.

See also