BitmapFactory.Options.InBitmap Eigenschaft

Definition

Namespace:

Android.Graphics

Assembly:

Mono.Android.dll

Wenn festgelegt, versuchen Sie, Methoden, die das Options-Objekt verwenden, diese Bitmap beim Laden von Inhalten wiederzuverwenden.

[Android.Runtime.Register("inBitmap")]
public Android.Graphics.Bitmap InBitmap { get; set; }

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

Eigenschaftswert

Bitmap

Attribute

RegisterAttribute

Hinweise

Wenn festgelegt, versuchen Sie, Methoden, die das Options-Objekt verwenden, diese Bitmap beim Laden von Inhalten wiederzuverwenden. Wenn der Decodierungsvorgang diese Bitmap nicht verwenden kann, löst die Decodierungsmethode eine java.lang.IllegalArgumentException. Die aktuelle Implementierung erfordert, dass die wiederverwendete Bitmap änderbar ist, und die resultierende wiederverwendete Bitmap bleibt auch dann änderbar, wenn eine Ressource decodiert wird, die normalerweise zu einer unveränderlichen Bitmap führt.</p>

Sie sollten immer noch die zurückgegebene Bitmap der Decodierungsmethode verwenden und nicht davon ausgehen, dass die Wiederverwendung der Bitmap funktioniert hat, aufgrund der oben beschriebenen Einschränkungen und Fehlersituationen, die auftreten können. Die Überprüfung, ob der Rückgabewert dem Wert des inBitmap-Satzes in der Optionsstruktur entspricht, gibt an, ob die Bitmap wiederverwendet wurde. In allen Fällen sollten Sie jedoch die von der Decodierungsfunktion zurückgegebene Bitmap verwenden, um sicherzustellen, dass Sie die Bitmap verwenden, die als Decodierungsziel verwendet wurde.

<h3-Verwendung>mit BitmapFactory</h3>

android.os.Build.VERSION_CODES#KITKATAb diesem Zeitpunkt kann jede veränderbare Bitmap wiederverwendet BitmapFactory werden, um alle anderen Bitmaps zu decodieren, solange das Ergebnis Bitmap#getByteCount() byte count der decodierten Bitmap kleiner oder gleich der Bitmap#getAllocationByteCount() allocated byte count wiederverwendeten Bitmap ist. Dies kann darauf zurückzuführen sein, dass die systeminterne Größe kleiner ist oder die Größe nach der Skalierung (für Dichte/ Stichprobengröße) kleiner ist.

<p class="note">Prior to android.os.Build.VERSION_CODES#KITKAT additional constraints apply: The image being decoded (whether as a resource or as a stream) must be in jpeg or png format. Es werden nur Bitmaps gleicher Größe unterstützt, wobei #inSampleSize sie auf 1 festgelegt sind. Darüber hinaus setzt die android.graphics.Bitmap.Config configuration wiederverwendete Bitmap die Einstellung von #inPreferredConfig, falls festgelegt, außer Kraft.</p>

<h3-Verwendung>mit BitmapRegionDecoder</h3>

BitmapRegionDecoder zeichnet den angeforderten Inhalt in die bereitgestellte Bitmap, clipping, wenn die Größe des Ausgabeinhalts (nach der Skalierung) größer als die bereitgestellte Bitmap ist. Die bereitgestellte Bitmap-Breite, -Höhe und Bitmap.Config -Größe werden nicht geändert.

<p class="note">BitmapRegionDecoder-Unterstützung für #inBitmap wurde in android.os.Build.VERSION_CODES#JELLY_BEANeingeführt. Alle von BitmapRegionDecoder unterstützten Formate unterstützen die Bitmap-Wiederverwendung über #inBitmap.

Java-Dokumentation für android.graphics.BitmapFactory.Options.inBitmap.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.