Phaser Class: Cache

new Cache(game)

Phaser.Cache constructor.

Parameters:

Name	Type	Description
`game`	Phaser.Game	A reference to the currently running game.

Source:

loader/Cache.js, line 16

Members

game

Properties:

Name	Type	Description
`game`	Phaser.Game	Local reference to game.

Source:

loader/Cache.js, line 21

onSoundUnlock

Properties:

Name	Type	Description
`onSoundUnlock`	Phaser.Signal	Description.

Source:

loader/Cache.js, line 65

Methods

addBitmapFont(key, url, data, xmlData)

Add a new Bitmap Font.

Parameters:

Name	Type	Description
`key`	string	The unique key by which you will reference this object.
`url`	string	URL of this font xml file.
`data`	object	Extra font data.
`xmlData`	object	Texture atlas frames data.

Source:

loader/Cache.js, line 172

addCanvas(key, canvas, context)

Add a new canvas object in to the cache.

Parameters:

Name	Type	Description
`key`	string	Asset key for this canvas.
`canvas`	HTMLCanvasElement	Canvas DOM element.
`context`	CanvasRenderingContext2D	Render context of this canvas.

Source:

loader/Cache.js, line 71

addDefaultImage()

Adds a default image to be used when a key is wrong / missing. Is mapped to the key __default.

Source:

loader/Cache.js, line 193

addImage(key, url, data)

Add a new image.

Parameters:

Name	Type	Description
`key`	string	The unique key by which you will reference this object.
`url`	string	URL of this image file.
`data`	object	Extra image data.

Source:

loader/Cache.js, line 213

addRenderTexture(key, textue)

Add a new Phaser.RenderTexture in to the cache.

Parameters:

Name	Type	Description
`key`	string	The unique key by which you will reference this object.
`textue`	Phaser.Texture	The texture to use as the base of the RenderTexture.

Source:

loader/Cache.js, line 84

addSound(key, url, data, webAudio, audioTag)

Add a new sound.

Parameters:

Name	Type	Description
`key`	string	Asset key for the sound.
`url`	string	URL of this sound file.
`data`	object	Extra sound data.
`webAudio`	boolean	True if the file is using web audio.
`audioTag`	boolean	True if the file is using legacy HTML audio.

Source:

loader/Cache.js, line 231

addSpriteSheet(key, url, data, frameWidth, frameHeight, frameMax)

Add a new sprite sheet in to the cache.

Parameters:

Name	Type	Description
`key`	string	The unique key by which you will reference this object.
`url`	string	URL of this sprite sheet file.
`data`	object	Extra sprite sheet data.
`frameWidth`	number	Width of the sprite sheet.
`frameHeight`	number	Height of the sprite sheet.
`frameMax`	number	How many frames stored in the sprite sheet.

Source:

loader/Cache.js, line 99

addText(key, url, data)

Add a new text data.

Parameters:

Name	Type	Description
`key`	string	Asset key for the text data.
`url`	string	URL of this text data file.
`data`	object	Extra text data.

Source:

loader/Cache.js, line 323

addTextureAtlas(key, url, data, atlasData, format)

Add a new texture atlas.

Parameters:

Name	Type	Description
`key`	string	The unique key by which you will reference this object.
`url`	string	URL of this texture atlas file.
`data`	object	Extra texture atlas data.
`atlasData`	object	Texture atlas frames data.
`format`	number	The format of the texture atlas.

Source:

loader/Cache.js, line 140

addTilemap(key, url, data, mapData, format)

Add a new tilemap.

Parameters:

Name	Type	Description
`key`	string	The unique key by which you will reference this object.
`url`	string	URL of the tilemap image.
`data`	object	Tilemap data.
`mapData`	object	The tilemap data object.
`format`	number	The format of the tilemap data.

Source:

loader/Cache.js, line 121

checkImageKey(key) → {boolean}

Checks if an image key exists.

Parameters:

Name	Type	Description
`key`	string	Asset key of the image you want.

Source:

loader/Cache.js, line 357

Returns:

True if the key exists, otherwise false.

Type: boolean

decodedSound(key, data)

Add a new decoded sound.

Parameters:

Name	Type	Description
`key`	string	Asset key for the sound.
`data`	object	Extra sound data.

Source:

loader/Cache.js, line 308

destroy()

Clears the cache. Removes every local cache object reference.

Source:

loader/Cache.js, line 707

getCanvas(key) → {object}

Get acanvas object from the cache by its key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the canvas you want.

Source:

loader/Cache.js, line 340

Returns:

The canvas you want.

Type: object

getFrame(key) → {Phaser.Frame}

Get a single frame by key. You'd only do this to get the default Frame created for a non-atlas/spritesheet image.

Parameters:

Name	Type	Description
`key`	string	Asset key of the frame data you want.

Source:

loader/Cache.js, line 460

Returns:

The frame data you want.

Type: Phaser.Frame

getFrameByIndex(key) → {Phaser.Frame}

Get a single frame out of a frameData set by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the frame data you want.

Source:

loader/Cache.js, line 426

