Packagecom.gestureworks.core
Classpublic class VirtualTouchObject
InheritanceVirtualTouchObject Inheritance flash.display.Sprite

The VirtualTouchObject class allows you to apply manipulations and transformations to an object that doesn't extend TouchSprite or TouchMovieClip. Pass to the constructor, the target that you ultimately want to be transformed. The class will attempt to adapt the display object's current transform matrix. If native transformations are enabled (disableNativeTransform="false"), then it will attempt to automatically apply the updated transforms. If using gestureEvents, simply apply the return values to the object that you want to transform, instead of the VirtualTouchObject itself.

If your target class doesn't support the AS3 tranform class, then you should extend this class and add in the neccesary hooks, generally converting the AS3 transform return values to the required format.



Public Properties
 PropertyDefined By
  _$height : Number = 0
VirtualTouchObject
  _$rotation : Number = 0
VirtualTouchObject
  $rotation : Number
VirtualTouchObject
  _$scaleX : Number = 1
VirtualTouchObject
  $scaleX : Number
VirtualTouchObject
  _$scaleY : Number = 1
VirtualTouchObject
  $scaleY : Number
VirtualTouchObject
  $transformPoint : Point
VirtualTouchObject
  _$width : Number = 0
VirtualTouchObject
  _$x : Number = 0
VirtualTouchObject
  $x : Number
VirtualTouchObject
  _$y : Number = 0
VirtualTouchObject
  $y : Number
VirtualTouchObject
  broadcastTarget : Boolean
VirtualTouchObject
  clusterBubbling : Boolean
Allows touch points from a childclusters to copy into container touch objects in the local parent child display list stack.
VirtualTouchObject
  clusterEvents : Boolean
Determins whether clusterEvents are processed and dispatched on the touchSprite.
VirtualTouchObject
  clusterID : int
VirtualTouchObject
  cO : ClusterObject
VirtualTouchObject
  debugDisplay : Boolean
VirtualTouchObject
  deltaFilterOn : Boolean
Determins whether filtering is applied to the delta values.
VirtualTouchObject
  disableAffineTransform : Boolean
Determins whether internal (native) transformations are affine (dynamically centered) on the touchSprite.
VirtualTouchObject
  disableNativeTransform : Boolean
Determins whether transformations are handled internally (natively) on the touchSprite.
VirtualTouchObject
  dN : Number
VirtualTouchObject
  GESTRELIST_UPDATE : String = gestureList update
[static]
VirtualTouchObject
  gestureEventComplete : Boolean
Indicates weather all gestureEvents have been completed on the touchSprite.
VirtualTouchObject
  gestureEventRelease : Boolean
Indicates whether all touch points have been released on the touchSprite.
VirtualTouchObject
  gestureEvents : Boolean
Determins whether gestureEvents are processed and dispatched on the touchSprite.
VirtualTouchObject
  gestureEventStart : Boolean
Indicates whether any gestureEvents have been started on the touchSprite.
VirtualTouchObject
  gestureFilters : Boolean
VirtualTouchObject
  gestureList : Object
VirtualTouchObject
  gestureReleaseInertia : Boolean
Determins whether release inertia is given to gestureEvents on the touchSprite.
VirtualTouchObject
  gestureTouchInertia : Boolean
Determins whether touch inertia is processed on the touchSprite.
VirtualTouchObject
  _gestureTweenOn : Boolean = false
VirtualTouchObject
  gestureTweenOn : Boolean
VirtualTouchObject
  gO : GestureListObject
VirtualTouchObject
  N : int
VirtualTouchObject
  nestedTransform : Boolean
VirtualTouchObject
  pointArray : Vector.<PointObject>
[read-only]
VirtualTouchObject
  pointCount : int
VirtualTouchObject
  sO : StrokeObject
VirtualTouchObject
  target : *
VirtualTouchObject
  targeting : Boolean
Turns off manual ALL targeting control, defaults to a simple hit test targeting model with exclusive target clustering
VirtualTouchObject
  targetList : Array
Allows touch and gesture events to explicitly target a group of defined touch objects which can be outside of the local parent child display list stack
VirtualTouchObject
  targetObject : Object
Allows touch and gesture events to explicitly target a touch object this can be outside the local parent child display list stack
VirtualTouchObject
  targetParent : Boolean
