語言

BitmapFactory.Options.InBitmap 屬性

定義

若設定為 Options,採用 Options 物件的解碼方法會在載入內容時嘗試重用此位圖。

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

屬性值

提供現有的位圖作為解碼像素的儲存空間。

屬性

備註

若設定為 Options,採用 Options 物件的解碼方法會在載入內容時嘗試重用此位圖。 若解碼操作無法使用此位圖,解碼方法將拋出一個 java.lang.IllegalArgumentException。 目前實作要求重複使用的位圖必須是可變的,且即使解碼資源,該重複使用的位圖仍會保持可變性,而資源通常會產生不可變的位圖。</p>

你仍然應該使用解碼方法回傳的位圖,不要假設重複使用點陣圖有效,因為上述限制和可能發生的失敗情況。 檢查回傳值是否與 Options 結構中 inBitmap 設定的值相符,會顯示該位圖是否被重複使用,但無論如何,你都應該使用解碼函式回傳的位圖,以確保你使用的是作為解碼目的地的位圖。

<h3>使用 BitmapFactory</h3>

從 起 android.os.Build.VERSION_CODES#KITKAT,任何可變位圖都可以重複使用 BitmapFactory ,只要解碼後的位 Bitmap#getByteCount() byte count 圖結果小於或等 Bitmap#getAllocationByteCount() allocated byte count 於重複使用的位圖。 這可能是因為內在尺寸較小,或縮放後(密度/樣本量)尺寸較小。

在附加限制生效前 android.os.Build.VERSION_CODES#KITKAT :被解碼的影像(無論是作為資源或串流)必須為 jpeg 或 png 格式。 僅支援大小相等的位圖, #inSampleSize 且設為 1。 此外,重複使用的位圖 會 android.graphics.Bitmap.Config configuration 覆寫 的 #inPreferredConfig設定(如果設定為 )。

<h3>與 BitmapRegionDecoder</h3 的使用>

BitmapRegionDecoder 會將其請求的內容繪製到所提供的位圖中,若輸出內容大小(縮放後)大於所提供位圖,則會裁剪。 所提供的位圖寬度、高度 Bitmap.Config 和資訊不會被更改。

BitmapRegionDecoder 支援 #inBitmap 於 android.os.Build.VERSION_CODES#JELLY_BEAN於 。 BitmapRegionDecoder 支援的所有格式都支援透過 #inBitmapT. 重用位圖。

Java 文件 android.graphics.BitmapFactory.Options.inBitmap。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於