[page:Loader] →

# [name]

Un loader per caricare un'[page:Image] come un'[link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap]. Un'ImageBitmap fornisce un percorso asincrono ed efficiente in termini di risorse per preparare le texture per la visualizzazione in WebGL.
A differenza del [page:FileLoader], [name] non permette richieste multiple concorrenti per lo stesso URL.

Si noti che [page:Texture.flipY] e [page:Texture.premultiplyAlpha] con [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap] vengono ignorati. [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap ImageBitmap] necessita di queste configurazioni per la creazione di bitmap a differenza delle immagini regolari per il caricamento su GPU. È invece necessario impostare le opzioni equivalenti tramite [page:ImageBitmapLoader.setOptions]. Fare riferimento alle [link:https://www.khronos.org/registry/webgl/specs/latest/1.0/#6.10 specifiche WebGL] per i dettagli.

## Codice di Esempio

`// istanzia un loader const loader = new THREE.ImageBitmapLoader(); // imposta le opzioni se necessario loader.setOptions( { imageOrientation: 'flipY' } ); // carica un'immagine loader.load( // URL della risorsa 'textures/skyboxsun25degtest.png', // onLoad callback function ( imageBitmap ) { const texture = new THREE.CanvasTexture( imageBitmap ); const material = new THREE.MeshBasicMaterial( { map: texture } ); }, // la callback onProgress non è al momento supportata undefined, // onError callback function ( err ) { console.log( 'An error happened' ); } );`

## Esempi

[example:webgl_loader_imagebitmap WebGL / loader / ImageBitmap]

## 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.

### [property:Boolean isImageBitmapLoader]

Flag di sola lettura per verificare se l'oggetto dato è di tipo [name].

### [property:String options]

Un oggetto opzionale che imposta le opzioni per il metodo factory [link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap] utilizzato internamente. Il valore predefinito è `undefined`.

## Metodi

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

### [method:undefined 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.

### [method:this setOptions]( [param:Object options] )

Imposta l'oggetto opzioni per [link:https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/createImageBitmap createImageBitmap].

## Source

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