Question

用来加载一个Image的加载器。 内部使用FileLoader来加载文件，并被 CubeTextureLoader、ObjectLoader、TextureLoader所使用。

代码示例

// 初始化一个加载器
const loader = new THREE.ImageLoader();
// 加载一个图片资源
loader.load(
  // 资源URL
  'textures/skyboxsun25degtest.png',
  // onLoad回调
  function ( image ) {
    // use the image, e.g. draw part of it on a canvas
    const canvas = document.createElement( 'canvas' );
    const context = canvas.getContext( '2d' );
    context.drawImage( image, 100, 100 );
  },
  // 目前暂不支持onProgress的回调
  undefined,
  // onError回调
  function () {
    console.error( 'An error happened.' );
  }
);

请注意three.js r84遗弃了ImageLoader进度事件. 对于支持进度事件的ImageLoader 请参考this thread.

例子

WebGL / loader / obj
WebGL / shaders / ocean

构造方法

ImageLoader( manager : LoadingManager )

manager — 加载器使用的loadingManager，默认为THREE.DefaultLoadingManager.

创建一个新的ImageLoader.

属性

共有属性请参见其基类Loader。

方法

共有方法请参见其基类Loader。

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

url — 文件的URL或者路径，也可以为 Data URI.
onLoad —加载完成时将调用。回调参数为将要加载的image。
onProgress — 此回调函数暂时不支持。
onError — 在加载错误时被调用。

从URL中进行加载，并返回将包含数据的image对象。

源

src/loaders/ImageLoader.js