本文简介
本文介绍 Three.js
的基础方法:监听材质加载。
在 《Three.js 基础纹理贴图》 里介绍了如何给图形贴图,贴图前需要先把纹理加载好。我们基于这篇文章继续讲解如何监听材质加载成功或者失败。
监听单个材质
我们使用 TextureLoader
的 load()
方法加载纹理时,第一个参数传入纹理的路径,之后还可以多接受3个函数类型的参数。
根据 Three.js 的 TextureLoader.load 文档介绍,这几个参数是:
- 【参数1】
url
: 文件的URL或者路径。 - 【参数2】
onLoad
: 材质加载完时调用 - 【参数3】
onProgress
: 材质加载过程中调用,实例包含total
和loaded
。但文档说了在Three.js r84
时启用了TextureLoader
进度事件。 - 【参数4】
onError
: 在加载错误时被调用。
先上一个官方的例子
代码语言:javascript复制// 初始化一个加载器
const loader = new THREE.TextureLoader();
// 加载一个资源
loader.load(
// 【参数1】资源URL
'textures/land_ocean_ice_cloud_2048.jpg',
// 【参数2】onLoad回调
function ( texture ) {
// 【才材质加载成功后执行】
const material = new THREE.MeshBasicMaterial( {
map: texture
} );
},
// 【参数3】目前暂不支持onProgress的回调
undefined,
// 【参数4】onError回调,
function ( err ) {
console.error( '材质加载失败' );
}
)
从官网给出的例子中可以看到,【参数3】原本用来监听材质加载进度的 onProgress()
方法用了 undefined
来代替占着位。
监听多个材质
如果要加载多个材质,我们可以使用 LoadingManager
来监听,这个方法可以配合 TextureLoader
一起用的。
LoadingManager
可以监听材质加载结果(成功或失败),也可以监听材质加载进度。
LoadingManager(onLoad, onProgress, onError)
接受3个回调函数,作用分别是:
onLoad
: (可选) 所有加载器加载完成后,将调用此函数。onProgress
: (可选) 当每个项目完成后,将调用此函数。onError
: (可选) 当一个加载器遇到错误时,将调用此函数。
我们需要在 new THREE.TextureLoader(loadingManager)
时将 loadingManager
传入。9
举个例子:
代码语言:javascript复制// 省略部分代码
// 设置加载管理器
const loadingManager = new THREE.LoadingManager(
function() {
console.log('图片加载完成')
},
function(url, loaded, total) {
console.log(`图片加载中,本次加载的材质${url},第 ${loaded}/${total} 个材质`)
},
function(err) {
console.log('图片加载失败', err)
}
)
// Three提供的纹理加载器
const textureLoader = new THREE.TextureLoader(loadingManager)
// 导入纹理贴图基础贴图
const imgTexture1 = textureLoader.load('../assets/images/140.jpg')
const imgTexture2 = textureLoader.load('../assets/images/141.jpg')
此时控制台会依次输出
代码语言:javascript复制图片加载中,本次加载的材质../assets/images/140.jpg,第 1/2 个材质
图片加载中,本次加载的材质../assets/images/141.jpg,第 2/2 个材质
图片加载完成
这是在 140.jpg
和 141.jpg
都存在的情况下会这样输出。
假设要加载2个材质,其中一个材质是存在的,另一个材质不存在,就会分别输出每个材质的结果。
代码语言:javascript复制// 省略部分代码
// 导入纹理贴图基础贴图
const imgTexture1 = textureLoader.load('../assets/images/140.jpg') // 该材质是存在的
const imgTexture2 = textureLoader.load('../assets/images/100.jpg') // 该材质不存在
这种情况会这样输出:
代码语言:javascript复制图片加载失败 ../assets/images/13.jpg
图片加载中,本次加载的材质../assets/images/13.jpg,第 1/2 个材质
图片加载中,本次加载的材质../assets/images/140.jpg,第 2/2 个材质
图片加载完成
可以在 onError
里监听到当前哪个材质加载失败,参数会将加载失败的材质路径返回给开发者。
日常开发推荐使用 LoadingManager
,尤其是要监听加载多个材质时,用 LoadingManager
可以帮我们实现加载进度条。