[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]