---

title: HDRCubeTextureLoader category: Addons layout: docs

HDRCubeTextureLoader

A loader for loading HDR cube textures.

Code Example

const loader = new HDRCubeTextureLoader();
loader.setPath( 'textures/cube/pisaHDR/' );
const cubeTexture = await loader.loadAsync( [ 'px.hdr', 'nx.hdr', 'py.hdr', 'ny.hdr', 'pz.hdr', 'nz.hdr' ] );
scene.background = cubeTexture;
scene.environment = cubeTexture;

Import

HDRCubeTextureLoader is an addon, and must be imported explicitly, see Installation#Addons.

import { HDRCubeTextureLoader } from 'three/addons/loaders/HDRCubeTextureLoader.js';

Constructor

new HDRCubeTextureLoader( manager : LoadingManager )

Constructs a new HDR cube texture loader.

manager | The loading manager.
---|---

Properties

.hdrLoader : HDRLoader

The internal HDR loader that loads the individual textures for each cube face.

.type : HalfFloatType | FloatType

The texture type.

Default is HalfFloatType.

Methods

.load( urls : Array.<string>, onLoad : function, onProgress : onProgressCallback, onError : onErrorCallback ) : CubeTexture

Starts loading from the given URLs and passes the loaded HDR cube texture to the onLoad() callback.

urls | The paths/URLs of the files to be loaded. This can also be a data URIs.
---|---
onLoad | Executed when the loading process has been finished.
onProgress | Executed while the loading is in progress.
onError | Executed when errors occur.

Overrides: Loader#load

Returns: The HDR cube texture.

.setDataType( value : HalfFloatType | FloatType ) : HDRCubeTextureLoader

Sets the texture type.

value | The texture type to set.
---|---

Returns: A reference to this loader.

Source

examples/jsm/loaders/HDRCubeTextureLoader.js