Packageorg.goasap.interfaces
Interfacepublic interface IManageable extends IUpdatable

Makes udpatable items usable by IManager instances.

The Go system decouples manager classes so they remain compile- optional for the end user, who must explicitly register an instance of each desired manager for use with GoEngine. To uphold this system it is extremely important that item classes do not import or make direct reference to specific manager classes. If you need to make a reference to a manager from any item class, datatype to manager interfaces like IManager, not manager classes like OverlapMonitor.

See also

IManager

Public Properties
 PropertyDefined by
 InheritedpulseInterval : int
Defines the pulse on which update is called.
IUpdatable
Public Methods
 MethodDefined by
  
getActiveProperties():Array
IManageable requirement.
IManageable
  
getActiveTargets():Array
IManageable requirement.
IManageable
  
isHandling(properties:Array):Boolean
IManageable requirement: Return true if any of the property strings passed in overlap with any properties being actively handled.
IManageable
  
releaseHandling(... params):void
IManageable requirement: Normally this method should stop the instance.
IManageable
 Inherited
update(currentTime:Number):void
Perform updates on a pulse.
IUpdatable
Method detail
getActiveProperties()method
public function getActiveProperties():Array

IManageable requirement.

This list is often passed to the isHandling method of other active IManageable items. DO NOT return all properties the item handles in general, only ones the instance is currently tweening or setting. The list can include any custom property names the item defines.

Returns
Array — All property-strings currently being handled.
getActiveTargets()method 
public function getActiveTargets():Array

IManageable requirement.

Returns
Array — All animation targets currently being handled.
isHandling()method 
public function isHandling(properties:Array):Boolean

IManageable requirement: Return true if any of the property strings passed in overlap with any properties being actively handled.

Direct matching:

First and foremost, test for a direct match with al properties the item is currently handling on all targets. For example, if the item is actively setting a 'width' property on any of its animation targets:

if (properties.indexOf("width")>-1) return true;

Indirect matching:

You must be sure to check for indirect, as well as direct matches. This is very important and can at times require some creative thought on your part. Try to keep isHandling code effiecient to reduce processing and filesize across batches of items.

  1. Overlap, like 'width' and 'scaleX'. These would certainly conflict if two different Go items were allowed to handle them at once on the same target. Overlaps might not always be this obvious, so think creatively.

  2. Multi-property groups. If the item is setting multiple properties at once for a single result, such as a bezier-curve tween that operates on both x and y, and may also define a custom property like 'bezier', be sure to return true if any of those properties are passed in.

  3. Multi-property groups with overlap, in which both of the above occurs. Consider a class with custom 'scale' and 'size' properties that tween scaleX/scaleY and width/height. Overlap occurs between entire groups of properties: scaleX/width/scale/size and scaleY/height/scale/size. You must check whether each property passed in conflicts with this item's active properties using those groupings to check for any indirect match.
Parameters
properties:Array — A list of properties to test for active overlap.

Returns
Boolean — Whether any active overlap occurred with any property passed in.
releaseHandling()method 
public function releaseHandling(... params):void

IManageable requirement: Normally this method should stop the instance.

Parameters
... params — Gives more complex managers leeway to send additional information like specific targets or properties to release, etc.