其功能时处理并跟踪已加载和待处理的数据。如果未手动设置加强管理器,则会为加载器创建和使用默认全局实例加载器管理器
- 请参阅 [page:DefaultLoadingManager].
一般来说,默认的加载管理器已足够使用了,但有时候也需要设置单独的加载器 - 例如,如果你想为对象和纹理显示单独的加载条。
[example:webgl_loader_babylon WebGL / loader / babylon]
[example:webgl_loader_fbx WebGL / loader / fbx]
[example:webgl_loader_obj WebGL / loader / obj]
[example:webgl_materials_reflectivity WebGL / materials / reflectivity]
[example:webgl_postprocessing_outline WebGL / postprocesing / outline]
[example:webgl_terrain_dynamic WebGL / terrain / dynamic]
下面的例子将介绍,如何使用加载管理器来跟踪 [page:OBJLoader] 的加载进度流程。
var manager = new v3d.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);
};
var loader = new v3d.OBJLoader(manager);
loader.load('file.obj', function(object) {
//
});
除了观察进度流程之外,还可以使用LoadingManager在加载期间覆写资源URL。当某资源来自拖拽事件、 WebSockets、WebRTC或其他API时,此方法可以有所帮助。下面显示了如何使用Blob URL加载内存模型的示例。
// 将文件拖入网页时创建的Blob或File对象。
var blobs = {'fish.gltf': blob1, 'diffuse.png': blob2, 'normal.png': blob3};
var manager = new v3d.LoadingManager();
// 使用URL回调初始化加载管理器。
var objectURLs = [];
manager.setURLModifier((url) => {
url = URL.createObjectURL(blobs[url]);
objectURLs.push(url);
return url;
});
// 像通常一样加载,然后撤消blob URL
var loader = new v3d.GLTFLoader(manager);
loader.load('fish.gltf', (gltf) => {
scene.add(gltf.scene);
objectURLs.forEach((url) => URL.revokeObjectURL(url));
});
[page:Function onLoad] — (可选) 所有加载器加载完成后,将调用此函数。
[page:Function onProgress] — (可选) 当每个项目完成后,将调用此函数。
[page:Function onError] — (可选) 当一个加载器遇到错误时,将调用此函数。
创建一个新的 [name].
此换上咋加载开始时,被调用.
有如下参数:
[page:String url] — 被加载的项的url。
[page:Integer itemsLoaded] — 目前已加载项的个数。
[page:Iteger itemsTotal] — 总共所需要加载项的个数。
此方法默认时未定义。
所有的项加载完成后将调用此函数。默认情况下,此方法时未定义的,除非在构造函数中进行传递。
此方法加载每一个项,加载完成时进行调用。
有如下参数:
[page:String url] — 被加载的项的url。
[page:Integer itemsLoaded] — 目前已加载项的个数。
[page:Iteger itemsTotal] — 总共所需要加载项的个数。
默认情况下,此方法时未定义的,除非在构造函数中进行传递。
此方法将在任意项加载错误时,进行调用。
有如下参数:
[page:String url] — 所加载出错误的项的url
默认情况下,此方法时未定义的,除非在构造函数中进行传递。
[page:Function callback] —
设置URL修饰符成功时回调。使用url参数进行回调,并且必须返回 [page:String resolvedURL] 。
如果设置了回调,则在发送请求之前将向每个资源URL传递回调。回调可以返回最初的URL,也可以返回新URL以覆盖加载行为。
此行为可用于从.ZIP、拖拽API和数据URI中加载资源文件。
[page:String url] — 所要加载的url
给定URL,使用URL修饰符回调(如果有)并返回已解析的URL。如果未设置URL修饰符,则返回原始URL。
Note: The following methods are designed to be called internally by loaders. You shouldn't call them directly.
[page:String url] — 所要加载的url
任何使用管理器的加载器都会调用此方法, 当加载器需要开始加载URL时。
[page:String url] — 所要加载的url
任何使用管理器的加载器都会调用此方法, 当加载器需要加载URL结束时。
[page:String url] — 所要加载的url
任何使用管理器的加载器都会调用此方法, 当加载器出现加载错误时。