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'); } );

Примеры

WebGL / loader / ImageBitmap

Конструктор

ImageBitmapLoader(manager : LoadingManager)

managerloadingManager для использования загрузчиком. По умолчанию 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.

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

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