---

title: UltraHDRLoader category: Addons layout: docs

UltraHDRLoader

A loader for the Ultra HDR Image Format.

Existing HDR or EXR textures can be converted to Ultra HDR with this tool.

Current feature set:

• JPEG headers (required)
• XMP metadata (required)
• XMP validation (not implemented)
• EXIF profile (not implemented)
• ICC profile (not implemented)
• Binary storage for SDR & HDR images (required)
• Gainmap metadata (required)
• Non-JPEG image formats (not implemented)
• Primary image as an HDR image (not implemented)

Code Example

const loader = new UltraHDRLoader();
const texture = await loader.loadAsync( 'textures/equirectangular/ice_planet_close.jpg' );
texture.mapping = THREE.EquirectangularReflectionMapping;
scene.background = texture;
scene.environment = texture;

Import

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

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

Constructor

new UltraHDRLoader( manager : LoadingManager )

Constructs a new Ultra HDR loader.

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

Properties

.type : HalfFloatType | FloatType

The texture type.

Default is HalfFloatType.

Methods

.load( url : string, onLoad : function, onProgress : onProgressCallback, onError : onErrorCallback ) : DataTexture

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

url | The path/URL of the files to be loaded. This can also be a data URI.
---|---
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 Ultra HDR texture.

.parse( buffer : ArrayBuffer, onLoad : function )

Parses the given Ultra HDR texture data.

buffer | The raw texture data.
---|---
onLoad | The onLoad callback.

Overrides: Loader#parse

.setDataType( value : HalfFloatType | FloatType ) : UltraHDRLoader

Sets the texture type.

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

Returns: A reference to this loader.

Source

examples/jsm/loaders/UltraHDRLoader.js