SpriteStage Class

Extends Stage

Defined in: SpriteStage:49

Module: EaselJS

A sprite stage is the root level Container for an aggressively optimized display list. Each time its tick method is called, it will render its display list to its target canvas. WebGL content is fully compatible with the existing Context2D renderer. On devices or browsers that don't support WebGL, content will automatically be rendered via canvas 2D.

Restrictions:

- only Sprite, SpriteContainer, BitmapText, Bitmap and DOMElement are allowed to be added to the display list.
- a child being added (with the exception of DOMElement) MUST have an image or spriteSheet defined on it.
- a child's image/spriteSheet MUST never change while being on the display list.

Example

This example creates a sprite stage, adds a child to it, then uses Ticker to update the child and redraw the stage using SpriteStage/update.

 var stage = new createjs.SpriteStage("canvasElementId", false, false);
 stage.updateViewport(800, 600);
 var image = new createjs.Bitmap("imagePath.png");
 stage.addChild(image);
 createjs.Ticker.addEventListener("tick", handleTick);
 function handleTick(event) {
     image.x += 10;
     stage.update();
 }

Note: SpriteStage is not included in the minified version of EaselJS.

Constructor

`SpriteStage`

(

canvas
preserveDrawingBuffer
antialias

)

Defined in SpriteStage:49

Parameters:

canvas HTMLCanvasElement | String | Object

A canvas object that the SpriteStage will render to, or the string id of a canvas object in the current document.
preserveDrawingBuffer Boolean

If true, the canvas is NOT auto-cleared by WebGL (spec discourages true). Useful if you want to use p.autoClear = false.
antialias Boolean

Specifies whether or not the browser's WebGL implementation should try to perform antialiasing.

Index
Methods
Properties
Events

Item Index

Methods

`_applyFilters`

() protected

Inherited from DisplayObject: _applyFilters:1274

`_applyShadow`

(

ctx
shadow

)

protected

Inherited from DisplayObject: _applyShadow:1226

Parameters:

ctx CanvasRenderingContext2D
shadow Shadow

`_cloneProps`

(

)

DisplayObject protected

Inherited from DisplayObject: _cloneProps:1193

Parameters:

o DisplayObject

The DisplayObject instance which will have properties from the current DisplayObject instance copied into.

Returns:

DisplayObject:

`_createBuffers`

(

ctx

)

protected

Defined in _createBuffers:730

Sets up the necessary vertices and indices buffers.

Parameters:

ctx WebGLRenderingContext

`_createShader`

(

ctx
type
str

)

WebGLShader protected

Defined in _createShader:707

Creates a shader from the specified string.

Parameters:

ctx WebGLRenderingContext
type Number

The type of shader to create.
str String

The definition for the shader.

Returns:

WebGLShader:

`_createShaderProgram`

(

ctx

)

protected

Defined in _createShaderProgram:642

Creates the shader program that's going to be used to draw everything.

Parameters:

ctx WebGLRenderingContext

`_dispatchEvent`

(

eventObj
eventPhase

)

protected

Inherited from EventDispatcher: _dispatchEvent:377

Parameters:

eventObj Object | String | Event
eventPhase Object

`_dispatchMouseEvent`

(

target
type
bubbles
pointerId
o
[nativeEvent]

)

protected

Inherited from Stage: _dispatchMouseEvent:855

Parameters:

target DisplayObject
type String
bubbles Boolean
pointerId Number
o Object
[nativeEvent] MouseEvent optional

`_drawToGPU`

(

ctx

)

protected

Defined in _drawToGPU:965

Draws all the currently defined boxes to the GPU.

Parameters:

ctx WebGLRenderingContext

The canvas WebGL context object to draw into.

`_drawWebGLKids`

(

kids
ctx
parentMVMatrix

)

protected

Defined in _drawWebGLKids:820

Draw all the kids into the WebGL context.

Parameters:

kids Array

The list of kids to draw.
ctx WebGLRenderingContext

The canvas WebGL context object to draw into.
parentMVMatrix Matrix2D

The parent's global transformation matrix.

`_getBounds`

(

matrix
ignoreTransform

)

Rectangle protected

Inherited from DisplayObject but overwritten in _getBounds:663

Parameters:

matrix Matrix2D
ignoreTransform Boolean

If true, does not apply this object's transform.

Returns:

Rectangle:

`_getElementRect`

(

)

protected

Inherited from Stage: _getElementRect:585

Parameters:

e HTMLElement

`_getFilterBounds`

() Rectangle protected

Inherited from DisplayObject: _getFilterBounds:1289

Returns:

Rectangle:

`_getObjectsUnderPoint`

(

x
y
arr
mouse
activeListener
currentDepth

)

DisplayObject protected

Inherited from Container: _getObjectsUnderPoint:578

Parameters:

x Number
y Number
arr Array
mouse Boolean

If true, it will respect mouse interaction properties like mouseEnabled, mouseChildren, and active listeners.
activeListener Boolean

If true, there is an active mouse event listener on a parent object.
currentDepth Number

Indicates the current depth of the search.

Returns:

DisplayObject:

`_getPointerData`

(

id

)

protected

Inherited from Stage: _getPointerData:613

Parameters:

id Number

`_handleDoubleClick`

(

e
owner

)

protected

Inherited from Stage: _handleDoubleClick:840

Parameters:

e MouseEvent
owner Stage

Indicates that the event has already been captured & handled by the indicated stage.

`_handleMouseDown`

(

)

protected

Inherited from Stage: _handleMouseDown:736

Parameters:

e MouseEvent

`_handleMouseMove`

(

)

protected

Inherited from Stage: _handleMouseMove:624

Parameters:

e MouseEvent

`_handleMouseUp`

(

)

protected

Inherited from Stage: _handleMouseUp:699

Parameters:

e MouseEvent

`_handlePointerDown`

(

id
e
pageX
pageY
owner

)

protected

Inherited from Stage: _handlePointerDown:745

Parameters:

id Number
e Event
pageX Number
pageY Number
owner Stage

Indicates that the event has already been captured & handled by the indicated stage.

`_handlePointerMove`

(

id
e
pageX
pageY
owner

)

protected

Inherited from Stage: _handlePointerMove:634

Parameters:

id Number
e Event
pageX Number
pageY Number
owner Stage

Indicates that the event has already been captured & handled by the indicated stage.

`_handlePointerUp`

(

id
e
clear
owner

)

protected

Inherited from Stage: _handlePointerUp:708

Parameters:

id Number
e Event
clear Boolean
owner Stage

Indicates that the event has already been captured & handled by the indicated stage.

`_initializeWebGL`

() protected

Defined in _initializeWebGL:543

Initializes rendering with WebGL using the current canvas element.

`_initializeWebGLContext`

() protected

Defined in _initializeWebGLContext:573

