Condividi tramite


BitmapFactory.Options.InBitmap Proprietà

Definizione

Se impostato, i metodi decodifica che accettano l'oggetto Options tenteranno di riutilizzare questa bitmap durante il caricamento del contenuto.

[Android.Runtime.Register("inBitmap")]
public Android.Graphics.Bitmap InBitmap { get; set; }
[<Android.Runtime.Register("inBitmap")>]
member this.InBitmap : Android.Graphics.Bitmap with get, set

Valore della proprietà

Attributi

Commenti

Se impostato, i metodi decodifica che accettano l'oggetto Options tenteranno di riutilizzare questa bitmap durante il caricamento del contenuto. Se l'operazione di decodifica non può usare questa bitmap, il metodo decode genererà un'eccezione java.lang.IllegalArgumentException. L'implementazione corrente richiede che la bitmap riutilizzata sia modificabile e che la bitmap riutilizzata risultante continui a rimanere modificabile anche quando si decodifica una risorsa che normalmente comporta una bitmap non modificabile.</p>

È comunque consigliabile usare sempre la bitmap restituita del metodo di decodifica e non si presuppone che il riutilizzo della bitmap abbia funzionato, a causa dei vincoli descritti in precedenza e situazioni di errore che possono verificarsi. Controllare se il valore restituito corrisponde al valore del set inBitmap nella struttura Options indicherà se la bitmap è stata riutilizzata, ma in tutti i casi è consigliabile usare la bitmap restituita dalla funzione di decodifica per assicurarsi di usare la bitmap usata come destinazione decodifica.

<utilizzo h3>con BitmapFactory</h3>

A partire da android.os.Build.VERSION_CODES#KITKAT, qualsiasi bitmap modificabile può essere riutilizzata da BitmapFactory per decodificare qualsiasi altra bitmap, purché il risultato Bitmap#getByteCount() byte count della bitmap decodificata sia minore o uguale a quello Bitmap#getAllocationByteCount() allocated byte count della bitmap riutilizzata. Ciò può essere dovuto al fatto che le dimensioni intrinseche sono minori o le dimensioni del post-ridimensionamento (per la densità/dimensione del campione) sono più piccole.

<p class="note">Prima di android.os.Build.VERSION_CODES#KITKAT applicare vincoli aggiuntivi: l'immagine da decodificare (sia come risorsa che come flusso) deve essere in formato jpeg o png. Sono supportate solo bitmap di dimensioni uguali, con #inSampleSize impostato su 1. Inoltre, l'oggetto android.graphics.Bitmap.Config configuration della bitmap riutilizzata eseguirà l'override dell'impostazione di #inPreferredConfig, se impostato.</p>

<h3>Usage with BitmapRegionDecoder</h3>

BitmapRegionDecoder disegnerà il contenuto richiesto nella bitmap fornita, ritagliando se le dimensioni del contenuto di output (post ridimensionamento) sono maggiori della bitmap fornita. La larghezza, l'altezza Bitmap.Config e la larghezza della bitmap specificate non verranno modificate.

<p class="note">BitmapRegionDecoder support for #inBitmap è stato introdotto in android.os.Build.VERSION_CODES#JELLY_BEAN. Tutti i formati supportati da BitmapRegionDecoder supportano il riutilizzo bitmap tramite #inBitmap.

Documentazione java per android.graphics.BitmapFactory.Options.inBitmap.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a