three.js 图片加载器

ImageBitmapLoader

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

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

构造函数

ImageBitmapLoader( manager : LoadingManager )

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

创建一个新的ImageBitmapLoader.

属性

# .manager : LoadingManager

加载器正在使用的loadingManager ，默认为DefaultLoadingManager.

# .options : String

一个可选对象，用来设置内部使用的createImageBitmap工厂方法， 默认为undefined.

# .path : String

所要加载文件的基本路径。 请参考.setPath，默认为undefined。

方法

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

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

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

# .setCrossOrigin () : ImageBitmapLoader

此方法出于兼容性原因而存在，并且不实现逻辑。它确保ImageBitmapLoader具有ImageLoader的类似接口。

# .setOptions ( options : Object ) : ImageBitmapLoader

设置createImageBitmap的选项对象。

# .setPath ( path : String ) : ImageBitmapLoader

设置加载文件的基本路径或URL。当加载同一目录中下的许多图片时，此方法将很有用。

ImageLoader

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

// 初始化一个加载器 
var 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 var canvas = document.createElement( 'canvas' ); var context = canvas.getContext( '2d' ); context.drawImage( image, 100, 100 ); }, // 目前暂不支持onProgress的回调 undefined, // onError回调 function () { console.error( 'An error happened.' ); } 
);

构造方法

ImageLoader( manager : LoadingManager )

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

创建一个新的ImageLoader.

属性

# .crossOrigin : String

如果设置了，在开始加载前， 将为图片分配 crossOrigin 属性，其值为 crossOrigin, 默认为"anonymous"。

# .manager : LoadingManager

加载器正在使用的loadingManager，默认值为DefaultLoadingManager.

# .path : String

所要加载文件的基本路径。 请参考.setPath，默认为undefined。

方法

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

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

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

# .setCrossOrigin ( value : String ) : null

设置.crossOrigin的属性。

# .setPath ( path : String ) : FileLoader

设置加载文件的基本路径或URL。当加载同一目录中下的许多图片时，此方法将很有用。