[page:Loader] →

# [name]

Un loader per il caricamento di un'[page:Image]. Questa classe viene utilizzata internamente dalle classi [page:CubeTextureLoader], [page:ObjectLoader] e [page:TextureLoader].

## Codice di Esempio

`// istanzia un loader const loader = new THREE.ImageLoader(); // carica un'immagine loader.load( // URL della risorsa 'textures/skyboxsun25degtest.png', // onLoad callback function ( image ) { // utilizza l'immagine, per esempio disegna una parte di essa nel canvas const canvas = document.createElement( 'canvas' ); const context = canvas.getContext( '2d' ); context.drawImage( image, 100, 100 ); }, // la callback onProgress non è al momento supportata undefined, // onError callback function () { console.error( 'An error happened.' ); } );`

Si noti che la versione r84 di three.js ha eliminato il supporto per gli eventi di avanzamento di ImageLoader. Per un ImageLoader che supporti gli eventi di avanzamento, vedi [link:https://github.com/mrdoob/three.js/issues/10439#issuecomment-275785639 questo thread].

## Esempi

[example:webgl_loader_obj WebGL / loader / obj]
[example:webgl_shaders_ocean WebGL / shaders / ocean]

## Costruttore

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

[page:LoadingManager manager] — Il [page:LoadingManager loadingManager] del loader da utilizzare. Il valore predefinito è [page:LoadingManager THREE.DefaultLoadingManager].
Crea un nuovo [name].

## Proprietà

Vedi la classe base [page:Loader] per le proprietà comuni.

## Metodi

Vedi la classe base [page:Loader] per i metodi comuni.

### [method:HTMLImageElement load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )

[page:String url] — Il path o URL del file. Questo può anche essere un [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].
[page:Function onLoad] — Verrà chiamato quando il caricamento sarà completato. L'argomento sarà l'[page:Image immagine] caricata.
[page:Function onProgress] (opzionale) — Questa funzione di callback non è al momento supportata.
[page:Function onError] (opzionale) — Verrà chiamato in caso di errori di caricamento.

Inizia il caricamento dall'url e restituisce l'oggetto [page:ImageBitmap immagine] che conterrà i dati.

## Source

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