Returns:

The frame data you want.

Type: Phaser.Frame

getFrameByName(key) → {Phaser.Frame}

Get a single frame out of a frameData set by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the frame data you want.

Source:

loader/Cache.js, line 443

Returns:

The frame data you want.

Type: Phaser.Frame

getFrameData(key) → {Phaser.FrameData}

Get frame data by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the frame data you want.

Source:

loader/Cache.js, line 409

Returns:

The frame data you want.

Type: Phaser.FrameData

getImage(key) → {object}

Get image data by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the image you want.

Source:

loader/Cache.js, line 375

Returns:

The image data you want.

Type: object

getImageKeys() → {Array}

Returns an array containing all of the keys of Images in the Cache.

Source:

loader/Cache.js, line 637

Returns:

The string based keys in the Cache.

Type: Array

getKeys(array) → {Array}

Get the cache keys from a given array of objects. Normally you don't call this directly but instead use getImageKeys, getSoundKeys, etc.

Parameters:

Name	Type	Description
`array`	Array	An array of items to return the keys for.

Source:

loader/Cache.js, line 613

Returns:

The array of item keys.

Type: Array

getSound(key) → {Phaser.Sound}

Get sound by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the sound you want.

Source:

loader/Cache.js, line 512

Returns:

The sound you want.

Type: Phaser.Sound

getSoundData(key) → {object}

Get sound data by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the sound you want.

Source:

loader/Cache.js, line 530

Returns:

The sound data you want.

Type: object

getSoundKeys() → {Array}

Returns an array containing all of the keys of Sounds in the Cache.

Source:

loader/Cache.js, line 647

Returns:

The string based keys in the Cache.

Type: Array

getText(key) → {object}

Get text data by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the text data you want.

Source:

loader/Cache.js, line 595

Returns:

The text data you want.

Type: object

getTextKeys() → {Array}

Returns an array containing all of the keys of Text Files in the Cache.

Source:

loader/Cache.js, line 657

Returns:

The string based keys in the Cache.

Type: Array

getTexture(key) → {Phaser.RenderTexture}

Get a RenderTexture by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the RenderTexture you want.

Source:

loader/Cache.js, line 494

Returns:

The RenderTexture you want.

Type: Phaser.RenderTexture

getTextureFrame(key) → {Phaser.Frame}

Get a single frame by key. You'd only do this to get the default Frame created for a non-atlas/spritesheet image.

Parameters:

Name	Type	Description
`key`	string	Asset key of the frame data you want.

Source:

loader/Cache.js, line 477

Returns:

The frame data you want.

Type: Phaser.Frame

getTilemap(key) → {Phaser.Tilemap}

Get tilemap data by key.

Parameters:

Name	Type	Description
`key`	string	Asset key of the tilemap you want.

Source:

loader/Cache.js, line 392

Returns:

The tilemap data. The tileset image is in the data property, the map data in mapData.

Type: Phaser.Tilemap

isSoundDecoded(key) → {boolean}

Check if the given sound has finished decoding.

Parameters:

Name	Type	Description
`key`	string	Asset key of the sound you want.

Source:

loader/Cache.js, line 548

Returns:

The decoded state of the Sound object.

Type: boolean

isSoundReady(key) → {boolean}

Check if the given sound is ready for playback. A sound is considered ready when it has finished decoding and the device is no longer touch locked.

Parameters:

Name	Type	Description
`key`	string	Asset key of the sound you want.

Source:

loader/Cache.js, line 564

Returns:

True if the sound is decoded and the device is not touch locked.

Type: boolean

isSpriteSheet(key) → {boolean}

Check whether an image asset is sprite sheet or not.

Parameters:

Name	Type	Description
`key`	string	Asset key of the sprite sheet you want.

Source:

loader/Cache.js, line 577

Returns:

True if the image is a sprite sheet.

Type: boolean

reloadSound(key)

Reload a sound.

Parameters:

Name	Type	Description
`key`	string	Asset key for the sound.

Source:

loader/Cache.js, line 258

reloadSoundComplete(key)

Description.

Parameters:

Name	Type	Description
`key`	string	Asset key for the sound.

Source:

loader/Cache.js, line 279

removeCanvas(key)

Removes a canvas from the cache.

Parameters:

Name	Type	Description
`key`	string	Key of the asset you want to remove.

Source:

loader/Cache.js, line 667

removeImage(key)

Removes an image from the cache.

Parameters:

Name	Type	Description
`key`	string	Key of the asset you want to remove.

Source:

loader/Cache.js, line 677

removeSound(key)

Removes a sound from the cache.

Parameters:

Name	Type	Description
`key`	string	Key of the asset you want to remove.

Source:

loader/Cache.js, line 687

removeText(key)

Removes a text from the cache.

Parameters:

Name	Type	Description
`key`	string	Key of the asset you want to remove.

Source:

loader/Cache.js, line 697

updateSound(key)

Description.

Parameters:

Name	Type	Description
`key`	string	Asset key for the sound.

Source:

loader/Cache.js, line 294