ImageBitmapLoader

一个把Image加载为ImageBitmap的加载器。 ImageBitmap提供了一种异步且有效的资源的途径，用于在WebGL中渲染的纹理。
不像FileLoader, ImageBitmapLoader无需避免对同一的URL进行多次请求。

Note that Texture.flipY and Texture.premultiplyAlpha with ImageBitmap are ignored. ImageBitmap needs these configuration on bitmap creation unlike regular images need them on uploading to GPU. You need to set the equivalent options via ImageBitmapLoader.setOptions instead. Refer to WebGL specification for the detail.

代码示例

// 初始化一个加载器
const loader = new THREE.ImageBitmapLoader();
// set options if needed
loader.setOptions( { imageOrientation: 'flipY' } );
// 加载一个图片资源
loader.load(
  // 资源的URL
  'textures/skyboxsun25degtest.png',
  // onLoad回调
  function ( imageBitmap ) {
    const texture = new THREE.CanvasTexture( imageBitmap );
    const material = new THREE.MeshBasicMaterial( { map: texture } );
  },
  // 目前暂不支持onProgress的回调
  undefined,
  // onError回调
  function ( err ) {
    console.log( 'An error happened' );
  }
);

例子

WebGL / loader / ImageBitmap

构造函数

ImageBitmapLoader( manager : LoadingManager )

manager — 加载器使用的loadingManager，默认为THREE.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的选项对象。

源

src/loaders/ImageBitmapLoader.js