TextureLoader - Verge3D 用户手册 - Soft8Soft
Description: 了解如何在使用 Verge3D 制作的交互式 3D 应用程序中使用 TextureLoader

Loader →

# TextureLoader

加载texture的一个类。 内部使用ImageLoader来加载文件。

## 代码示例

`const texture = new v3d.TextureLoader().load('textures/land_ocean_ice_cloud_2048.jpg'); // 立即使用纹理进行材质创建 const material = new v3d.MeshBasicMaterial({ map: texture });`

## Code Example with Callbacks

`// 初始化一个加载器 const loader = new v3d.TextureLoader(); // 加载一个资源 loader.load( // 资源URL 'textures/land_ocean_ice_cloud_2048.jpg', // onLoad回调 function(texture) { // in this example we create the material when the texture is loaded const material = new v3d.MeshBasicMaterial({ map: texture }); }, // 目前暂不支持onProgress的回调 undefined, // onError回调 function(err) { console.error('An error happened.'); } );`

请注意Verge3D r84遗弃了TextureLoader进度事件。对于支持进度事件的TextureLoader ， 请参考this thread。

## 构造函数

### TextureLoader(manager : LoadingManager)

manager — 加载器使用的loadingManager，默认值为v3d.DefaultLoadingManager.
创建一个新的TextureLoader.

## 属性

共有属性请参见其基类Loader。

## 方法

共有方法请参见其基类Loader。

### # .load(url : String, onLoad : Function, onProgress : Function, onError : Function) → Texture

url — 文件的URL或者路径，也可以为 Data URI.
onLoad — 加载完成时将调用。回调参数为将要加载的texture.
onProgress — 将在加载过程中进行调用。参数为XMLHttpRequest实例，实例包含total和loaded字节。
onError — 在加载错误时被调用。
从给定的URL开始加载并将完全加载的texture传递给onLoad。该方法还返回一个新的纹理对象，该纹理对象可以直接用于材质创建。 如果采用此方法，一旦相应的加载过程完成，纹理可能会在场景中出现。

## 源

src/loaders/TextureLoader.js