Allows touch and gesture events to explicitly target the parent touch object
VirtualTouchObject
  tc : TouchCluster
VirtualTouchObject
  td : TouchDebugDisplay
VirtualTouchObject
  tg : TouchGesture
VirtualTouchObject
  tiO : TimelineObject
VirtualTouchObject
  touchChildren : Boolean
VirtualTouchObject
  touchObjectID : int
[read-only]
VirtualTouchObject
  tp : TouchPipeline
VirtualTouchObject
  traceDebugModeOn : Boolean
VirtualTouchObject
  transformComplete : Boolean
VirtualTouchObject
  transformEventComplete : Boolean
VirtualTouchObject
  transformEvents : Boolean
Determins whether transformEvents are processed and dispatched on the touchSprite.
VirtualTouchObject
  transformEventStart : Boolean
VirtualTouchObject
  transformGestureVectors : Boolean
Determins whether transformations are handled internally (natively) on the touchSprite.
VirtualTouchObject
  transformStart : Boolean
VirtualTouchObject
  trO : TransformObject
VirtualTouchObject
  tt : TouchTransform
VirtualTouchObject
  x_lock : Boolean
VirtualTouchObject
  y_lock : Boolean
VirtualTouchObject
Public Methods
 MethodDefined By
  
VirtualTouchObject
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
[override] Registers event listeners.
VirtualTouchObject
  
assignPoint(event:TouchEvent):void
registers assigned touch point globaly and to relevant local clusters
VirtualTouchObject
  
onTouchDown(event:TouchEvent, downTarget:* = null):void
decides how to assign the captured touch point to a cluster can pass to parent, an explicit target, an explicit list or targets or a passed to any touch object in the local display stack.
VirtualTouchObject
  
VirtualTouchObject
  
VirtualTouchObject
  
VirtualTouchObject
  
VirtualTouchObject
  
Registers/unregisters event handlers depending on the active modes
VirtualTouchObject
  
VirtualTouchObject
  
VirtualTouchObject
  
VirtualTouchObject
Property Detail
_$heightproperty
public var _$height:Number = 0

_$rotationproperty 
public var _$rotation:Number = 0

_$scaleXproperty 
public var _$scaleX:Number = 1

_$scaleYproperty 
public var _$scaleY:Number = 1

_$widthproperty 
public var _$width:Number = 0

_$xproperty 
public var _$x:Number = 0

_$yproperty 
public var _$y:Number = 0

_gestureTweenOnproperty 
public var _gestureTweenOn:Boolean = false

$rotationproperty 
$rotation:Number


Implementation
    public function get $rotation():Number
    public function set $rotation(value:Number):void
$scaleXproperty 
$scaleX:Number


Implementation
    public function get $scaleX():Number
    public function set $scaleX(value:Number):void
$scaleYproperty 
$scaleY:Number


Implementation
    public function get $scaleY():Number
    public function set $scaleY(value:Number):void
$transformPointproperty 
$transformPoint:Point


Implementation
    public function get $transformPoint():Point
    public function set $transformPoint(value:Point):void
$xproperty 
$x:Number


Implementation
    public function get $x():Number
    public function set $x(value:Number):void
$yproperty 
$y:Number


Implementation
    public function get $y():Number
    public function set $y(value:Number):void
broadcastTargetproperty 
broadcastTarget:Boolean


Implementation
    public function get broadcastTarget():Boolean
    public function set broadcastTarget(value:Boolean):void
clusterBubblingproperty 
clusterBubbling:Boolean

Allows touch points from a childclusters to copy into container touch objects in the local parent child display list stack. This allows the for the concept of parallel clustering of touch point. Where a single touch point can simultaniuosly be a member of multiple touch point clusters. This allows multiple gestures to be dispatched from multiple touch objects from a set of touch points.


Implementation
    public function get clusterBubbling():Boolean
    public function set clusterBubbling(value:Boolean):void
clusterEventsproperty 
clusterEvents:Boolean

Determins whether clusterEvents are processed and dispatched on the touchSprite.


Implementation
    public function get clusterEvents():Boolean
    public function set clusterEvents(value:Boolean):void
clusterIDproperty 
clusterID:int