Sets up the WebGL context for rendering.

`_isMouseOpaque`

() Boolean protected

Inherited from DisplayObject: _isMouseOpaque:1349

Indicates whether the display object has any mouse event listeners or a cursor.

Returns:

Boolean:

`_setClearColor`

(

)

protected

Defined in _setClearColor:622

Sets the color to use when the WebGL canvas has been cleared.

Parameters:

r Number

A number between 0 and 1.
g Number

A number between 0 and 1.
b Number

A number between 0 and 1.
a Number

A number between 0 and 1.

`_setMaxBoxesPoints`

(

ctx
value

)

protected

Defined in _setMaxBoxesPoints:749

Updates the maximum total number of boxes points that can be defined per draw call, and updates the buffers with the new array length sizes.

Parameters:

ctx WebGLRenderingContext
value Number

The new this._maxBoxesPointsPerDraw value.

`_setUpKidTexture`

(

ctx
kid

)

WebGLTexture protected

Defined in _setUpKidTexture:783

Sets up a kid's WebGL texture.

Parameters:

ctx WebGLRenderingContext

The canvas WebGL context object to draw into.
kid Object

The list of kids to draw.

Returns:

WebGLTexture:

`_setWebGLContext`

() WebGLRenderingContext protected

Defined in _setWebGLContext:554

Sets the WebGL context to use for future draws.

Returns:

WebGLRenderingContext:

The newly created context.

`_testHit`

(

ctx

)

Boolean protected

Inherited from DisplayObject: _testHit:1257

Parameters:

ctx CanvasRenderingContext2D

Returns:

Boolean:

`_testMask`

(

target
x
y

)

Boolean protected

Inherited from Container: _testMask:632

Parameters:

target DisplayObject
x Number
y Number

Returns:

Boolean:

Indicates whether the x/y is within the masked region.

`_testMouseOver`

(

clear
owner
eventTarget

)

protected

Inherited from Stage: _testMouseOver:771

Parameters:

clear Boolean

If true, clears the mouseover / rollover (ie. no target)
owner Stage

Indicates that the event has already been captured & handled by the indicated stage.
eventTarget Stage

The stage that the cursor is actively over.

`_tick`

(

evtObj

)

protected

Inherited from DisplayObject but overwritten in _tick:547

Parameters:

evtObj Object

An event object that will be dispatched to all tick listeners. This object is reused between dispatchers to reduce construction & GC costs.

`_transformBounds`

(

bounds
matrix
ignoreTransform

)

Rectangle protected

Inherited from DisplayObject: _transformBounds:1316

Parameters:

bounds Rectangle
matrix Matrix2D
ignoreTransform Boolean

Returns:

Rectangle:

`_updatePointerPosition`

(

id
e
pageX
pageY

)

protected

Inherited from Stage: _updatePointerPosition:662

Parameters:

id Number
e Event
pageX Number
pageY Number

`addChild`

(

child

)

DisplayObject

Inherited from Container but overwritten in addChild:360

