three.js LoadingManager

2023-02-16 17:44 更新

其功能是处理并跟踪已加载和待处理的数据。如果未手动设置加强管理器,则会为加载器创建和使用默认全局实例加载器管理器。

一般来说,默认的加载管理器已足够使用了,但有时候也需要设置单独的加载器 - 例如,如果你想为对象和纹理显示单独的加载条。

代码示例

下面的例子将介绍,如何使用加载管理器来跟踪 OBJLoader 的加载进度流程。

const manager = new THREE.LoadingManager();
manager.onStart = function ( url, itemsLoaded, itemsTotal ) {

	console.log( 'Started loading file: ' + url + '.\nLoaded ' + itemsLoaded + ' of ' + itemsTotal + ' files.' );

};

manager.onLoad = function ( ) {

	console.log( 'Loading complete!');

};


manager.onProgress = function ( url, itemsLoaded, itemsTotal ) {

	console.log( 'Loading file: ' + url + '.\nLoaded ' + itemsLoaded + ' of ' + itemsTotal + ' files.' );

};

manager.onError = function ( url ) {

	console.log( 'There was an error loading ' + url );

};

const loader = new THREE.OBJLoader( manager );
loader.load( 'file.obj', function ( object ) {

	//

} );

除了观察进度流程之外,还可以使用LoadingManager在加载期间覆写资源URL。当某资源来自拖拽事件、 WebSockets、WebRTC或其他API时,此方法可以有所帮助。下面显示了如何使用Blob URL加载内存模型的示例。

// 将文件拖入网页时创建的Blob或File对象。
const blobs = {'fish.gltf': blob1, 'diffuse.png': blob2, 'normal.png': blob3};

const manager = new THREE.LoadingManager();

// 使用URL回调初始化加载管理器。
const objectURLs = [];
manager.setURLModifier( ( url ) => {

	url = URL.createObjectURL( blobs[ url ] );

	objectURLs.push( url );

	return url;

} );

// 像通常一样加载,然后撤消blob URL
const loader = new THREE.GLTFLoader( manager );
loader.load( 'fish.gltf', (gltf) => {

	scene.add( gltf.scene );

	objectURLs.forEach( ( url ) => URL.revokeObjectURL( url ) );

});

例子

WebGL / loader / fbx
WebGL / loader / obj
WebGL / materials / physical / reflectivity
WebGL / postprocesing / outline

构造方法

LoadingManager( onLoad : Function, onProgress : Function, onError : Function )

onLoad — (可选) 所有加载器加载完成后,将调用此函数。
onProgress — (可选) 当每个项目完成后,将调用此函数。
onError — (可选) 当一个加载器遇到错误时,将调用此函数。
创建一个新的 LoadingManager.

属性

.onStart : Function

此函数在加载开始时被调用。 有如下参数:

url — 被加载的项的url。
itemsLoaded — 目前已加载项的个数。
itemsTotal — 总共所需要加载项的个数。

该函数默认为undefined。

.onLoad : Function

所有的项目加载完成后将调用此函数。默认情况下,该函数是未定义的,除非在构造函数中传入。

.onProgress : Function

此方法加载每一个项,加载完成时进行调用。 有如下参数:

url — 被加载的项的url。
itemsLoaded — 目前已加载项的个数。
itemsTotal — 总共所需要加载项的个数。

默认情况下,该函数为undefined,除非在构造函数中传入。

.onError : Function

此方法将在任意项加载错误时,进行调用。 有如下参数:

url — 加载发生错误的项目的url

默认情况下,该函数为undefined,除非在构造函数中传入。

方法

.addHandler ( regex : Object, loader : Loader ) : this

regex — 正则表达式。

loader — 装载机。

使用给定的正则表达式注册加载程序。可用于定义加载特定文件应使用的加载程序。一个典型的用例是覆盖纹理的默认加载器。

// add handler for TGA textures
manager.addHandler( /\.tga$/i, new TGALoader() );

.getHandler ( file : String ) : Loader

file — 文件路径。

可用于检索给定文件路径的已注册加载程序。

.removeHandler ( regex : Object ) : this

regex — 正则表达式。

删除给定正则表达式的加载程序。

.resolveURL ( url : String ) : String

url — 所要加载的url

给定URL,使用URL修饰符回调(如果有)并返回已解析的URL。如果未设置URL修饰符,则返回原始URL。

.setURLModifier ( callback : Function ) : this

callback — 设置URL修饰符成功时回调。使用url参数进行回调,并且必须返回 resolvedURL 。

如果设置了回调,则在发送请求之前将向每个资源URL传递回调。回调可以返回最初的URL,也可以返回新URL以覆盖加载行为。 此行为可用于从.ZIP、拖拽API和数据URI中加载资源文件。

注意:以下方法被设计为由加载器内部调用。你不应该直接调用它们。

.itemStart ( url : String ) : undefined

url — 所要加载的url

任何使用管理器的加载器都会调用此方法, 当加载器需要开始加载URL时。

.itemEnd ( url : String ) : undefined

url — 所要加载的url

任何使用管理器的加载器都会调用此方法, 当加载器需要加载URL结束时。

.itemError ( url : String ) : undefined

url — 所要加载的url

任何使用管理器的加载器都会调用此方法, 当加载器出现加载错误时。

src/loaders/LoadingManager.js


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号