Implementation
    public function get clusterID():int
    public function set clusterID(value:int):void
cOproperty 
public var cO:ClusterObject

debugDisplayproperty 
debugDisplay:Boolean


Implementation
    public function get debugDisplay():Boolean
    public function set debugDisplay(value:Boolean):void
deltaFilterOnproperty 
deltaFilterOn:Boolean

Determins whether filtering is applied to the delta values.


Implementation
    public function get deltaFilterOn():Boolean
    public function set deltaFilterOn(value:Boolean):void
disableAffineTransformproperty 
disableAffineTransform:Boolean

Determins whether internal (native) transformations are affine (dynamically centered) on the touchSprite.


Implementation
    public function get disableAffineTransform():Boolean
    public function set disableAffineTransform(value:Boolean):void
disableNativeTransformproperty 
disableNativeTransform:Boolean

Determins whether transformations are handled internally (natively) on the touchSprite.


Implementation
    public function get disableNativeTransform():Boolean
    public function set disableNativeTransform(value:Boolean):void
dNproperty 
dN:Number


Implementation
    public function get dN():Number
    public function set dN(value:Number):void
GESTRELIST_UPDATEproperty 
public static var GESTRELIST_UPDATE:String = gestureList update

gestureEventCompleteproperty 
gestureEventComplete:Boolean

Indicates weather all gestureEvents have been completed on the touchSprite.


Implementation
    public function get gestureEventComplete():Boolean
    public function set gestureEventComplete(value:Boolean):void
gestureEventReleaseproperty 
gestureEventRelease:Boolean

Indicates whether all touch points have been released on the touchSprite.


Implementation
    public function get gestureEventRelease():Boolean
    public function set gestureEventRelease(value:Boolean):void
gestureEventsproperty 
gestureEvents:Boolean

Determins whether gestureEvents are processed and dispatched on the touchSprite.


Implementation
    public function get gestureEvents():Boolean
    public function set gestureEvents(value:Boolean):void
gestureEventStartproperty 
gestureEventStart:Boolean

Indicates whether any gestureEvents have been started on the touchSprite.


Implementation
    public function get gestureEventStart():Boolean
    public function set gestureEventStart(value:Boolean):void
gestureFiltersproperty 
gestureFilters:Boolean


Implementation
    public function get gestureFilters():Boolean
    public function set gestureFilters(value:Boolean):void
gestureListproperty 
gestureList:Object


Implementation
    public function get gestureList():Object
    public function set gestureList(value:Object):void
gestureReleaseInertiaproperty 
gestureReleaseInertia:Boolean

Determins whether release inertia is given to gestureEvents on the touchSprite.


Implementation
    public function get gestureReleaseInertia():Boolean
    public function set gestureReleaseInertia(value:Boolean):void
gestureTouchInertiaproperty 
gestureTouchInertia:Boolean

Determins whether touch inertia is processed on the touchSprite.


Implementation
    public function get gestureTouchInertia():Boolean
    public function set gestureTouchInertia(value:Boolean):void
gestureTweenOnproperty 
gestureTweenOn:Boolean


Implementation
    public function get gestureTweenOn():Boolean
    public function set gestureTweenOn(value:Boolean):void
gOproperty 
public var gO:GestureListObject

Nproperty 
N:int


Implementation
    public function get N():int
    public function set N(value:int):void
nestedTransformproperty 
nestedTransform:Boolean


Implementation
    public function get nestedTransform():Boolean
    public function set nestedTransform(value:Boolean):void
pointArrayproperty 
pointArray:Vector.<PointObject>  [read-only]


Implementation
    public function get pointArray():Vector.<PointObject>
pointCountproperty 
pointCount:int


Implementation
    public function get pointCount():int
    public function set pointCount(value:int):void
sOproperty 
public var sO:StrokeObject

targetproperty 
public var target:*

targetingproperty 
targeting:Boolean

Turns off manual ALL targeting control, defaults to a simple hit test targeting model with exclusive target clustering


Implementation
    public function get targeting():Boolean
    public function set targeting(value:Boolean):void
targetListproperty 
targetList:Array

Allows touch and gesture events to explicitly target a group of defined touch objects which can be outside of the local parent child display list stack