Adds a child to the top of the display list. Only children of type SpriteContainer, Sprite, Bitmap, BitmapText, or DOMElement are allowed. Children also MUST have either an image or spriteSheet defined on them (unless it's a DOMElement).

Example

container.addChild(bitmapInstance);

You can also add multiple children at once:

 container.addChild(bitmapInstance, shapeInstance, textInstance);

Parameters:

child DisplayObject

The display object to add.

Returns:

DisplayObject:

The child that was added, or the last child if multiple children were added.

`addChildAt`

(

child
index

)

DisplayObject

Inherited from Container but overwritten in addChildAt:385

Adds a child to the display list at the specified index, bumping children at equal or greater indexes up one, and setting its parent to this Container. Only children of type SpriteContainer, Sprite, Bitmap, BitmapText, or DOMElement are allowed. Children also MUST have either an image or spriteSheet defined on them (unless it's a DOMElement).

Example

 addChildAt(child1, index);

You can also add multiple children, such as:

 addChildAt(child1, child2, ..., index);

The index must be between 0 and numChildren. For example, to add myShape under otherShape in the display list, you could use:

 container.addChildAt(myShape, container.getChildIndex(otherShape));

This would also bump otherShape's index up by one. Fails silently if the index is out of range.

Parameters:

child DisplayObject

The display object to add.
index Number

The index to add the child at.

Returns:

DisplayObject:

Returns the last child that was added, or the last child if multiple children were added.

`addEventListener`

(

type
listener
[useCapture]

)

Function | Object

Inherited from EventDispatcher: addEventListener:149

Adds the specified event listener. Note that adding multiple listeners to the same function will result in multiple callbacks getting fired.

Example

 displayObject.addEventListener("click", handleClick);
 function handleClick(event) {
    // Click happened.
 }

Parameters:

type String

The string type of the event.
listener Function | Object

An object with a handleEvent method, or a function that will be called when the event is dispatched.
[useCapture] Boolean optional

For events that bubble, indicates whether to listen for the event in the capture or bubbling/target phase.

Returns:

Function | Object:

Returns the listener for chaining or assignment.

`cache`

(

x
y
width
height
[scale=1]

)

Inherited from DisplayObject: cache:749

Draws the display object into a new canvas, which is then used for subsequent draws. For complex content that does not change frequently (ex. a Container with many children that do not move, or a complex vector Shape), this can provide for much faster rendering because the content does not need to be re-rendered each tick. The cached display object can be moved, rotated, faded, etc freely, however if its content changes, you must manually update the cache by calling updateCache() or cache() again. You must specify the cache area via the x, y, w, and h parameters. This defines the rectangle that will be rendered and cached using this display object's coordinates.

Example

For example if you defined a Shape that drew a circle at 0, 0 with a radius of 25:

 var shape = new createjs.Shape();
 shape.graphics.beginFill("#ff0000").drawCircle(0, 0, 25);
 myShape.cache(-25, -25, 50, 50);

Note that filters need to be defined before the cache is applied. Check out the Filter class for more information. Some filters (ex. BlurFilter) will not work as expected in conjunction with the scale param.

Usually, the resulting cacheCanvas will have the dimensions widthscale by heightscale, however some filters (ex. BlurFilter) will add padding to the canvas dimensions.

Parameters:

x Number

The x coordinate origin for the cache region.
y Number

The y coordinate origin for the cache region.
width Number

The width of the cache region.
height Number

The height of the cache region.
[scale=1] Number optional

The scale at which the cache will be created. For example, if you cache a vector shape using myShape.cache(0,0,100,100,2) then the resulting cacheCanvas will be 200x200 px. This lets you scale and rotate cached elements with greater fidelity. Default is 1.

`clear`

()

Inherited from Stage but overwritten in clear:457

Clears the target canvas. Useful if autoClear is set to false.

`clearImageTexture`

(

image

)

Defined in clearImageTexture:523

Clears an image's texture to free it up for garbage collection.

Parameters:

image Image

`clone`

()

Inherited from DisplayObject but overwritten in clone:566

Stage instances cannot be cloned.

`cloneChildren`

(

)

protected

Inherited from Container: cloneChildren:562

Recursively clones all children of this container, and adds them to the target container.

Parameters:

o Container

The target container.

`contains`

(

child

)

Boolean

Inherited from Container: contains:430

Returns true if the specified display object either is this container or is a descendent (child, grandchild, etc) of this container.

Parameters:

child DisplayObject

The DisplayObject to be checked.

Returns:

Boolean:

true if the specified display object either is this container or is a descendent.

`dispatchEvent`

(

eventObj

)

Boolean

Inherited from EventDispatcher: dispatchEvent:287

Dispatches the specified event to all listeners.

Example

 // Use a string event
 this.dispatchEvent("complete");

 // Use an Event instance
 var event = new createjs.Event("progress");
 this.dispatchEvent(event);

Parameters:

eventObj Object | String | Event

An object with a "type" property, or a string type. While a generic object will work, it is recommended to use a CreateJS Event instance. If a string is used, dispatchEvent will construct an Event instance with the specified type.

Returns:

Boolean:

Returns the value of eventObj.defaultPrevented.

`draw`

(

ctx
[ignoreCache=false]

)

Inherited from DisplayObject but overwritten in draw:475

Draws the stage into the specified context (using WebGL) ignoring its visible, alpha, shadow, and transform. If WebGL is not supported in the browser, it will default to a 2D context. Returns true if the draw was handled (useful for overriding functionality).

NOTE: This method is mainly for internal use, though it may be useful for advanced uses.

Parameters:

ctx CanvasRenderingContext2D

The canvas 2D context object to draw into.
[ignoreCache=false] Boolean optional

Indicates whether the draw operation should ignore any current cache. For example, used for drawing the cache (to prevent it from simply drawing an existing cache back into itself).

`enableDOMEvents`

(

[enable=true]

)

Inherited from Stage: enableDOMEvents:526

Enables or disables the event listeners that stage adds to DOM elements (window, document and canvas). It is good practice to disable events when disposing of a Stage instance, otherwise the stage will continue to receive events from the page.

When changing the canvas property you must disable the events on the old canvas, and enable events on the new canvas or mouse events will not work as expected. For example:

 myStage.enableDOMEvents(false);
 myStage.canvas = anotherCanvas;
 myStage.enableDOMEvents(true);

Parameters:

[enable=true] Boolean optional

Indicates whether to enable or disable the events. Default is true.

`enableMouseOver`

(

[frequency=20]

)

Inherited from Stage: enableMouseOver:495

Enables or disables (by passing a frequency of 0) mouse over (mouseover and mouseout) and roll over events (rollover and rollout) for this stage's display list. These events can be expensive to generate, so they are disabled by default. The frequency of the events can be controlled independently of mouse move events via the optional frequency parameter.

Example

 var stage = new createjs.Stage("canvasId");
 stage.enableMouseOver(10); // 10 updates per second

Parameters:

[frequency=20] Number optional

Optional param specifying the maximum number of times per second to broadcast mouse over/out events. Set to 0 to disable mouse over events completely. Maximum is 50. A lower frequency is less responsive, but uses less CPU.

`getBounds`

() Rectangle

Inherited from DisplayObject: getBounds:1067

Returns a rectangle representing this object's bounds in its local coordinate system (ie. with no transformation). Objects that have been cached will return the bounds of the cache.

Not all display objects can calculate their own bounds (ex. Shape). For these objects, you can use setBounds so that they are included when calculating Container bounds.

All	All display objects support setting bounds manually using setBounds(). Likewise, display objects that have been cached using cache() will return the bounds of their cache. Manual and cache bounds will override the automatic calculations listed below.
Bitmap	Returns the width and height of the sourceRect (if specified) or image, extending from (x=0,y=0).
Sprite	Returns the bounds of the current frame. May have non-zero x/y if a frame registration point was specified in the spritesheet data. See also getFrameBounds
Container	Returns the aggregate (combined) bounds of all children that return a non-null value from getBounds().
Shape	Does not currently support automatic bounds calculations. Use setBounds() to manually define bounds.
Text	Returns approximate bounds. Horizontal values (x/width) are quite accurate, but vertical values (y/height) are not, especially when using textBaseline values other than "top".
BitmapText	Returns approximate bounds. Values will be more accurate if spritesheet frame registration points are close to (x=0,y=0).

Bounds can be expensive to calculate for some objects (ex. text, or containers with many children), and are recalculated each time you call getBounds(). You can prevent recalculation on static objects by setting the bounds explicitly:

var bounds = obj.getBounds();
obj.setBounds(bounds.x, bounds.y, bounds.width, bounds.height);
// getBounds will now use the set values, instead of recalculating

To reduce memory impact, the returned Rectangle instance may be reused internally; clone the instance or copy its values if you need to retain it.

var myBounds = obj.getBounds().clone();
// OR:
myRect.copy(obj.getBounds());

Returns:

Rectangle:

A Rectangle instance representing the bounds, or null if bounds are not available for this object.

`getCacheDataURL`

() String

Inherited from DisplayObject: getCacheDataURL:851

Returns a data URL for the cache, or null if this display object is not cached. Uses cacheID to ensure a new data URL is not generated if the cache has not changed.

Returns:

String:

The image data url for the cache.

`getChildAt`

(

index

)

DisplayObject

Inherited from Container: getChildAt:314

Returns the child at the specified index.

Example

 container.getChildAt(2);

Parameters:

index Number

The index of the child to return.

Returns:

DisplayObject:

The child at the specified index. Returns null if there is no child at the index.

`getChildByName`

(

name

)

DisplayObject

Inherited from Container: getChildByName:329

Returns the child with the specified name.

Parameters:

name String

The name of the child to return.

Returns:

DisplayObject:

The child with the specified name.

`getChildIndex`

(

child

)

Number

Inherited from Container: getChildIndex:363

Returns the index of the specified child in the display list, or -1 if it is not in the display list.

Example

 var index = container.getChildIndex(child);

Parameters:

child DisplayObject

The child to return the index of.

Returns:

Number:

The index of the specified child. -1 if the child is not found.

`getConcatenatedDisplayProps`

(

[props]

)

DisplayProps

Inherited from DisplayObject: getConcatenatedDisplayProps:999

Generates a DisplayProps object representing the combined display properties of the object and all of its parent Containers up to the highest level ancestor (usually the Stage).

Parameters:

[props] DisplayProps optional

A DisplayProps object to populate with the calculated values. If null, a new DisplayProps object is returned.

Returns:

DisplayProps:

The combined display properties.

`getConcatenatedMatrix`

(

[matrix]

)

Matrix2D

Inherited from DisplayObject: getConcatenatedMatrix:981

Generates a Matrix2D object representing the combined transform of the display object and all of its parent Containers up to the highest level ancestor (usually the Stage). This can be used to transform positions between coordinate spaces, such as with localToGlobal and globalToLocal.

Parameters:

[matrix] Matrix2D optional

A Matrix2D object to populate with the calculated values. If null, a new Matrix2D object is returned.

Returns:

Matrix2D:

The combined matrix.

`getMatrix`

(

matrix

)

Matrix2D

Inherited from DisplayObject: getMatrix:969

Returns a matrix based on this object's current transform.

Parameters:

matrix Matrix2D

Optional. A Matrix2D object to populate with the calculated values. If null, a new Matrix object is returned.

Returns:

Matrix2D:

A matrix representing this display object's transform.

`getNumChildren`

() Number deprecated

Inherited from Container: getNumChildren:97

Use the numChildren property instead.

Returns:

Number:

`getObjectsUnderPoint`

(

x
y
[mode=0]

)

Array

Inherited from Container: getObjectsUnderPoint:460

Returns an array of all display objects under the specified coordinates that are in this container's display list. This routine ignores any display objects with mouseEnabled set to false. The array will be sorted in order of visual depth, with the top-most display object at index 0. This uses shape based hit detection, and can be an expensive operation to run, so it is best to use it carefully. For example, if testing for objects under the mouse, test on tick (instead of on DisplayObject/mousemove:event), and only if the mouse's position has changed.

By default (mode=0) this method evaluates all display objects.
By setting the mode parameter to 1, the mouseEnabled and MouseChildren:property properties will be respected.
Setting the mode to 2 additionally excludes display objects that do not have active mouse event listeners or a DisplayObject:cursor:property property. That is, only objects that would normally intercept mouse interaction will be included. This can significantly improve performance in some cases by reducing the number of display objects that need to be tested.

This method accounts for both hitArea and mask.

Parameters:

x Number

The x position in the container to test.
y Number

The y position in the container to test.
[mode=0] Number optional

The mode to use to determine which display objects to include. 0-all, 1-respect mouseEnabled/mouseChildren, 2-only mouse opaque objects.

Returns:

Array:

An Array of DisplayObjects under the specified coordinates.

`getObjectUnderPoint`

(

x
y
mode

)

DisplayObject

Inherited from Container: getObjectUnderPoint:492

Similar to getObjectsUnderPoint, but returns only the top-most display object. This runs significantly faster than getObjectsUnderPoint(), but is still potentially an expensive operation. See getObjectsUnderPoint for more information.

Parameters:

x Number

The x position in the container to test.
y Number

The y position in the container to test.
mode Number

The mode to use to determine which display objects to include. 0-all, 1-respect mouseEnabled/mouseChildren, 2-only mouse opaque objects.

Returns:

DisplayObject:

The top-most display object under the specified coordinates.

`getStage`

() Stage deprecated

Inherited from DisplayObject: getStage:658

Use the stage property instead.

Returns:

Stage:

`getTransformedBounds`

() Rectangle

Inherited from DisplayObject: getTransformedBounds:1133

Returns a rectangle representing this object's bounds in its parent's coordinate system (ie. with transformations applied). Objects that have been cached will return the transformed bounds of the cache.

Not all display objects can calculate their own bounds (ex. Shape). For these objects, you can use setBounds so that they are included when calculating Container bounds.

To reduce memory impact, the returned Rectangle instance may be reused internally; clone the instance or copy its values if you need to retain it.

Container instances calculate aggregate bounds for all children that return bounds via getBounds.

Returns:

Rectangle:

A Rectangle instance representing the bounds, or null if bounds are not available for this object.

`globalToLocal`

(

x
y
[pt]

)

Point

Inherited from DisplayObject: globalToLocal:888

Transforms the specified x and y position from the global (stage) coordinate space to the coordinate space of the display object. For example, this could be used to determine the current mouse position within the display object. Returns a Point instance with x and y properties correlating to the transformed position in the display object's coordinate space.

Example

 displayObject.x = 300;
 displayObject.y = 200;
 stage.addChild(displayObject);
 var point = myDisplayObject.globalToLocal(100, 100);
 // Results in x=-200, y=-100

Parameters:

x Number

The x position on the stage to transform.
y Number

The y position on the stage to transform.
[pt] Point | Object optional

An object to copy the result into. If omitted a new Point object with x/y properties will be returned.

Returns:

Point:

A Point instance with x and y properties correlating to the transformed position in the display object's coordinate space.

`hasEventListener`

(

type

)

Boolean

Inherited from EventDispatcher: hasEventListener:336

Indicates whether there is at least one listener for the specified event type.

Parameters:

type String

The string type of the event.

Returns:

Boolean:

Returns true if there is at least one listener for the specified event.

`hitTest`

(

)

Boolean

Inherited from DisplayObject but overwritten in hitTest:445

Tests whether the display object intersects the specified local point (ie. draws a pixel with alpha > 0 at the specified position). This ignores the alpha, shadow and compositeOperation of the display object, and all transform properties including regX/Y.

Parameters:

x Number

The x position to check in the display object's local coordinates.
y Number

The y position to check in the display object's local coordinates.

Returns:

Boolean:

A Boolean indicating whether there is a visible section of a DisplayObject that overlaps the specified coordinates.

`initialize`

() deprecated protected

Inherited from EventDispatcher but overwritten in initialize:234

REMOVED. Removed in favor of using MySuperClass_constructor. See extend and promote for details.

There is an inheritance tutorial distributed with EaselJS in /tutorials/Inheritance.

`isVisible`

() Boolean

Inherited from DisplayObject but overwritten in isVisible:129

Returns true or false indicating whether the display object would be visible if drawn to a canvas. This does not account for whether it would be visible within the boundaries of the stage.

NOTE: This method is mainly for internal use, though it may be useful for advanced uses.

Returns:

Boolean:

Boolean indicating whether the display object would be visible if drawn to a canvas

`localToGlobal`

(

x
y
[pt]

)

Point

Inherited from DisplayObject: localToGlobal:863

Transforms the specified x and y position from the coordinate space of the display object to the global (stage) coordinate space. For example, this could be used to position an HTML label over a specific point on a nested display object. Returns a Point instance with x and y properties correlating to the transformed coordinates on the stage.

Example

 displayObject.x = 300;
 displayObject.y = 200;
 stage.addChild(displayObject);
 var point = myDisplayObject.localToGlobal(100, 100);
 // Results in x=400, y=300

Parameters:

x Number

The x position in the source display object to transform.
y Number

The y position in the source display object to transform.
[pt] Point | Object optional

An object to copy the result into. If omitted a new Point object with x/y properties will be returned.

Returns:

Point:

A Point instance with x and y properties correlating to the transformed coordinates on the stage.

`localToLocal`

(

x
y
target
[pt]

)

Point

Inherited from DisplayObject: localToLocal:913

Transforms the specified x and y position from the coordinate space of this display object to the coordinate space of the target display object. Returns a Point instance with x and y properties correlating to the transformed position in the target's coordinate space. Effectively the same as using the following code with localToGlobal and globalToLocal.

 var pt = this.localToGlobal(x, y);
 pt = target.globalToLocal(pt.x, pt.y);

Parameters:

x Number

The x position in the source display object to transform.
y Number

The y position on the source display object to transform.
target DisplayObject

The target display object to which the coordinates will be transformed.
[pt] Point | Object optional

An object to copy the result into. If omitted a new Point object with x/y properties will be returned.

Returns:

Point:

Returns a Point instance with x and y properties correlating to the transformed position in the target's coordinate space.

`off`

(

type
listener
[useCapture]

)

Inherited from EventDispatcher: off:254

A shortcut to the removeEventListener method, with the same parameters and return value. This is a companion to the .on method.

Parameters:

type String

The string type of the event.
listener Function | Object

The listener function or object.
[useCapture] Boolean optional

For events that bubble, indicates whether to listen for the event in the capture or bubbling/target phase.

`on`

(

type
listener
[scope]
[once=false]
[data]
[useCapture=false]

)

Function

Inherited from EventDispatcher: on:182

A shortcut method for using addEventListener that makes it easier to specify an execution scope, have a listener only run once, associate arbitrary data with the listener, and remove the listener.

This method works by creating an anonymous wrapper function and subscribing it with addEventListener. The created anonymous function is returned for use with .removeEventListener (or .off).

Example

    var listener = myBtn.on("click", handleClick, null, false, {count:3});
    function handleClick(evt, data) {
        data.count -= 1;
        console.log(this == myBtn); // true - scope defaults to the dispatcher
        if (data.count == 0) {
            alert("clicked 3 times!");
            myBtn.off("click", listener);
            // alternately: evt.remove();
        }
    }

Parameters:

type String

The string type of the event.
listener Function | Object

An object with a handleEvent method, or a function that will be called when the event is dispatched.
[scope] Object optional

The scope to execute the listener in. Defaults to the dispatcher/currentTarget for function listeners, and to the listener itself for object listeners (ie. using handleEvent).
[once=false] Boolean optional

If true, the listener will remove itself after the first time it is triggered.
[data] optional

Arbitrary data that will be included as the second parameter when the listener is called.
[useCapture=false] Boolean optional

For events that bubble, indicates whether to listen for the event in the capture or bubbling/target phase.

Returns:

Function:

Returns the anonymous function that was created and assigned as the listener. This is needed to remove the listener later using .removeEventListener.

`removeAllChildren`

()

Inherited from Container: removeAllChildren:300

Removes all children from the display list.

Example

 container.removeAlLChildren();

`removeAllEventListeners`

(

[type]

)

Inherited from EventDispatcher: removeAllEventListeners:265

Removes all listeners for the specified type, or all listeners of all types.

Example

 // Remove all listeners
 displayObject.removeAllEventListeners();

 // Remove all click listeners
 displayObject.removeAllEventListeners("click");

Parameters:

[type] String optional

The string type of the event. If omitted, all listeners for all types will be removed.

`removeChild`

(

child

)

Boolean

Inherited from Container: removeChild:239

Removes the specified child from the display list. Note that it is faster to use removeChildAt() if the index is already known.

Example

 container.removeChild(child);

You can also remove multiple children:

 removeChild(child1, child2, ...);

Returns true if the child (or children) was removed, or false if it was not in the display list.

Parameters:

child DisplayObject

The child to remove.

Returns:

Boolean:

true if the child (or children) was removed, or false if it was not in the display list.

`removeChildAt`

(

index

)

Boolean

Inherited from Container: removeChildAt:266

Removes the child at the specified index from the display list, and sets its parent to null.

Example

 container.removeChildAt(2);

You can also remove multiple children:

 container.removeChild(2, 7, ...)

Returns true if the child (or children) was removed, or false if any index was out of range.

Parameters:

index Number

The index of the child to remove.

Returns:

Boolean:

true if the child (or children) was removed, or false if any index was out of range.

`removeEventListener`

(

type
listener
[useCapture]

)

Inherited from EventDispatcher: removeEventListener:224

Removes the specified event listener.

Important Note: that you must pass the exact function reference used when the event was added. If a proxy function, or function closure is used as the callback, the proxy/closure reference must be used - a new proxy or closure will not work.

Example

 displayObject.removeEventListener("click", handleClick);

Parameters:

type String

The string type of the event.
listener Function | Object

The listener function or object.
[useCapture] Boolean optional

For events that bubble, indicates whether to listen for the event in the capture or bubbling/target phase.

`set`

(

props

)

DisplayObject chainable

Inherited from DisplayObject: set:1049

Provides a chainable shortcut method for setting a number of properties on the instance.

Example

 var myGraphics = new createjs.Graphics().beginFill("#ff0000").drawCircle(0, 0, 25);
 var shape = stage.addChild(new Shape()).set({graphics:myGraphics, x:100, y:100, alpha:0.5});

Parameters:

props Object

A generic object containing properties to copy to the DisplayObject instance.

Returns:

DisplayObject:

Returns the instance the method is called on (useful for chaining calls.)

`setBounds`

(

x
y
width
height

)

Inherited from DisplayObject: setBounds:1152

Allows you to manually specify the bounds of an object that either cannot calculate their own bounds (ex. Shape & Text) for future reference, or so the object can be included in Container bounds. Manually set bounds will always override calculated bounds.

The bounds should be specified in the object's local (untransformed) coordinates. For example, a Shape instance with a 25px radius circle centered at 0,0 would have bounds of (-25, -25, 50, 50).

Parameters:

x Number

The x origin of the bounds. Pass null to remove the manual bounds.
y Number

The y origin of the bounds.
width Number

The width of the bounds.
height Number

The height of the bounds.

`setChildIndex`

(

child
index

)

Inherited from Container: setChildIndex:413

Changes the depth of the specified child. Fails silently if the child is not a child of this container, or the index is out of range.

Parameters:

child DisplayObject
index Number

`setTransform`

(

[x=0]
[y=0]
[scaleX=1]
[scaleY=1]
[rotation=0]
[skewX=0]
[skewY=0]
[regX=0]
[regY=0]

)

DisplayObject chainable

Inherited from DisplayObject: setTransform:935

Shortcut method to quickly set the transform properties on the display object. All parameters are optional. Omitted parameters will have the default value set.

Example

 displayObject.setTransform(100, 100, 2, 2);

Parameters:

[x=0] Number optional

The horizontal translation (x position) in pixels
[y=0] Number optional

The vertical translation (y position) in pixels
[scaleX=1] Number optional

The horizontal scale, as a percentage of 1
[scaleY=1] Number optional

the vertical scale, as a percentage of 1
[rotation=0] Number optional

The rotation, in degrees
[skewX=0] Number optional

The horizontal skew factor
[skewY=0] Number optional

The vertical skew factor
[regX=0] Number optional

The horizontal registration point in pixels
[regY=0] Number optional

The vertical registration point in pixels

Returns:

DisplayObject:

Returns this instance. Useful for chaining commands.

`sortChildren`

(

sortFunction

)

Inherited from Container: sortChildren:343

Performs an array sort operation on the child list.

Example: Display children with a higher y in front.

 var sortFunction = function(obj1, obj2, options) {
     if (obj1.y > obj2.y) { return 1; }
     if (obj1.y < obj2.y) { return -1; }
     return 0;
 }
 container.sortChildren(sortFunction);

Parameters:

sortFunction Function

the function to use to sort the child list. See JavaScript's Array.sort documentation for details.

`swapChildren`

(

child1
child2

)

Inherited from Container: swapChildren:393

Swaps the specified children's depth in the display list. Fails silently if either child is not a child of this Container.

Parameters:

child1 DisplayObject
child2 DisplayObject

`swapChildrenAt`

(

index1
index2

)

Inherited from Container: swapChildrenAt:378

Swaps the children at the specified indexes. Fails silently if either index is out of range.

Parameters:

index1 Number
index2 Number

`tick`

(

[props]

)

Inherited from Stage: tick:394

Propagates a tick event through the display list. This is automatically called by update unless tickOnUpdate is set to false.

If a props object is passed to tick(), then all of its properties will be copied to the event object that is propagated to listeners.

Some time-based features in EaselJS (for example Sprite/framerate require that a tick event object (or equivalent object with a delta property) be passed as the props parameter to tick(). For example:

Ticker.on("tick", handleTick);
function handleTick(evtObj) {
    // clone the event object from Ticker, and add some custom data to it:
    var evt = evtObj.clone().set({greeting:"hello", name:"world"});

    // pass it to stage.update():
    myStage.update(evt); // subsequently calls tick() with the same param
}

// ...
myDisplayObject.on("tick", handleDisplayObjectTick);
function handleDisplayObjectTick(evt) {
    console.log(evt.delta); // the delta property from the Ticker tick event object
    console.log(evt.greeting, evt.name); // custom data: "hello world"
}

Parameters:

[props] Object optional

An object with properties that should be copied to the event object. Should usually be a Ticker event object, or similar object with a delta property.

`toDataURL`

(

[backgroundColor]
[mimeType="image/png"]

)

String

Inherited from Stage: toDataURL:463

Returns a data url that contains a Base64-encoded image of the contents of the stage. The returned data url can be specified as the src value of an image element.

Parameters:

[backgroundColor] String optional

The background color to be used for the generated image. Any valid CSS color value is allowed. The default value is a transparent background.
[mimeType="image/png"] String optional

The MIME type of the image format to be create. The default is "image/png". If an unknown MIME type is passed in, or if the browser does not support the specified MIME type, the default value will be used.

Returns:

String:

a Base64 encoded image.

`toString`

() String

Inherited from EventDispatcher but overwritten in toString:532

Returns a string representation of this object.

Returns:

String:

a string representation of the instance.

`uncache`

()

Inherited from DisplayObject: uncache:841

Clears the current cache. See cache for more information.

`update`

(

[props]

)

Inherited from Stage: update:363

Each time the update method is called, the stage will call tick unless tickOnUpdate is set to false, and then render the display list to the canvas.

Parameters:

[props] Object optional

Props object to pass to tick(). Should usually be a Ticker event object, or similar object with a delta property.

`updateCache`

(

compositeOperation

)

Inherited from DisplayObject: updateCache:792

Redraws the display object to its cache. Calling updateCache without an active cache will throw an error. If compositeOperation is null the current cache will be cleared prior to drawing. Otherwise the display object will be drawn over the existing cache using the specified compositeOperation.

Example

Clear the current graphics of a cached shape, draw some new instructions, and then update the cache. The new line will be drawn on top of the old one.

 // Not shown: Creating the shape, and caching it.
 shapeInstance.clear();
 shapeInstance.setStrokeStyle(3).beginStroke("#ff0000").moveTo(100, 100).lineTo(200,200);
 shapeInstance.updateCache();

Parameters:

compositeOperation String

The compositeOperation to use, or null to clear the cache and redraw it. whatwg spec on compositing.

`updateContext`

(

ctx

)

Inherited from DisplayObject: updateContext:717

Applies this display object's transformation, alpha, globalCompositeOperation, clipping path (mask), and shadow to the specified context. This is typically called prior to draw.

Parameters:

ctx CanvasRenderingContext2D

The canvas 2D to update.

`updateViewport`

(

width
height

)

Defined in updateViewport:502

Update the WebGL viewport. Note that this does NOT update the canvas element's width/height.

Parameters:

width Number
height Number

`willTrigger`

(

type

)

Boolean

Inherited from EventDispatcher: willTrigger:347

Indicates whether there is at least one listener for the specified event type on this object or any of its ancestors (parent, parent's parent, etc). A return value of true indicates that if a bubbling event of the specified type is dispatched from this object, it will trigger at least one listener.

This is similar to hasEventListener, but it searches the entire event flow for a listener, not just this object.

Parameters:

type String

The string type of the event.

Returns:

Boolean:

Returns true if there is at least one listener for the specified event.

Properties

`_antialias`

Boolean protected

Number protected

Inherited from DisplayObject: _cacheScale:428

Default: 1

`_captureListeners`

Object protected

Inherited from EventDispatcher: _captureListeners:101

`_clearColor`

Object protected

Defined in _clearColor:154

The color to use when the WebGL canvas has been cleared.

Default: null

`_currentBoxIndex`

Number protected

Defined in _currentBoxIndex:244

The current box index being defined for drawing.

Default: -1

`_drawTexture`

WebGLTexture protected

Defined in _drawTexture:253

The current texture that will be used to draw into the GPU.

Default: null

`_filterOffsetX`

Number protected

Inherited from DisplayObject: _filterOffsetX:412

Default: 0

`_filterOffsetY`

Number protected

Inherited from DisplayObject: _filterOffsetY:420

Default: 0

`_indices`

Uint16Array protected

Defined in _indices:226

The indices to the vertices defined in this._vertices.

Default: null

`_indicesBuffer`

WebGLBuffer protected

Defined in _indicesBuffer:235

The buffer that contains all the indices data.

Number protected

Inherited from Stage: _mouseOverIntervalID:207

`_nextStage`

Stage protected

Inherited from Stage: _nextStage:214

`_pointerCount`

Object private

Inherited from Stage: _pointerCount:191

Number of active pointers.

`_pointerData`

Object private

Inherited from Stage: _pointerData:182

Holds objects with data for each active pointer id. Each object has the following properties: x, y, event, target, overTarget, overX, overY, inBounds, posEvtObj (native event that last updated position)

`_preserveDrawingBuffer`

Boolean protected

Defined in _preserveDrawingBuffer:88

Specifies whether or not the canvas is auto-cleared by WebGL. Spec discourages true. If true, the canvas is NOT auto-cleared by WebGL. Value is ignored if _alphaEnabled is false. Useful if you want to use autoClear = false.

Default: false

`_prevStage`

Stage protected

Inherited from Stage: _prevStage:221

`_verticesBuffer`

WebGLBuffer protected

Defined in _verticesBuffer:217

The buffer that contains all the vertices data.

Default: null

`_viewportHeight`

Number protected

Defined in _viewportHeight:117

The height of the canvas element.

Default: 0

`_viewportWidth`

Number protected

Defined in _viewportWidth:108

The width of the canvas element.

Default: 0

`_webGLContext`

WebGLRenderingContext protected

Defined in _webGLContext:135

The current WebGL canvas context.

Default: null

`_webGLErrorDetected`

Boolean protected

Defined in _webGLErrorDetected:144

Indicates whether or not an error has been detected when dealing with WebGL. If the is true, the behavior should be to use Canvas 2D rendering instead.

Default: false

`alpha`

Number

Inherited from DisplayObject: alpha:144

The alpha (transparency) for this display object. 0 is fully transparent, 1 is fully opaque.

Default: 1

`autoClear`

Boolean

Inherited from Stage: autoClear:69

Indicates whether the stage should automatically clear the canvas before each render. You can set this to false to manually control clearing (for generative art, or when pointing multiple stages at the same canvas for example).

Example

 var stage = new createjs.Stage("canvasId");
 stage.autoClear = false;

Default: true

`cacheCanvas`

HTMLCanvasElement | Object

Inherited from DisplayObject: cacheCanvas:152

If a cache is active, this returns the canvas that holds the cached version of this display object. See Cache for more information.

Default: null

`cacheID`

Number

Inherited from DisplayObject: cacheID:162

Returns an ID number that uniquely identifies the current cache for this display object. This can be used to determine if the cache has changed since a previous check.

Default: 0

`canvas`

HTMLCanvasElement | Object

Inherited from Stage: canvas:85

The canvas the stage will render to. Multiple stages can share a single canvas, but you must disable autoClear for all but the first stage that will be ticked (or they will clear each other's render).

When changing the canvas property you must disable the events on the old canvas, and enable events on the new canvas or mouse events will not work as expected. For example:

 myStage.enableDOMEvents(false);
 myStage.canvas = anotherCanvas;
 myStage.enableDOMEvents(true);

`children`

Array

Inherited from Container: children:62

The array of children in the display list. You should usually use the child management methods such as addChild, removeChild, swapChildren, etc, rather than accessing this directly, but it is included for advanced uses.

Default: null

`compositeOperation`

String

Inherited from DisplayObject: compositeOperation:327

The composite operation indicates how the pixels of this display object will be composited with the elements behind it. If null, this property is inherited from the parent container. For more information, read the whatwg spec on compositing.

Default: null

`cursor`

String

Inherited from DisplayObject: cursor:384

A CSS cursor (ex. "pointer", "help", "text", etc) that will be displayed when the user hovers over this display object. You must enable mouseover events using the enableMouseOver method to use this property. Setting a non-null cursor on a Container will override the cursor set on its descendants.

Default: null

`drawRect`

Rectangle

Inherited from Stage: drawRect:119

Specifies the area of the stage to affect when calling update. This can be use to selectively re-draw specific regions of the canvas. If null, the whole canvas area is drawn.

`filters`

Array

Inherited from DisplayObject: filters:348

An array of Filter objects to apply to this display object. Filters are only applied / updated when Cache or UpdateCache is called on the display object, and only apply to the area that is cached.

Default: null

`handleEvent`

Function

Inherited from Stage: handleEvent:436

Default event handler that calls the Stage update method when a tick event is received. This allows you to register a Stage instance as a event listener on Ticker directly, using:

 Ticker.addEventListener("tick", myStage");

Note that if you subscribe to ticks using this pattern, then the tick event object will be passed through to display object tick handlers, instead of delta and paused parameters.

`hitArea`

DisplayObject

Inherited from DisplayObject but overwritten in hitArea:173

The hitArea property is not supported for Stage.

Default: null

`id`

Number

Inherited from DisplayObject: id:171

Unique ID for this display object. Makes display objects easier for some uses.

Default: -1

`INDICES_PER_BOX`

Number final static

Defined in INDICES_PER_BOX:304

The number of indices needed to define a box using triangles. 6 indices = 2 triangles = 1 box

Default: true

`mouseInBounds`

Boolean

Inherited from Stage: mouseInBounds:137

Indicates whether the mouse is currently within the bounds of the canvas.

Default: false

`mouseMoveOutside`

Boolean

Inherited from Stage: mouseMoveOutside:153

If true, mouse move events will continue to be called when the mouse leaves the target canvas. See mouseInBounds, and MouseEvent x/y/rawX/rawY.

Default: false

`mouseX`

Number

Inherited from Stage: mouseX:101

The current mouse X position on the canvas. If the mouse leaves the canvas, this will indicate the most recent position over the canvas, and mouseInBounds will be set to false.

`mouseY`

Number

Inherited from Stage: mouseY:110

The current mouse Y position on the canvas. If the mouse leaves the canvas, this will indicate the most recent position over the canvas, and mouseInBounds will be set to false.

`name`

String

Inherited from DisplayObject: name:204

An optional name for this display object. Included in toString . Useful for debugging.

Default: null

`nextStage`

Stage

Inherited from Stage: nextStage:316

Specifies a target stage that will have mouse / touch interactions relayed to it after this stage handles them. This can be useful in cases where you have multiple layered canvases and want user interactions events to pass through. For example, this would relay mouse events from topStage to bottomStage:

 topStage.nextStage = bottomStage;

To disable relaying, set nextStage to null.

MouseOver, MouseOut, RollOver, and RollOut interactions are also passed through using the mouse over settings of the top-most stage, but are only processed if the target stage has mouse over interactions enabled. Considerations when using roll over in relay targets:

The top-most (first) stage must have mouse over interactions enabled (via enableMouseOver)

All stages that wish to participate in mouse over interaction must enable them via enableMouseOver

All relay targets will share the frequency value of the top-most stage

To illustrate, in this example the targetStage would process mouse over interactions at 10hz (despite passing 30 as it's desired frequency): topStage.nextStage = targetStage; topStage.enableMouseOver(10); targetStage.enableMouseOver(30);

If the target stage's canvas is completely covered by this stage's canvas, you may also want to disable its DOM events using:

targetStage.enableDOMEvents(false);

`NUM_VERTEX_PROPERTIES`

Number final static

Defined in NUM_VERTEX_PROPERTIES:273

The number of properties defined per vertex in p._verticesBuffer. x, y, textureU, textureV, alpha

`NUM_VERTEX_PROPERTIES_PER_BOX`

Number final static

Defined in NUM_VERTEX_PROPERTIES_PER_BOX:294

The number of vertex properties per box.

`numChildren`

Number

Inherited from Container: numChildren:107

Returns the number of children in the container.

`parent`

Container final

Inherited from DisplayObject: parent:213

A reference to the Container or Stage object that contains this display object, or null if it has not been added to one.

Default: null

`rollout`

Inherited from DisplayObject: rollout:596

Available since 0.7.0

This event is similar to mouseout, with the following differences: it does not bubble, and it considers Container instances as an aggregate of their content.

For example, myContainer contains two overlapping children: shapeA and shapeB. The user moves their mouse over shapeA, then directly on to shapeB, then off both. With a listener for Mouseout:event on myContainer, two events would be received, each targeting a child element:

when the mouse leaves shapeA (target=shapeA)

when the mouse leaves shapeB (target=shapeB)

However, with a listener for "rollout" instead, only a single event is received when the mouse leaves the aggregate myContainer content (target=myContainer).

This event must be enabled using enableMouseOver. See the MouseEvent class for a listing of event properties.

`rollover`

Inherited from DisplayObject: rollover:576

Available since 0.7.0

This event is similar to mouseover, with the following differences: it does not bubble, and it considers Container instances as an aggregate of their content.

For example, myContainer contains two overlapping children: shapeA and shapeB. The user moves their mouse over shapeA and then directly on to shapeB. With a listener for Mouseover:event on myContainer, two events would be received, each targeting a child element:

when the mouse enters shapeA (target=shapeA)

when the mouse enters shapeB (target=shapeB)

However, with a listener for "rollover" instead, only a single event is received when the mouse first enters the aggregate myContainer content (target=myContainer).

This event must be enabled using enableMouseOver. See the MouseEvent class for a listing of event properties.

`stagemousedown`

Inherited from Stage: stagemousedown:256

Available since 0.6.0

Dispatched when the user presses their left mouse button on the canvas. See the MouseEvent class for a listing of event properties.

`stagemousemove`

Inherited from Stage: stagemousemove:249

Available since 0.6.0

Dispatched when the user moves the mouse over the canvas. See the MouseEvent class for a listing of event properties.

`stagemouseup`

Inherited from Stage: stagemouseup:263

Available since 0.6.0

Dispatched when the user the user presses somewhere on the stage, then releases the mouse button anywhere that the page can detect it (this varies slightly between browsers). You can use mouseInBounds to check whether the mouse is currently within the stage bounds. See the MouseEvent class for a listing of event properties.

`tick`

Inherited from DisplayObject: tick:642

Available since 0.6.0

Dispatched on each display object on a stage whenever the stage updates. This occurs immediately before the rendering (draw) pass. When update is called, first all display objects on the stage dispatch the tick event, then all of the display objects are drawn to stage. Children will have their Tick:event event dispatched in order of their depth prior to the event being dispatched on their parent.

Event Payload:

target Object

The object that dispatched the event.
type String

The event type.
params Array

An array containing any arguments that were passed to the Stage.update() method. For example if you called stage.update("hello"), then the params would be ["hello"].

`tickend`

Inherited from Stage: tickend:294

Available since 0.7.0

Dispatched each update immediately after the tick event is propagated through the display list. Does not fire if tickOnUpdate is false. Precedes the "drawstart" event.

`tickstart`

Inherited from Stage: tickstart:287

Available since 0.7.0

Dispatched each update immediately before the tick event is propagated through the display list. You can call preventDefault on the event object to cancel propagating the tick event.

APIs

SpriteStage Class

Example

Constructor

SpriteStage

Parameters:

Item Index

Methods

Properties

Events

Methods

_applyFilters

_applyShadow

Parameters:

_cloneProps

Parameters:

Returns:

_createBuffers

Parameters:

_createShader

Parameters:

Returns:

_createShaderProgram

Parameters:

_dispatchEvent

Parameters:

_dispatchMouseEvent

Parameters:

_drawToGPU

Parameters:

_drawWebGLKids

Parameters:

_getBounds

Parameters:

Returns:

_getElementRect

Parameters:

_getFilterBounds

Returns:

_getObjectsUnderPoint

Parameters:

Returns:

_getPointerData

Parameters:

_handleDoubleClick

Parameters:

_handleMouseDown

Parameters:

_handleMouseMove

Parameters:

_handleMouseUp

Parameters:

_handlePointerDown

Parameters:

_handlePointerMove

Parameters:

_handlePointerUp

Parameters:

_initializeWebGL

_initializeWebGLContext

_isMouseOpaque

Returns:

_setClearColor

Parameters:

_setMaxBoxesPoints

Parameters:

_setUpKidTexture

Parameters:

Returns:

_setWebGLContext

Returns:

_testHit

Parameters:

Returns:

_testMask

Parameters:

Returns:

_testMouseOver

Parameters:

_tick

`SpriteStage`

`_applyFilters`

`_applyShadow`

`_cloneProps`

`_createBuffers`

`_createShader`

`_createShaderProgram`

`_dispatchEvent`

`_dispatchMouseEvent`

`_drawToGPU`

`_drawWebGLKids`

`_getBounds`

`_getElementRect`

`_getFilterBounds`

`_getObjectsUnderPoint`

`_getPointerData`

`_handleDoubleClick`

`_handleMouseDown`

`_handleMouseMove`

`_handleMouseUp`

`_handlePointerDown`

`_handlePointerMove`

`_handlePointerUp`

`_initializeWebGL`

`_initializeWebGLContext`

`_isMouseOpaque`

`_setClearColor`

`_setMaxBoxesPoints`

`_setUpKidTexture`

`_setWebGLContext`

`_testHit`

`_testMask`

`_testMouseOver`

`_tick`

`_transformBounds`

`_updatePointerPosition`

`addChild`

`addChildAt`

`addEventListener`

`cache`

`clear`

`clearImageTexture`

`clone`

`cloneChildren`

`contains`

`dispatchEvent`

`draw`

`enableDOMEvents`

`enableMouseOver`

`getBounds`

`getCacheDataURL`

`getChildAt`

`getChildByName`

`getChildIndex`

`getConcatenatedDisplayProps`

`getConcatenatedMatrix`

`getMatrix`

`getNumChildren`

`getObjectsUnderPoint`