BufferGeometry
Object3D
Raycaster
Camera
CubeCamera
PerspectiveCamera
OrthographicCamera
StereoCamera
Clock
Curve
CurvePath
Path
Shape
ShapePath
ArrowHelper
AxesHelper
BoxHelper
Box3Helper
CameraHelper
DirectionalLightHelper
GridHelper
PolarGridHelper
HemisphereLightHelper
PlaneHelper
PointLightHelper
SkeletonHelper
SpotLightHelper
Light
PointLight
RectAreaLight
SpotLight
DirectionalLight
HemisphereLight
LightShadow
PointLightShadow
AnimationLoader
AudioLoader
BufferGeometryLoader
CompressedTextureLoader
CubeTextureLoader
DataTextureLoader
FileLoader
ImageBitmapLoader
ImageLoader
Loader
LoaderUtils
MaterialLoader
ObjectLoader
TextureLoader
LoadingManager
Material
Box2
Box3
Color
Cylindrical
Euler
Frustum
Interpolant
Line3
MathUtils
Matrix3
Matrix4
Plane
Quaternion
AnimationAction
AnimationClip
AnimationMixer
AnimationObjectGroup
AnimationUtils
keyframeTrack
PropertyBinding
PropertyMixer
BooleanKeyframeTrack
QuaternionKeyframeTrack
StringKeyframeTrack
Audio
AudioAnalyser
AudioContext
AudioListener
PositionalAudio

FileLoader.load()

概述

FileLoader 类是 Three.js 中的一个工具类,用来加载外部文件数据。其中 load() 方法是用来加载文件的方法。

语法

loader.load(url, onLoad, onProgress, onError);

参数

  • url:必需,表示需要加载的文件的路径或 URL。
  • onLoad:可选,一个加载成功的回调函数。
  • onProgress:可选,一个下载进度的回调函数。
  • onError:可选,一个加载失败的回调函数。

返回值

FileLoader.load() 方法不返回任何内容。

示例

var loader = new THREE.FileLoader();

// 加载器加载成功的回调函数
var onLoad = function(data) {
    console.log(data);
};

// 加载器下载进度的回调函数
var onProgress = function(xhr) {
    console.log((xhr.loaded / xhr.total * 100) + '% loaded');
};

// 加载器加载失败的回调函数
var onError = function(xhr) {
    console.error('An error happened');
};

// 使用加载器加载文件
loader.load('models/model.obj', onLoad, onProgress, onError);

上述示例展示了如何使用 FileLoader 加载一个 obj 模型文件。当加载成功时,onLoad 回调函数将会被调用。在下载过程中,onProgress 回调函数将会被多次调用以报告加载进度。当加载失败时,onError 回调函数将会被调用。

注意事项

  • FileLoader.load() 方法只支持加载文本格式的文件,对于二进制文件,应该使用 THREE.BinaryLoaderTHREE.ImageLoader 等其他加载器。
  • url 参数可以是一个相对路径,也可以是一个绝对路径或 URL。
  • onProgress 回调函数中,xhr.loaded 表示当前已经下载的字节数,xhr.total 表示整个文件的字节数。
  • onError 回调函数中,xhr 对象包含了关于失败的详细信息,可以使用 xhr.statusxhr.responseText 属性来获取。