Implementation
    public function get targetList():Array
    public function set targetList(value:Array):void
targetObjectproperty 
targetObject:Object

Allows touch and gesture events to explicitly target a touch object this can be outside the local parent child display list stack


Implementation
    public function get targetObject():Object
    public function set targetObject(value:Object):void
targetParentproperty 
targetParent:Boolean

Allows touch and gesture events to explicitly target the parent touch object


Implementation
    public function get targetParent():Boolean
    public function set targetParent(value:Boolean):void
tcproperty 
public var tc:TouchCluster

tdproperty 
public var td:TouchDebugDisplay

tgproperty 
public var tg:TouchGesture

tiOproperty 
public var tiO:TimelineObject

touchChildrenproperty 
touchChildren:Boolean


Implementation
    public function get touchChildren():Boolean
    public function set touchChildren(value:Boolean):void
touchObjectIDproperty 
touchObjectID:int  [read-only]


Implementation
    public function get touchObjectID():int
tpproperty 
public var tp:TouchPipeline

traceDebugModeOnproperty 
traceDebugModeOn:Boolean


Implementation
    public function get traceDebugModeOn():Boolean
    public function set traceDebugModeOn(value:Boolean):void
transformCompleteproperty 
transformComplete:Boolean


Implementation
    public function get transformComplete():Boolean
    public function set transformComplete(value:Boolean):void
transformEventCompleteproperty 
transformEventComplete:Boolean


Implementation
    public function get transformEventComplete():Boolean
    public function set transformEventComplete(value:Boolean):void
transformEventsproperty 
transformEvents:Boolean

Determins whether transformEvents are processed and dispatched on the touchSprite.


Implementation
    public function get transformEvents():Boolean
    public function set transformEvents(value:Boolean):void
transformEventStartproperty 
transformEventStart:Boolean


Implementation
    public function get transformEventStart():Boolean
    public function set transformEventStart(value:Boolean):void
transformGestureVectorsproperty 
transformGestureVectors:Boolean

Determins whether transformations are handled internally (natively) on the touchSprite.


Implementation
    public function get transformGestureVectors():Boolean
    public function set transformGestureVectors(value:Boolean):void
transformStartproperty 
transformStart:Boolean


Implementation
    public function get transformStart():Boolean
    public function set transformStart(value:Boolean):void
trOproperty 
public var trO:TransformObject

ttproperty 
public var tt:TouchTransform

x_lockproperty 
x_lock:Boolean


Implementation
    public function get x_lock():Boolean
    public function set x_lock(value:Boolean):void
y_lockproperty 
y_lock:Boolean


Implementation
    public function get y_lock():Boolean
    public function set y_lock(value:Boolean):void
Constructor Detail
VirtualTouchObject()Constructor
public function VirtualTouchObject(target:*)



Parameters
target:*
Method Detail
addEventListener()method
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Registers event listeners. Also processes GWTouchEvents by evaluating which types of touch events (TUIO, native touch, and mouse) are active then registers and dispatches appropriate events.

Parameters

type:String
 
listener:Function
 
useCapture:Boolean (default = false)
 
priority:int (default = 0)
 
useWeakReference:Boolean (default = false)

assignPoint()method 
public function assignPoint(event:TouchEvent):void

registers assigned touch point globaly and to relevant local clusters

Parameters

event:TouchEvent

onTouchDown()method 
public function onTouchDown(event:TouchEvent, downTarget:* = null):void

decides how to assign the captured touch point to a cluster can pass to parent, an explicit target, an explicit list or targets or a passed to any touch object in the local display stack.

Parameters

event:TouchEvent
 
downTarget:* (default = null)

preinitBase()method 
public function preinitBase():*

Returns
*
updateClusterAnalysis()method 
public function updateClusterAnalysis():void

updateDebugDisplay()method 
public function updateDebugDisplay():void

updateGesturePipeline()method 
public function updateGesturePipeline():void

updateListeners()method 
public function updateListeners():void

Registers/unregisters event handlers depending on the active modes

updateMotionClusterAnalysis()method 
public function updateMotionClusterAnalysis():void

updateSensorClusterAnalysis()method 
public function updateSensorClusterAnalysis():void

updateTObjProcessing()method 
public function updateTObjProcessing():void