three.js Loader

Loader

所有加载器的基类

构造函数

Loader( manager : LoadingManager )

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

创建一个新的Loader。

var loadingManager = new THREE.LoadingManager();
loadingManager.onLoad = function () {
    console.log('All resources loaded');
};
loadingManager.onProgress = function (item, loaded, total) {
    console.log('Loading... ' + loaded + '/' + total + ' ' + item.url);
};
loadingManager.onError = function (url) {
    console.log('Error loading ' + url);
};

属性

.crossOrigin : String

crossOrigin 字符串用于实现 CORS ，以从允许 CORS 的其他域加载url。 默认为anonymous。

.manager : LoadingManager

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

.path : String

将从中加载资产的基本路径。 默认为空字符串。

.resourcePath : String

将从中加载额外资源（例如纹理贴图）的基本路径。 默认为空字符串。

.requestHeader : Object

request header 在 HTTP 请求中使用。 请参考 .setRequestHeader。 默认为 undefined。

方法

.load () : void

该方法需要被所有具体的加载器来实现。它包含了从后端加载资产的逻辑。

.loadAsync ( url : String, onProgress : Function ) : Promise

url — 一个字符串，包含要加载的文件的路径/URL。
onProgress — （可选）加载过程中将会被调用的函数。参数将是一个XMLHttpRequest实例，其包含了 .total （总）字节数和 .loaded （已加载）字节数。

该函数等效于.load，但返回的是一个 Promise。

onLoad 由 Promise.resolve 处理，而 onError 则由 Promise.reject 处理。

.parse () : void

该方法需要被所有具体的加载器来实现。它包含了解析资产到 three.js 实体的逻辑。

.setCrossOrigin ( crossOrigin : String ) : Loader

crossOrigin — crossOrigin字符串用于实现CORS，以从允许CORS的其它域加载url。

.setPath ( path : String ) : Loader

path — 设置资产的基本路径。

.setResourcePath ( resourcePath : String ) : Loader

resourcePath — 设置独立资源（如纹理贴图）的基本路径。

.setRequestHeader ( requestHeader : Object ) : Loader

requestHeader - key: 要设置header的名称。 value：要设置header的值。

设置在 HTTP 请求中使用的 request header（请求头）。

LoaderUtils

具有多个实用的加载器函数功能的对象

函数

# .decodeText ( array : TypedArray ) : String

array — 作为类型化数组的字节流

该函数将字节流作为输入并返回字符串作为表示。

# .extractUrlBase ( url : string ) : String

url — 从基本URL中，进行提取的URL。

从URL中提取基本信息。