📄 threejs/Addons/Loaders/IESLoader

File: IESLoader.md | Updated: 11/15/2025


title: IESLoader category: Addons layout: docs

IESLoader

A loader for the IES format.

The loaded texture should be assigned to IESSpotLight#map.

Code Example

const loader = new IESLoader();
const texture = await loader.loadAsync( 'ies/007cfb11e343e2f42e3b476be4ab684e.ies' );
const spotLight = new THREE.IESSpotLight( 0xff0000, 500 );
spotLight.iesMap = texture;

Import

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

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

Constructor

new IESLoader( manager : LoadingManager )

Constructs a new IES 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 )

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

url | The path/URL of the file 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

.parse( text : string ) : DataTexture

Parses the given IES data.

text | The raw IES data.
---|---

Overrides: Loader#parse

Returns: THE IES data as a texture.

Source

examples/jsm/loaders/IESLoader.js