pixi.js
    Preparing search index...

    Class LoaderAdvanced

    The Loader is responsible for loading all assets, such as images, spritesheets, audio files, etc. It does not do anything clever with URLs - it just loads stuff! Behind the scenes all things are cached using promises. This means it's impossible to load an asset more than once. Through the use of LoaderParsers, the loader can understand how to load any kind of file!

    It is not intended that this class is created by developers - its part of the Asset class This is the second major system of PixiJS' main Assets class

    Index

    Constructors

    Properties

    Methods

    Constructors

    Properties

    parsers: LoaderParser<any, any, Record<string, any>>[] = ...

    All loader parsers registered

    promiseCache: Record<string, PromiseAndParser> = {}

    Cache loading promises that ae currently active

    Methods

    • Loads one or more assets using the parsers added to the Loader.

      Type Parameters

      • T = any

      Parameters

      • assetsToLoadIn: string | ResolvedAsset<any>

        urls that you want to load, or a single one!

      • OptionalonProgress: (progress: number) => void

        For multiple asset loading only, an optional function that is called when progress on asset loading is made. The function is passed a single parameter, progress, which represents the percentage (0.0 - 1.0) of the assets loaded. Do not use this function to detect when assets are complete and available, instead use the Promise returned by this function.

      Returns Promise<T>

      // Single asset:
      const asset = await Loader.load('cool.png');
      console.log(asset);

      // Multiple assets:
      const assets = await Loader.load(['cool.png', 'cooler.png']);
      console.log(assets);
    • Loads one or more assets using the parsers added to the Loader.

      Type Parameters

      • T = any

      Parameters

      • assetsToLoadIn: string[] | ResolvedAsset<any>[]

        urls that you want to load, or a single one!

      • OptionalonProgress: (progress: number) => void

        For multiple asset loading only, an optional function that is called when progress on asset loading is made. The function is passed a single parameter, progress, which represents the percentage (0.0 - 1.0) of the assets loaded. Do not use this function to detect when assets are complete and available, instead use the Promise returned by this function.

      Returns Promise<Record<string, T>>

      // Single asset:
      const asset = await Loader.load('cool.png');
      console.log(asset);

      // Multiple assets:
      const assets = await Loader.load(['cool.png', 'cooler.png']);
      console.log(assets);
    • function used for testing

      Returns void

    • Unloads one or more assets. Any unloaded assets will be destroyed, freeing up memory for your app. The parser that created the asset, will be the one that unloads it.

      Parameters

      Returns Promise<void>

      // Single asset:
      const asset = await Loader.load('cool.png');

      await Loader.unload('cool.png');

      console.log(asset.destroyed); // true