Loader →

ImageBitmapLoader

Загрузчик для загрузки Image в качестве ImageBitmap. ImageBitmap обеспечивает асинхронный и ресурсоэффективный способ подготовки текстур для рендеринга в WebGL.
В отличие от FileLoader, ImageBitmapLoader не прекращает несколько одновременных запросов к одному и тому же URL.

Обратите внимание, что Texture.flipY и Texture.premultiplyAlpha с ImageBitmap игнорируются. ImageBitmap нуждается в этих настройках при создании растрового изображения в отличие от обычных изображений, которым они нужны при загрузке на GPU. Вам нужно установить эквивалентные параметры через ImageBitmapLoader.setOptions вместо этого. Подробности см. в [ссылка:https://www.khronos.org/registry/webgl/specs/latest/1.0/#6.10 WebGL specification].

Пример


    // instantiate a loader
    const loader = new v3d.ImageBitmapLoader();

    // set options if needed
    loader.setOptions({ imageOrientation: 'flipY' });

    // load a image resource
    loader.load(
      // resource URL
      'textures/skyboxsun25degtest.png',

      // onLoad callback
      function(imageBitmap) {
        const texture = new v3d.CanvasTexture(imageBitmap);
        const material = new v3d.MeshBasicMaterial({ map: texture });
      },

      // onProgress callback currently not supported
      undefined,

      // onError callback
      function(err) {
        console.log('An error happened');
      }
    );

Конструктор

ImageBitmapLoader(manager : LoadingManager)

manager — loadingManager для использования загрузчиком. По умолчанию v3d.DefaultLoadingManager.

Создает новый ImageBitmapLoader.

Свойства

Общие свойства см. в базовом классе Loader.

# .options : String

Необязательный объект, задающий параметры для используемого внутри фабричного метода createImageBitmap. По умолчанию undefined.

Методы

Общие методы см. в базовом классе Loader.

# .load(url : String, onLoad : Function, onProgress : Function, onError : Function) → null

url — путь или URL-адрес к файлу. Это также может быть Data URI.
onLoad — Будет вызван после завершения загрузки. Аргументом будет загруженный image.
onProgress — Эта функция обратного вызова в настоящее время не поддерживается.
onError — Вызывается при ошибках загрузки.

Начните загрузку из url и верните объект image, который будет содержать данные.

# .setOptions(options : Object) → ImageBitmapLoader

Устанавливает объект опций для createImageBitmap.

Исходный файл

О том как получить исходный код этого модуля читайте тут.