Skip to main content
Version: Phaser v4.0.0-rc.6

ImageFile

A single Image File suitable for loading by the Loader.

These are created when you use the Phaser.Loader.LoaderPlugin#image method and are not typically created directly.

For documentation about what all the arguments and configuration options mean please see Phaser.Loader.LoaderPlugin#image.

Constructor

new ImageFile(loader, key, [url], [xhrSettings], [frameConfig])

Parameters

nametypeoptionaldescription
loaderPhaser.Loader.LoaderPluginNoA reference to the Loader that is responsible for this file.
keystring | Phaser.Types.Loader.FileTypes.ImageFileConfigNoThe key to use for this file, or a file configuration object.
urlstring | Array.<string>YesThe absolute or relative URL to load this file from. If undefined or null it will be set to <key>.png, i.e. if key was "alien" then the URL will be "alien.png".
xhrSettingsPhaser.Types.Loader.XHRSettingsObjectYesExtra XHR Settings specifically for this file.
frameConfigPhaser.Types.Loader.FileTypes.ImageFrameConfigYesThe frame configuration object. Only provided for, and used by, Sprite Sheets.

Scope: static

Extends

Phaser.Loader.File

Source: src/loader/filetypes/ImageFile.js#L15
Since: 3.0.0

Inherited Methods

From Phaser.Loader.File:


Public Methods

addToCache

<instance> addToCache()

Description:

Adds this file to its target cache upon successful loading and processing.

Overrides: Phaser.Loader.File#addToCache

Source: src/loader/filetypes/ImageFile.js#L189
Since: 3.7.0


onProcess

<instance> onProcess()

Description:

Called automatically by Loader.nextFile.

This method controls what extra work this File does with its loaded data.

Overrides: Phaser.Loader.File#onProcess

Source: src/loader/filetypes/ImageFile.js#L98
Since: 3.7.0


Inherited Members

From Phaser.Loader.File: