PixiJS

Class: CanvasPrepare

PIXI.prepare.CanvasPrepare

The prepare manager provides functionality to upload content to the GPU This cannot be done directly for Canvas like in WebGL, but the effect can be achieved by drawing textures to an offline canvas. This draw call will force the texture to be moved onto the GPU.

An instance of this class is automatically created by default, and can be found at renderer.plugins.prepare

new PIXI.prepare.CanvasPrepare (renderer)

CanvasPrepare.js:20
Name Type Description
renderer PIXI.CanvasRenderer

A reference to the current renderer

Extends

Members

limiter PIXI.prepare.CountLimiter | PIXI.prepare.TimeLimiter inherited

The limiter to be used to control how quickly items are prepared.

renderer PIXI.AbstractRenderer protected inherited

Reference to the renderer.

uploadHookHelper PIXI.prepare.CanvasPrepare | PIXI.Renderer protected inherited overrides

The only real difference between CanvasPrepare and WebGLPrepare is what they pass to upload hooks. That different parameter is stored here.

Methods

add (item)PIXI.CanvasPrepare inherited

BasePrepare.js:281

Manually add an item to the uploading queue.

Name Type Description
item PIXI.DisplayObject | PIXI.Container | PIXI.BaseTexture | PIXI.Texture | PIXI.Graphics | PIXI.Text | *

Object to add to the queue
Returns:
Type Description
PIXI.CanvasPrepare Instance of plugin for chaining.

destroy () overrides

CanvasPrepare.js:55

Destroys the plugin, don't use after this.

registerFindHook (addHook)PIXI.BasePrepare inherited

BasePrepare.js:247

Adds hooks for finding items.

Name Type Description
addHook function

Function call that takes two parameters: item:*, queue:Array function must return true if it was able to add item to the queue.
Returns:
Type Description
PIXI.BasePrepare Instance of plugin for chaining.

registerUploadHook (uploadHook)PIXI.BasePrepare inherited

BasePrepare.js:264

Adds hooks for uploading items.

Name Type Description
uploadHook function

Function call that takes two parameters: prepare:CanvasPrepare, item:* and function must return true if it was able to handle upload of item.
Returns:
Type Description
PIXI.BasePrepare Instance of plugin for chaining.

upload (item, done) inherited

BasePrepare.js:140

Upload all the textures and graphics to the GPU.

Name Type Description
item function | PIXI.DisplayObject | PIXI.Container | PIXI.BaseTexture | PIXI.Texture | PIXI.Graphics | PIXI.Text

Either the container or display object to search for items to upload, the items to upload themselves, or the callback function, if items have been added using prepare.add.
done function optional

Optional callback when all queued uploads have completed