[page:Loader] →

# [name]

加载[page:CubeTexture CubeTexture]的一个类。 内部使用[page:ImageLoader]来加载文件。

The loaded [page:CubeTexture] is in sRGB color space. Meaning the [page:Texture.colorSpace colorSpace] property is set to `THREE.SRGBColorSpace` by default.

## 代码示例

`const scene = new THREE.Scene(); scene.background = new THREE.CubeTextureLoader() .setPath( 'textures/cubeMaps/' ) .load( [ 'px.png', 'nx.png', 'py.png', 'ny.png', 'pz.png', 'nz.png' ] );`

## 例子

[example:webgl_materials_cubemap materials / cubemap]
[example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic]
[example:webgl_materials_cubemap_refraction materials / cubemap / refraction]

## 构造函数

### [name]( [param:LoadingManager manager] )

[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager]。默认为[page:LoadingManager THREE.DefaultLoadingManager].
创建一个新的[name].

## 属性

共有属性请参见其基类[page:Loader]。

## 方法

共有方法请参见其基类[page:Loader]。

### [method:null load]( [param:String urls], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )

[page:String urls] — 数组长度为6的图像数组，数组内容为URL，每一个URL用于CubeTexture的每一侧。 这些URL将被指定顺序: pos-x, neg-x, pos-y, neg-y, pos-z, neg-z. 数组内容也可以为 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URIs].
请注意，一般来说，在立方体贴图坐标系中，当查找positive-z轴时，positive-x表示右侧 - 换句话说，此坐标系使用左手坐标系。 由于three.js使用右手坐标系， 环境贴图将在three.js进行pos-x和neg-x进行交互.
[page:Function onLoad] — 加载完成时将调用。回调参数是已被加载的[page:Texture texture].
[page:Function onProgress] — 将在加载过程中进行调用。参数为XMLHttpRequest实例， 其中包含 [page:Integer total] 和 [page:Integer loaded] 字节。
[page:Function onError] — 在加载错误时被调用。

从URL中进行加载，并将被加载的[page:Texture texture]传递给onLoad。

## 源

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]