---

title: TextureLoader category: Core layout: docs

TextureLoader

Class for loading textures. Images are internally loaded via ImageLoader.

Please note that TextureLoader has dropped support for progress events in r84. For a TextureLoader that supports progress events, see this thread.

Code Example

const loader = new THREE.TextureLoader();
const texture = await loader.loadAsync( 'textures/land_ocean_ice_cloud_2048.jpg' );
const material = new THREE.MeshBasicMaterial( { map:texture } );

Constructor

new TextureLoader( manager : LoadingManager )

Constructs a new texture loader.

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

Methods

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

Starts loading from the given URL and pass the fully loaded texture to the onLoad() callback. The method also returns a new texture object which can directly be used for material creation. If you do it this way, the texture may pop up in your scene once the respective loading process is finished.

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 | Unsupported in this loader.
onError | Executed when errors occur.

Overrides: Loader#load

Returns: The texture.

Source

src/loaders/TextureLoader.js