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	This event is dispatched when the sound system is unlocked via a touch event on cellular devices.

Source:

loader/Cache.js, line 77

Methods

addBitmapData(key, bitmapData) → {Phaser.BitmapData}

Add a BitmapData object in to the cache.

Parameters:

Name	Type	Description
`key`	string	Asset key for this BitmapData.
`bitmapData`	Phaser.BitmapData	The BitmapData object to be addded to the cache.

Source:

loader/Cache.js, line 96

Returns:

The BitmapData object to be addded to the cache.

Type: Phaser.BitmapData

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 221

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 83

addDefaultImage()

Adds a default image to be used in special cases such as WebGL Filters. Is mapped to the key __default.

Source:

loader/Cache.js, line 242

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 295

addMissingImage()

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

Source:

loader/Cache.js, line 260

addRenderTexture(key, texture)

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.
`texture`	Phaser.Texture	The texture to use as the base of the RenderTexture.

Source:

loader/Cache.js, line 111

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 314

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 126

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 278

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 189

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 172

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 148

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 441

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 390

destroy()

Clears the cache. Removes every local cache object reference.

Source:

loader/Cache.js, line 828

getBitmapData(key) → {Phaser.BitmapData}

Get a BitmapData object from the cache by its key.

Parameters:

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

Source:

loader/Cache.js, line 423

Returns:

The requested BitmapData object if found, or null if not.

Type: Phaser.BitmapData

getCanvas(key) → {object}

Get a canvas 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 405

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 581

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 547

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 564

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 530

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 459

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 758

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 734

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 633

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 651

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 768

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 716

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 778

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 615

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 598

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 513

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 495

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 477

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 669

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 685

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 698

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 340

reloadSoundComplete(key)

Description.

Parameters:

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

Source:

loader/Cache.js, line 361

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 788

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 798

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 808

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 818

updateSound(key)

Description.

Parameters:

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

Source:

loader/Cache.js, line 376