Packageorg.flintparticles.twoD.actions
Classpublic class MouseGravity
InheritanceMouseGravity Inheritance ActionBase Inheritance Object
Subclasses MouseAntiGravity

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
[override] Calculates the gravity force on the particle and applies it for the period of time indicated.
MouseGravity
Property Detail
epsilonproperty
epsilon:Number

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

The strength of the gravity force.


Implementation
    public function get power():Number
    public function set power(value:Number):void
rendererproperty 
renderer:DisplayObject

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
override public 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