Class: Loader

PIXI.Loader

new PIXI.Loader (baseUrl, concurrency)

The new loader, extends Resource Loader by Chad Engler: https://github.com/englercj/resource-loader

const loader = PIXI.Loader.shared; // PixiJS exposes a premade instance for you to use.
//or
const loader = new PIXI.Loader(); // you can also create your own if you want

const sprites = {};

// Chainable `add` to enqueue a resource
loader.add('bunny', 'data/bunny.png')
      .add('spaceship', 'assets/spritesheet.json');
loader.add('scoreFont', 'assets/score.fnt');

// Chainable `pre` to add a middleware that runs for each resource, *before* loading that resource.
// This is useful to implement custom caching modules (using filesystem, indexeddb, memory, etc).
loader.pre(cachingMiddleware);

// Chainable `use` to add a middleware that runs for each resource, *after* loading that resource.
// This is useful to implement custom parsing modules (like spritesheet parsers, spine parser, etc).
loader.use(parsingMiddleware);

// The `load` method loads the queue of resources, and calls the passed in callback called once all
// resources have loaded.
loader.load((loader, resources) => {
    // resources is an object where the key is the name of the resource loaded and the value is the resource object.
    // They have a couple default properties:
    // - `url`: The URL that the resource was loaded from
    // - `error`: The error that happened when trying to load (if any)
    // - `data`: The raw data that was loaded
    // also may contain other properties based on the middleware that runs.
    sprites.bunny = new PIXI.TilingSprite(resources.bunny.texture);
    sprites.spaceship = new PIXI.TilingSprite(resources.spaceship.texture);
    sprites.scoreFont = new PIXI.TilingSprite(resources.scoreFont.texture);
});

// throughout the process multiple signals can be dispatched.
loader.onProgress.add(() => {}); // called once per loaded/errored file
loader.onError.add(() => {}); // called once per errored file
loader.onLoad.add(() => {}); // called once per loaded file
loader.onComplete.add(() => {}); // called once when the queued resources all load.
Name Type Default Description
baseUrl string '' optional

The base url for all resources loaded by this loader.

concurrency number 10 optional

The number of resources to load concurrently.

See:

Members

PIXI.Loader.shared PIXI.Loader static

A premade instance of the loader that can be used to load resources.

Dispatched when completely loaded all resources.

Dispatched once per errored resource.

Dispatched once per loaded resource.

Dispatched once per loaded or errored resource.

Dispatched when the loader begins to loading process.

Methods

PIXI.Loader.registerPlugin (plugin)PIXI.Loader static

Adds a Loader plugin for the global shared loader and all new Loader instances created.

Name Type Description
plugin PIXI.ILoaderPlugin

The plugin to add

Returns:
Type Description
PIXI.Loader Reference to PIXI.Loader for chaining

destroy ()

Destroy the loader, removes references.

off () Deprecated : since 5.0.0

Use the corresponding signal, e.g., event start` is signal onStart.

on () Deprecated : since 5.0.0

Use the corresponding signal, e.g., event start` is signal onStart.

once () Deprecated : since 5.0.0

Use the corresponding signal, e.g., event start` is signal onStart.

Type Definitions

PIXI.Loader.ICallbackID object

PIXI.Loader.ILoaderSignal

Properties:
Name Type Description
add ISignalCallback

Register callback

once ISignalCallback

Register oneshot callback

detach ISignalDetach

Detach specific callback by ID

PIXI.Loader.ISignalCallback (callback, context)ICallbackID

Name Type Description
callback function

Callback function

context object optional

Context

Returns:
Type Description
ICallbackID
  • CallbackID

PIXI.Loader.ISignalDetach (id)

Name Type Description
id ICallbackID

CallbackID returned by add/once methods

PIXI.Loader.loaderMiddleware (resource, next)

Name Type Description
resource PIXI.LoaderResource
next function