[page:Loader] →

# [name]

Una classe per il caricamento di una [page:Texture texture]. Utilizza internamente l'[page:ImageLoader] per caricare i file.

## Codice di Esempio

`const texture = new THREE.TextureLoader().load( 'textures/land_ocean_ice_cloud_2048.jpg' ); // utilizza immediatamente la texture per la creazione del materiale const material = new THREE.MeshBasicMaterial( { map: texture } );`

## Codice di Esempio con le Callback

`// istanzia un loader const loader = new THREE.TextureLoader(); // carica una risorsa loader.load( // URL della risorsa 'textures/land_ocean_ice_cloud_2048.jpg', // onLoad callback function ( texture ) { // nell'esempio viene creato il materiale quando la texture è caricata const material = new THREE.MeshBasicMaterial( { map: texture } ); }, // la callback onProgress al momento non è supportata undefined, // onError callback function ( err ) { console.error( 'An error happened.' ); } );`

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

## Esempi

[example:webgl_geometry_cube geometry / cube]

## 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:Texture 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] (opzionale) — Verrà chiamato quando il caricamento sarà completato. L'argomento sarà la [page:Texture texture] caricata.
[page:Function onProgress] (opzionale) — Questa callback al momento non è supportata.
[page:Function onError] (opzionale) — Verrà chiamato in caso di errori di caricamento.
Inizia il caricamento dall'url e passa la [page:Texture texture] completamente caricata al metodo onLoad. Il metodo, inoltre, restituisce un nuovo oggetto texture che può essere direttamente utilizzato per la creazione del materiale. Se lo fai in questo modo, la texture potrebbe apparire nella scena una volta che il processo di caricamento è terminato.

## Source

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