Un loader per il caricamento di un'[page:Image]. Questa classe viene utilizzata internamente dalle classi [page:CubeTextureLoader], [page:ObjectLoader] e [page:TextureLoader].
// 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].
[example:webgl_loader_obj WebGL / loader / obj]
[example:webgl_shaders_ocean WebGL / shaders / ocean]
[page:LoadingManager manager] — Il [page:LoadingManager loadingManager] del loader da utilizzare. Il valore predefinito è [page:LoadingManager THREE.DefaultLoadingManager].
Crea un nuovo [name].
Vedi la classe base [page:Loader] per le proprietà comuni.
Vedi la classe base [page:Loader] per i metodi comuni.
[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.
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]