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 70

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 199

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 76

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 220

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 255

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 89

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 273

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 104

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 238

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 167

addTilemap(key, url, 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.
`mapData`	object	The tilemap data object.
`format`	number	The format of the tilemap data.

Source:

loader/Cache.js, line 150

addTileset(key, url, data, tileWidth, tileHeight, tileMax, tileMargin, tileSpacing)

Add a new tile set in to the cache.

Parameters:

Name	Type	Argument	Default	Description
`key`	string			The unique key by which you will reference this object.
`url`	string			URL of this tile set file.
`data`	object			Extra tile set data.
`tileWidth`	number			Width of the sprite sheet.
`tileHeight`	number			Height of the sprite sheet.
`tileMax`	number			How many tiles stored in the sprite sheet.
`tileMargin`	number	<optional>	0	If the tiles have been drawn with a margin, specify the amount here.
`tileSpacing`	number	<optional>	0	If the tiles have been drawn with spacing between them, specify the amount here.

Source:

loader/Cache.js, line 126

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 382

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 350

destroy()

Clears the cache. Removes every local cache object reference.

Source:

loader/Cache.js, line 768

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 365

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 521

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 487

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 504

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 470

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 400

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 698

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 674

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 573

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 591

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 708

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 656

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 718

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 555

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 538

Returns:

The frame data you want.

Type: Phaser.Frame

getTilemap(key) → {Object}

Get tilemap data by key.

Parameters:

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

Source:

loader/Cache.js, line 453

Returns:

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

Type: Object

getTileset(key) → {Phaser.Tileset}

Get tile set image data by key.

Parameters:

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

Source:

loader/Cache.js, line 435

Returns:

The tileset data. The tileset image is in the data property, the tile data in tileData.

Type: Phaser.Tileset

getTileSetImage(key) → {object}

Get tile set image data by key.

Parameters:

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

Source:

loader/Cache.js, line 417

Returns:

The image data you want.

Type: object

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 609

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 625

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 638

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 300

reloadSoundComplete(key)

Description.

Parameters:

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

Source:

loader/Cache.js, line 321

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 728

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 738

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 748

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 758

updateSound(key)

Description.

Parameters:

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

Source:

loader/Cache.js, line 336