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