three 加载器（一）

BufferGeometryLoader

用来加载BufferGeometry的加载器。 内部使用FileLoader来加载文件。

// 初始化一个加载器 
var loader = new THREE.BufferGeometryLoader(); 
// 加载资源 
loader.load( 
  // 资源URL 
  'models/json/pressure.json', 
  // onLoad回调 
  function ( geometry ) { 
    var material = new THREE.MeshLambertMaterial( { color: 0xF5F5F5 } ); 
    var object = new THREE.Mesh( geometry, material ); 
    scene.add( object ); 
  }, 
  // onProgress回调 
  function ( xhr ) { 
    console.log( (xhr.loaded / xhr.total * 100) + '% loaded' ); 
  }, 
  // onError回调 
  function ( err ) { 
    console.log( 'An error happened' ); 
  } 
);

构造函数

BufferGeometryLoader( manager : LoadingManager )

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

创建一个新的BufferGeometryLoader.

属性

# .manager : LoadingManager

正在使用的loadingManager。默认为DefaultLoadingManager.

方法

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

url — 文件的URL或者路径，也可以为 Data URI.d
onLoad — 加载完成时将调用。回调参数为将要加载的BufferGeometry.
onProgress — 将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含total和loaded字节。
onError —在加载错误时被调用。

从URL中进行加载，并将已经以解析的响应内容传递给onLoad。

# .parse ( json : Object ) : BufferGeometry

json — 所需要解析的JSON结构。

解析一个JSON结构，并返回BufferGeometry.

CompressedTextureLoader

基于块的纹理加载器 (dds, pvr, ...)的抽象类。 内部使用FileLoader来加载文件。请参考DDSLoader 和PVRLoader 子类的例子

构造函数

CompressedTextureLoader( manager : LoadingManager )

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

创建一个新的CompressedTextureLoader.

属性

# .manager : LoadingManager

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

# .path : String

加载的基本路径。请参考.setPath。默认为undefined.

方法

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

url — 文件的URL或者路径，也可以为 Data URI.
onLoad — 加载完成时将调用。回调参数为将要加载的纹理。
onProgress — 将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含total和loaded字节。
onError — 在加载错误时被调用。

从URL中进行加载，并将被加载的纹理传递给onLoad。

# .setPath ( path : String ) : FileLoader

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

Cache

一个简单的缓存系统，内部使用FileLoader。

WebGL / geometry / text
WebGL / interactive / instances / gpu
WebGL / loader / ttf

Usage

要在所有使用FileLoader的加载器上启用缓存， 需设置

THREE.Cache.enabled = true.

属性

# .enabled : Boolean

是否启用缓存，默认为false.

# .files : Object

一个object所持有的缓存文件。

方法

# .add ( key : String, file ) : null

key — 通过引用缓存文件的key。
file — 所被缓存的文件

使用key为引用文件增加一个缓存入口。如果该key已持有一个文件，则会被覆盖。

# .get ( key : String ) : null

key — 一个字符串key

获得该key的值。 如果该key不存在，则以undefined被返回。

# .remove ( key : String ) : null

key — 引用缓存文件的一个字符串key

使用key来删除相应的缓存文件。

# .clear () : null

清除所有缓存中的值。