ImageBitmapLoader - Руководство по Вердж3Д - Софт Эйт Софт
Description: Узнайте как использовать ImageBitmapLoader в интерактивных 3Д-веб-приложениях сделанных на Вердж3Д

Loader →

# ImageBitmapLoader

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

Обратите внимание, что Texture.flipY и Texture.premultiplyAlpha с ImageBitmap игнорируются. ImageBitmap нуждается в этих настройках при создании растрового изображения в отличие от обычных изображений, которым они нужны при загрузке на GPU. Вам нужно установить эквивалентные параметры через ImageBitmapLoader.setOptions вместо этого. Подробности см. в WebGL specification.

## Пример

`// создаём загрузчик const loader = new v3d.ImageBitmapLoader(); // устанавливаем опции loader.setOptions({ imageOrientation: 'flipY' }); // загружаем ресурс loader.load( // URL ресурса 'mytexture.png', // обработчик onLoad function(imageBitmap) { const texture = new v3d.CanvasTexture(imageBitmap); const material = new v3d.MeshBasicMaterial({ map: texture }); }, // обработчик onProgress не поддерживается undefined, // обработчик onError function(err) { console.log('An error happened'); } );`

## Конструктор

### ImageBitmapLoader(manager : LoadingManager)

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

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

## Свойства

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

### # .isImageBitmapLoader : Boolean

Флаг, указывающий что данный объект является экземпляром ImageBitmapLoader. Только для чтения.

### # .options : String

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

## Методы

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

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

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

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

### # .setOptions(options : Object) → ImageBitmapLoader

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

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

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