Bitmap.CreateBitmap 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
CreateBitmap(DisplayMetrics, Int32[], Int32, Int32, Int32, Int32, Bitmap+Config)
回傳一個不變的位圖，包含指定的寬度與高度，且每個像素值設定為顏色陣列中對應的值。
[Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;[IIIIILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(Android.Util.DisplayMetrics display, int[] colors, int offset, int stride, int width, int height, Android.Graphics.Bitmap.Config config);[<Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;[IIIIILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : Android.Util.DisplayMetrics * int[] * int * int * int * int * Android.Graphics.Bitmap.Config -> Android.Graphics.Bitmap參數
- display
- DisplayMetrics
此點陣圖將繪製的顯示指標。
- colors
- Int32[]
T T：Android.Graphics._Color 陣列用於初始化像素。
- offset
- Int32
在顏色陣列中，第一個顏色之前要跳過的數值。
- stride
- Int32
陣列間的顏色數量（必須為 >= 寬度或 <= -width）。
- width
- Int32
點陣圖的寬度
- height
- Int32
點陣圖的高度
- config
- Bitmap.Config
要建立點陣圖設定。 若設定不支援每像素 alpha（例如 RGB_565），則色彩[] 中的 alpha 位元組將被忽略（假設為 FF）
傳回
- 屬性
例外狀況
若寬度或高度為 <= 0，或色彩陣列的長度小於像素數。
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Bitmap, Int32, Int32, Int32, Int32, Matrix, Boolean)
回傳來源位圖子集的位圖，並由可選矩陣轉換。
[Android.Runtime.Register("createBitmap", "(Landroid/graphics/Bitmap;IIIILandroid/graphics/Matrix;Z)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(Android.Graphics.Bitmap source, int x, int y, int width, int height, Android.Graphics.Matrix? m, bool filter);[<Android.Runtime.Register("createBitmap", "(Landroid/graphics/Bitmap;IIIILandroid/graphics/Matrix;Z)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : Android.Graphics.Bitmap * int * int * int * int * Android.Graphics.Matrix * bool -> Android.Graphics.Bitmap參數
- source
- Bitmap
我們正在子設定的位圖
- x
- Int32
源中第一個像素的 x 座標
- y
- Int32
源中第一個像素的 y 座標
- width
- Int32
每列的像素數
- height
- Int32
列數
- m
- Matrix
可選的矩陣可套用於像素
- filter
- Boolean
如果應該過濾來源，那是真的。 只有當矩陣包含不只是平移時才適用。
傳回
一個代表來源指定子集的位圖
- 屬性
例外狀況
若 x、y、width、height 值不在來源位圖的尺寸範圍內，或寬度為 <= 0，或高度為 <= 0 則為
備註
回傳來源位圖子集的位圖，並由可選矩陣轉換。 新的位圖可能是與原始碼相同的物件，或是已經複製了。 它初始化時的密度和色彩空間與原始位圖相同。
若來源點陣圖不可變且請求的子集與來源點陣相同，則會回傳原始點陣圖，且不會產生新的點陣圖。
回傳的位圖將永遠可變，除非在以下情境下：（1） 當回傳來源位圖且來源位圖不可變時
（2） 來源位圖是硬體位圖。 這等 #getConfig() 價於 Config#HARDWARE
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Int32[], Int32, Int32, Int32, Int32, Bitmap+Config)
回傳一個不變的位圖，包含指定的寬度與高度，且每個像素值設定為顏色陣列中對應的值。
[Android.Runtime.Register("createBitmap", "([IIIIILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(int[] colors, int offset, int stride, int width, int height, Android.Graphics.Bitmap.Config config);[<Android.Runtime.Register("createBitmap", "([IIIIILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : int[] * int * int * int * int * Android.Graphics.Bitmap.Config -> Android.Graphics.Bitmap參數
- colors
- Int32[]
T T：Android.Graphics._Color 陣列用於初始化像素。
- offset
- Int32
在顏色陣列中，第一個顏色之前要跳過的數值。
- stride
- Int32
陣列間的顏色數量（必須為 >= 寬度或 <= -width）。
- width
- Int32
點陣圖的寬度
- height
- Int32
點陣圖的高度
- config
- Bitmap.Config
要建立點陣圖設定。 若設定不支援每像素 alpha（例如 RGB_565），則色彩[] 中的 alpha 位元組將被忽略（假設為 FF）
傳回
- 屬性
例外狀況
若寬度或高度為 <= 0，或色彩陣列的長度小於像素數。
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(DisplayMetrics, Int32, Int32, Bitmap+Config, Boolean, ColorSpace)
回傳一個可變的位圖，寬度與高度皆為指定。
[Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;IILandroid/graphics/Bitmap$Config;ZLandroid/graphics/ColorSpace;)Landroid/graphics/Bitmap;", "", ApiSince=26)]
public static Android.Graphics.Bitmap CreateBitmap(Android.Util.DisplayMetrics? display, int width, int height, Android.Graphics.Bitmap.Config config, bool hasAlpha, Android.Graphics.ColorSpace colorSpace);[<Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;IILandroid/graphics/Bitmap$Config;ZLandroid/graphics/ColorSpace;)Landroid/graphics/Bitmap;", "", ApiSince=26)>]
static member CreateBitmap : Android.Util.DisplayMetrics * int * int * Android.Graphics.Bitmap.Config * bool * Android.Graphics.ColorSpace -> Android.Graphics.Bitmap參數
- display
- DisplayMetrics
用於繪製點陣圖的顯示器指標。 此值可能為 null。
- width
- Int32
點陣圖的寬度。
- height
- Int32
位圖的高度。
- config
- Bitmap.Config
要建立點陣圖設定。 這個值不能是 null。
- hasAlpha
- Boolean
對於 Argb8888、 RgbaF16或 Rgba1010102，指定是否標記位圖為不透明。 當標記為不透明時，位圖會被清除為黑色，而非透明。
- colorSpace
- ColorSpace
點陣圖的色彩空間。 若 config 提供 和 RgbaF16 sRGB 或線性 sRGB，則假設對應的延伸範圍變體。 這個值不能是 null。
傳回
一張點陣圖。 這個值不能是 null。
- 屬性
例外狀況
若 width 或 height 小於或等於零; config 為 Hardware; colorSpace 非 RGB;其傳遞函數非 ICC 參數曲線;或 colorSpace 為 null。
備註
初始密度由 display決定。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Int32, Int32, Bitmap+Config, Boolean, ColorSpace)
回傳一個可變的位圖，寬度與高度皆為指定。
[Android.Runtime.Register("createBitmap", "(IILandroid/graphics/Bitmap$Config;ZLandroid/graphics/ColorSpace;)Landroid/graphics/Bitmap;", "", ApiSince=26)]
public static Android.Graphics.Bitmap CreateBitmap(int width, int height, Android.Graphics.Bitmap.Config config, bool hasAlpha, Android.Graphics.ColorSpace colorSpace);[<Android.Runtime.Register("createBitmap", "(IILandroid/graphics/Bitmap$Config;ZLandroid/graphics/ColorSpace;)Landroid/graphics/Bitmap;", "", ApiSince=26)>]
static member CreateBitmap : int * int * Android.Graphics.Bitmap.Config * bool * Android.Graphics.ColorSpace -> Android.Graphics.Bitmap參數
- width
- Int32
點陣圖的寬度。
- height
- Int32
位圖的高度。
- config
- Bitmap.Config
要建立點陣圖設定。 這個值不能是 null。
- hasAlpha
- Boolean
對於 Argb8888、 RgbaF16或 Rgba1010102，指定是否標記位圖為不透明。 當標記為不透明時，位圖會被清除為黑色，而非透明。
- colorSpace
- ColorSpace
點陣圖的色彩空間。 若 config 提供 和 RgbaF16 sRGB 或線性 sRGB，則假設對應的延伸範圍變體。 這個值不能是 null。
傳回
一張點陣圖。 這個值不能是 null。
- 屬性
例外狀況
若 width 或 height 小於或等於零; config 為 Hardware; colorSpace 非 RGB;其傳遞函數非 ICC 參數曲線;或 colorSpace 為 null。
備註
初始密度為 。Density
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(DisplayMetrics, Int32[], Int32, Int32, Bitmap+Config)
回傳一個不變的位圖，包含指定的寬度與高度，且每個像素值設定為顏色陣列中對應的值。
[Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;[IIILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(Android.Util.DisplayMetrics? display, int[] colors, int width, int height, Android.Graphics.Bitmap.Config config);[<Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;[IIILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : Android.Util.DisplayMetrics * int[] * int * int * Android.Graphics.Bitmap.Config -> Android.Graphics.Bitmap參數
- display
- DisplayMetrics
此點陣圖將繪製的顯示指標。
- colors
- Int32[]
T T：Android.Graphics._Color 陣列用於初始化像素。 這個陣列必須至少等於寬度乘以高度。
- width
- Int32
點陣圖的寬度
- height
- Int32
點陣圖的高度
- config
- Bitmap.Config
要建立點陣圖設定。 若設定不支援每像素 alpha（例如 RGB_565），則色彩[] 中的 alpha 位元組將被忽略（假設為 FF）
傳回
- 屬性
例外狀況
若寬度或高度為 <= 0，或色彩陣列的長度小於像素數。
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(DisplayMetrics, Int32, Int32, Bitmap+Config, Boolean)
回傳一個可變的位圖，寬度與高度皆為指定。
[Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;IILandroid/graphics/Bitmap$Config;Z)Landroid/graphics/Bitmap;", "", ApiSince=26)]
public static Android.Graphics.Bitmap CreateBitmap(Android.Util.DisplayMetrics? display, int width, int height, Android.Graphics.Bitmap.Config config, bool hasAlpha);[<Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;IILandroid/graphics/Bitmap$Config;Z)Landroid/graphics/Bitmap;", "", ApiSince=26)>]
static member CreateBitmap : Android.Util.DisplayMetrics * int * int * Android.Graphics.Bitmap.Config * bool -> Android.Graphics.Bitmap參數
- display
- DisplayMetrics
用於繪製點陣圖的顯示器指標。 此值可能為 null。
- width
- Int32
點陣圖的寬度。
- height
- Int32
位圖的高度。
- config
- Bitmap.Config
要建立點陣圖設定。 這個值不能是 null。
- hasAlpha
- Boolean
對於 Argb8888、 RgbaF16或 Rgba1010102，指定是否標記位圖為不透明。 當標記為不透明時，位圖會被清除為黑色，而非透明。
傳回
一張點陣圖。 這個值不能是 null。
- 屬性
例外狀況
若 width 或 height 小於或等於零，則 config 為 Hardware，因為硬體位圖始終是不可變的。
備註
初始密度由 display決定。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Bitmap, Int32, Int32, Int32, Int32)
回傳來源位圖指定子集的位圖。
[Android.Runtime.Register("createBitmap", "(Landroid/graphics/Bitmap;IIII)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(Android.Graphics.Bitmap source, int x, int y, int width, int height);[<Android.Runtime.Register("createBitmap", "(Landroid/graphics/Bitmap;IIII)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : Android.Graphics.Bitmap * int * int * int * int -> Android.Graphics.Bitmap參數
- source
- Bitmap
我們正在子設定的位圖
- x
- Int32
源中第一個像素的 x 座標
- y
- Int32
源中第一個像素的 y 座標
- width
- Int32
每列的像素數
- height
- Int32
列數
傳回
來源點陣圖的子集或來源點陣圖本身的複製品。
- 屬性
例外狀況
若 x、y、width、height 值不在來源位圖的尺寸範圍內，或寬度為 <= 0，或高度為 <= 0 則為
備註
回傳來源位圖指定子集的位圖。 新的位圖可能是與原始碼相同的物件，或是已經複製了。 它初始化時的密度和色彩空間與原始位圖相同。
Java 文件 android.graphics.Bitmap.createBitmap(android.graphics.Bitmap, int, int, int, int)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Int32[], Int32, Int32, Bitmap+Config)
回傳一個不變的位圖，包含指定的寬度與高度，且每個像素值設定為顏色陣列中對應的值。
[Android.Runtime.Register("createBitmap", "([IIILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(int[] colors, int width, int height, Android.Graphics.Bitmap.Config? config);[<Android.Runtime.Register("createBitmap", "([IIILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : int[] * int * int * Android.Graphics.Bitmap.Config -> Android.Graphics.Bitmap參數
- colors
- Int32[]
T T：Android.Graphics._Color 陣列用於初始化像素。 這個陣列必須至少等於寬度乘以高度。
- width
- Int32
點陣圖的寬度
- height
- Int32
點陣圖的高度
- config
- Bitmap.Config
要建立點陣圖設定。 若設定不支援每像素 alpha（例如 RGB_565），則色彩[] 中的 alpha 位元組將被忽略（假設為 FF）
傳回
- 屬性
例外狀況
若寬度或高度為 <= 0，或色彩陣列的長度小於像素數。
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Int32, Int32, Bitmap+Config, Boolean)
回傳一個可變的位圖，寬度與高度皆為指定。
[Android.Runtime.Register("createBitmap", "(IILandroid/graphics/Bitmap$Config;Z)Landroid/graphics/Bitmap;", "", ApiSince=26)]
public static Android.Graphics.Bitmap CreateBitmap(int width, int height, Android.Graphics.Bitmap.Config config, bool hasAlpha);[<Android.Runtime.Register("createBitmap", "(IILandroid/graphics/Bitmap$Config;Z)Landroid/graphics/Bitmap;", "", ApiSince=26)>]
static member CreateBitmap : int * int * Android.Graphics.Bitmap.Config * bool -> Android.Graphics.Bitmap參數
- width
- Int32
點陣圖的寬度。
- height
- Int32
位圖的高度。
- config
- Bitmap.Config
要建立點陣圖設定。 這個值不能是 null。
- hasAlpha
- Boolean
對於 Argb8888、 RgbaF16或 Rgba1010102，指定是否標記位圖為不透明。 當標記為不透明時，位圖會被清除為黑色，而非透明。
傳回
一張點陣圖。 這個值不能是 null。
- 屬性
例外狀況
若 width 或 height 小於或等於零，則 config 為 Hardware，因為硬體位圖始終是不可變的。
備註
初始密度為 。Density 新建立的點陣圖位於 sRGB 色彩空間中。
Java 文件 android.graphics.Bitmap.createBitmap(int, int, android.graphics.Bitmap.Config, boolean)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(DisplayMetrics, Int32, Int32, Bitmap+Config)
回傳一個可變的位圖，寬度與高度皆為指定。
[Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;IILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(Android.Util.DisplayMetrics? display, int width, int height, Android.Graphics.Bitmap.Config config);[<Android.Runtime.Register("createBitmap", "(Landroid/util/DisplayMetrics;IILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : Android.Util.DisplayMetrics * int * int * Android.Graphics.Bitmap.Config -> Android.Graphics.Bitmap參數
- display
- DisplayMetrics
此點陣圖將繪製的顯示指標。
- width
- Int32
點陣圖的寬度
- height
- Int32
點陣圖的高度
- config
- Bitmap.Config
要建立點陣圖設定。
傳回
- 屬性
例外狀況
若寬度或高度 <= 0
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Picture, Int32, Int32, Bitmap+Config)
根據指定圖片中錄製的繪圖指令，建立點陣圖。
[Android.Runtime.Register("createBitmap", "(Landroid/graphics/Picture;IILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "", ApiSince=28)]
public static Android.Graphics.Bitmap CreateBitmap(Android.Graphics.Picture source, int width, int height, Android.Graphics.Bitmap.Config config);[<Android.Runtime.Register("createBitmap", "(Landroid/graphics/Picture;IILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "", ApiSince=28)>]
static member CreateBitmap : Android.Graphics.Picture * int * int * Android.Graphics.Bitmap.Config -> Android.Graphics.Bitmap參數
- source
- Picture
記錄下來的繪圖指令是要在回傳的點陣圖中繪製。 這個值不能是 null。
- width
- Int32
要建立點陣圖的寬度。 如有需要，圖片寬度會被調整以匹配。
- height
- Int32
要建立點陣圖的高度。 如有需要，圖片高度也會相應縮放。
- config
- Bitmap.Config
建立的點陣圖配置。 這個值不能是 null。
傳回
一個配置由 config指定為的不變位圖。 這個值不能是 null。
- 屬性
備註
該位圖是不可變的，且擁有指定的寬度與高度。 如果任一尺寸與圖片對應尺寸不同，圖片會被調整以配合。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Int32, Int32, Bitmap+Config)
回傳一個可變的位圖，寬度與高度皆為指定。
[Android.Runtime.Register("createBitmap", "(IILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(int width, int height, Android.Graphics.Bitmap.Config config);[<Android.Runtime.Register("createBitmap", "(IILandroid/graphics/Bitmap$Config;)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : int * int * Android.Graphics.Bitmap.Config -> Android.Graphics.Bitmap參數
- width
- Int32
點陣圖的寬度
- height
- Int32
點陣圖的高度
- config
- Bitmap.Config
要建立點陣圖設定。
傳回
- 屬性
例外狀況
若寬度或高度 <= 0
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Picture)
從所記錄 Picture 的繪圖指令來源建立點陣圖。
[Android.Runtime.Register("createBitmap", "(Landroid/graphics/Picture;)Landroid/graphics/Bitmap;", "", ApiSince=28)]
public static Android.Graphics.Bitmap CreateBitmap(Android.Graphics.Picture source);[<Android.Runtime.Register("createBitmap", "(Landroid/graphics/Picture;)Landroid/graphics/Bitmap;", "", ApiSince=28)>]
static member CreateBitmap : Android.Graphics.Picture -> Android.Graphics.Bitmap參數
- source
- Picture
記錄 Picture 下來的繪圖指令，這些指令會被繪製到回傳的點陣圖中。
傳回
一個不可變的點陣圖，帶有硬體設定，其內容由 Picture 原始碼中錄製的繪圖指令產生。
- 屬性
備註
從所記錄 Picture 的繪圖指令來源建立點陣圖。
相當於呼叫 #createBitmap(Picture, int, int, Config) 圖片寬度和高度相同的寬度和高度，並設定 Config.HARDWARE 設定。
Java 文件 android.graphics.Bitmap.createBitmap(android.graphics.Picture)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateBitmap(Bitmap)
會回傳來源位圖的位圖。
[Android.Runtime.Register("createBitmap", "(Landroid/graphics/Bitmap;)Landroid/graphics/Bitmap;", "")]
public static Android.Graphics.Bitmap CreateBitmap(Android.Graphics.Bitmap src);[<Android.Runtime.Register("createBitmap", "(Landroid/graphics/Bitmap;)Landroid/graphics/Bitmap;", "")>]
static member CreateBitmap : Android.Graphics.Bitmap -> Android.Graphics.Bitmap參數
- src
- Bitmap
傳回
- 屬性
備註
會回傳來源位圖的位圖。 新的位圖可能是與原始碼相同的物件，或是已經複製了。 它初始化時的密度和色彩空間與原始位圖相同。
Java 文件 android.graphics.Bitmap.createBitmap(android.graphics.Bitmap)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。