Android中文API（136） —— Bitmap
?
前言
本章內(nèi)容android.graphics.Bitmap章節(jié)，譯為"位圖"，版本為Android 4.0 r1，翻譯來(lái)自："StreamH"，歡迎訪(fǎng)問(wèn)他的博客："http://blog.csdn.net/qs_csu"，再次感謝"StreamH" ！期待你一起參與翻譯Android的相關(guān)資料，聯(lián)系我over140@gmail.com。
?
聲明
歡迎轉(zhuǎn)載，但請(qǐng)保留文章原始出處:)?
博客園：http://www.cnblogs.com/
Android中文翻譯組：http://androidbox.sinaapp.com/?
?
Bitmap
譯者署名：StreamH
譯者鏈接：http://blog.csdn.net/qs_csu
版本：Android 4.0 r1
?
結(jié)構(gòu)
繼承關(guān)系
public class Bitmap extends Object implements Parcelable
????????
java.lang.Object
android.graphics.Bitmap
?
內(nèi)部類(lèi)
enum Bitmap.CompressFormat
詳細(xì)說(shuō)明位圖的壓縮格式
?
enum Bitmap.Config
位圖的結(jié)構(gòu)
?
常量
Int ?DENSITY_NONE
標(biāo)志著該位圖是以未知的像素密度創(chuàng)建的
參見(jiàn)
???????? ? getDensity()
setDensity(int)
?
公共方法
boolean compress(Bitmap.CompressFormat format, int quality, OutputStream stream)
把位圖的壓縮信息寫(xiě)入到一個(gè)指定的輸出流中。如果返回true，可以通過(guò)傳遞一個(gè)相應(yīng)的輸出流到BitmapFactory.decodeStream()來(lái)重構(gòu)該位圖。注意：并非所有的格式都直接支持位圖結(jié)構(gòu)，所以通過(guò)BitmapFactory返回的位圖很可能有不同的位深度，或許會(huì)丟失每個(gè)象素的alpha值(例如，JPEG 只支持不透明像素)。
（譯者注：色深(color depth),也稱(chēng)色位深度(bitdePth),是指在一定分辨率下一個(gè)像素能夠接受的顏色數(shù)量范圍。通常,色深用2的n次方來(lái)表示。例如,8 bit的色深包含2的8次方）
參數(shù)
??????????????????????????? format ?圖像的壓縮格式；
??????????????????????????? quality?圖像壓縮比的值，0-100。 0 意味著小尺寸壓縮，100意味著高質(zhì)量壓縮。對(duì)于有些格式，比如無(wú)損壓縮的PNG，它就會(huì)忽視quality這個(gè)參數(shù)設(shè)置。
??????????????????????????? stream ?寫(xiě)入壓縮數(shù)據(jù)的輸出流
返回值
如果成功地把壓縮數(shù)據(jù)寫(xiě)入輸出流，則返回true。
?
public Bitmap copy (Bitmap.Config config, boolean isMutable)
根據(jù)該位圖的大小產(chǎn)生一個(gè)新位圖，根據(jù)指定的結(jié)構(gòu)設(shè)置新位圖的結(jié)構(gòu)，然后把位圖的像素拷貝到新位圖中。如果不支持該轉(zhuǎn)換，或者分配內(nèi)存失敗，那就返回NULL。返回的位圖和原圖有同樣的像素密度。
參數(shù)
???????? ?? config ?? 結(jié)果圖預(yù)期的結(jié)構(gòu)；
?????????? isMutable? 如果是true，那么產(chǎn)生的圖片是可變的。(比如，它的像素能被修改)
返回值
新的位圖。如果拷貝操作不能執(zhí)行，則返回NULL。
?
public void copyPixelsFromBuffer (Buffer src)
從緩存器中拷貝像素值，從當(dāng)前索引開(kāi)始，覆蓋位圖中對(duì)應(yīng)的像素值。在緩存器中的數(shù)據(jù)不會(huì)被改變(不像setPixels()，會(huì)把32位去預(yù)存像素轉(zhuǎn)換為該位圖的格式)。
?
public void copyPixelsToBuffer (Buffer dst)
把該位圖的像素值拷貝到指定的緩存器中(調(diào)用者分配的緩存器)。如果緩存區(qū)不夠大而無(wú)法放置所有的像素值(要考慮每個(gè)像素值的位數(shù))，或者如果該緩存器的子類(lèi)不是被支持的類(lèi)型中的一種(ByteBuffer，ShortBuffer，IntBuffer)，那么將會(huì)拋出一個(gè)異常。
?
public static Bitmap createBitmap (Bitmap source, int x, int y, int width, int height, Matrix m, boolean filter)
返回一個(gè)不可改變的位圖，該位圖來(lái)自源位圖的子集，并根據(jù)可選的矩陣進(jìn)行轉(zhuǎn)換。它被初始化為跟源位圖有同樣的密度。
參數(shù)
??????????????????????????? source ?產(chǎn)生子位圖的源位圖；
??????????????????????????? x????? 子位圖第一個(gè)像素在源位圖的X坐標(biāo)
??????????????????????????? y ?????子位圖第一個(gè)像素在源位圖的y坐標(biāo)
??????????????????????????? width?子位圖每一行的像素個(gè)數(shù)
??????????????????????????? height 子位圖的行數(shù)
??????????????????????????? m???? 對(duì)像素值進(jìn)行變換的可選矩陣
??????????????????????????? filter?? 如果為true，源圖要被過(guò)濾。該參數(shù)僅在matrix包含了超過(guò)一個(gè)翻轉(zhuǎn)才有效
返回值
一個(gè)描述了源圖指定子集的位圖。
異常??
IllegalArgumentException?????? 如果x，y，width，height的值超出了源圖的維度，該異常會(huì)被拋出。
?
public static Bitmap createBitmap (int width, int height, Bitmap.Config config)
返回一個(gè)指定高度和寬度的不可改變的位圖。它的初始密度由getDensity()決定。
???????? 參數(shù)
?????????????????? width 位圖的寬度
?????????????????? height 位圖的高度
?????????????????? config?位圖的結(jié)構(gòu)
???????? 異常
IllegalArgumentException?????? 如果高度或?qū)挾刃∮诘扔诹?#xff0c;該異常被拋出。
????????
public static Bitmap createBitmap (Bitmap source, int x, int y, int width, int height)
???????? 返回一個(gè)不可變的位圖，該位圖來(lái)自源圖指定的子集。新位圖可能跟源圖同一個(gè)對(duì)象，或者是源圖的一個(gè)拷貝。它被初始化為源圖同樣的密度。
?????????????????? 參數(shù)
??????????????????????????? source 用來(lái)構(gòu)建子集的源位圖
??????????????????????????? x????? 子位圖第一個(gè)像素在源位圖的X坐標(biāo)
??????????????????????????? y ?????子位圖第一個(gè)像素在源位圖的y坐標(biāo)
??????????????????????????? width?子位圖每一行的像素個(gè)數(shù)
??????????????????????????? height 子位圖的行數(shù)
???????? ?
public static Bitmap createBitmap (int[] colors, int offset, int stride, int width, int height, Bitmap.Config config)
返回一個(gè)指定寬度和高度的不可變位圖，該位圖每個(gè)像素值等于顏色數(shù)組中對(duì)應(yīng)的值。它初始化的密度由getDensity()來(lái)設(shè)定。
???????? 參數(shù)
????????????????????? colors 用來(lái)初始化像素值得顏色數(shù)組
????????????????????? offset 在像素?cái)?shù)組的第一個(gè)顏色值之前要忽略的像素個(gè)數(shù)
????????????????????? stride 行之間像素個(gè)數(shù)
????????????????????? width 位圖的寬度
????????????????????? height 位圖的高度
????????????????????? config 位圖的結(jié)構(gòu)。如果這個(gè)結(jié)構(gòu)不支持每個(gè)像素的alpha通道(比如，RGB_565), 那么colors數(shù)組中的alpha位將被忽略(被假定為FF值)。
???????? 異常?
IllegalArgumentException 如果寬度值或高度值小于等于零，或者像素?cái)?shù)組的長(zhǎng)度小于像素個(gè)數(shù)，該異常被拋出。
?
public static Bitmap createBitmap (Bitmap src)
根據(jù)源位圖返回一個(gè)不可改變的位圖。新位圖可能跟源位圖是同一個(gè)對(duì)象，或者是一個(gè)拷貝。新位圖被初始化為和源位圖有同樣的像素密度。
?
public static Bitmap createBitmap (int[] colors, int width, int height, Bitmap.Config config)
返回一個(gè)寬度和高度被指定的不可改變的位圖，且該位圖每一個(gè)像素值由顏色數(shù)組中對(duì)應(yīng)的值來(lái)設(shè)定。它的初始像素密度由getDensity()決定。
參數(shù)
colors 用來(lái)初始化像素值得顏色數(shù)組。該數(shù)組必須至少和寬度*高度一樣大。?? width 位圖的寬度
?????????????????? height 位圖的高度
?????????????????? config 位圖的結(jié)構(gòu)。如果這個(gè)結(jié)構(gòu)不支持每個(gè)像素的alpha通道(比如，RGB_565), 那么colors數(shù)組中的alpha位將被忽略(被假定為FF值)。
異常?
IllegalArgumentException?????? 如果寬度值或高度值小于等于零，或者像素?cái)?shù)組的長(zhǎng)度小于像素個(gè)數(shù)，該異常被拋出。
?
public static Bitmap createScaledBitmap (Bitmap src, int dstWidth, int dstHeight, boolean filter)
從當(dāng)前存在的位圖，按一定的比例創(chuàng)建一個(gè)新的位圖。
參數(shù)
src ???????用來(lái)構(gòu)建子集的源位圖
???????????????? dstWidth?? 新位圖期望的寬度
???????????????? dstHeight ?新位圖期望的高度
返回值
?????????? 一個(gè)新的按比例變化的位圖。
?
public int describeContents ()
沒(méi)有特殊的包內(nèi)容。（原文：No special parcel contents.）
返回值
??????????????????????????? 一個(gè)位掩碼，指明被Parcelable序列化的特殊對(duì)象類(lèi)型的數(shù)據(jù)集。
?
public void eraseColor (int c)
用指定的顏色填充位圖的像素值。
???????? 異常?
IilegalStateException?????? 當(dāng)該位圖不可改變時(shí)
?
public Bitmap extractAlpha ()
返回一個(gè)新的位圖，該位圖從源圖中捕獲了alpha值。這個(gè)方法可能跟Canvas.drawBitmap()一起被畫(huà)，顏色值從傳遞過(guò)來(lái)的畫(huà)布中獲取。
返回值
??????????????????????????? 一個(gè)包含源位圖alpha通道值的位圖。
?
public Bitmap extractAlpha (Paint paint, int[] offsetXY)
返回一個(gè)從源圖中獲取了alpha值的新位圖。這些值可能被可選的畫(huà)布參數(shù)所影響，該畫(huà)布參數(shù)可以包含它自己的alpha值，或可能包含一個(gè)能改變結(jié)果位圖實(shí)際尺寸的遮罩濾鏡(比如，一個(gè)模糊濾鏡可以放大結(jié)果位圖)。如果offsetXY不為空，它會(huì)返回最終位圖的偏移量總數(shù)，這樣它就能跟源位圖對(duì)齊。比如，如果畫(huà)布包含半徑為2的模糊區(qū)，那么offsetXY[] 將包含-2，-2，所以位圖的alpha值會(huì)按照(-2，-2)的偏移量去繪制，然后畫(huà)源圖時(shí)會(huì)導(dǎo)致模糊區(qū)域在視覺(jué)上跟源圖對(duì)齊。
返回位圖的初始像素密度跟源圖一樣。
參數(shù)
paint ?????? ???可選的畫(huà)布，用來(lái)修改被返回位圖的alpha值。默認(rèn)為空值。
???????????????? offsetXY?? ?? 可選的數(shù)組，它返回x(索引為0) 和y (索引為1)的偏移量，該偏移量被用來(lái)定位返回的位圖，這樣它才會(huì)在視覺(jué)上跟源位圖對(duì)齊。
返回值
?????????? 返回一個(gè)新的位圖，該位圖從源圖中捕獲了alpha值。這個(gè)方法可能跟Canvas.drawBitmap()一起被畫(huà)，顏色值從傳遞過(guò)來(lái)的畫(huà)布中獲取。
?
public final Bitmap.Config getConfig ()
如果這個(gè)位圖內(nèi)在的配置是一種公開(kāi)的格式，那么返回這個(gè)配置，否則返回空值。
?
public int getDensity ()
返回位圖的像素密度。
默認(rèn)的像素密度和當(dāng)前的顯示密度一樣，除非當(dāng)前的應(yīng)用程序不支持不同的屏幕密度，當(dāng)它是DENSITY_DEFAULT時(shí)。要注意到兼容模式是由最初裝載到進(jìn)程的應(yīng)用程序決定的。
--共享同一個(gè)進(jìn)程的應(yīng)用程序必須有同樣的兼容性，或者確保它們能明確地設(shè)置合適的位圖密度。
返回值
??????????????????????????? 一個(gè)默認(rèn)密度的變換因子，當(dāng)變換因子未知時(shí)返回DENSITY_NONE值。
?????????? 參見(jiàn)
?????????? setDensity(int)
DENSITY_DEFAULT
densityDpi
DENSITY_NONE
?
public final int getHeight ()
返回位圖的高度值。
?
public byte[] getNinePatchChunk ()
返回一個(gè)裝有私有數(shù)據(jù)的可選數(shù)組，該數(shù)組被UI系統(tǒng)在一些位圖中使用。該方法不要在應(yīng)用程序主動(dòng)調(diào)用。
?
public int getPixel (int x, int y)
返回指定位置的像素顏色值。如果x或y越界(負(fù)數(shù)，或各自大于等于寬度或高度值)，講拋出一個(gè)異常。
參數(shù)
x ???? ??待返回像素的x坐標(biāo)值(0-width-1)。
???????????????? y?????? ?待返回像素的y坐標(biāo)值(0-height-1)
返回值
?????????????????? 指定坐標(biāo)的argb顏色值。
異常
?????????????????? 如果x，y越界，IilegalArgumentExcepiton將被拋出。
?
public void getPixels (int[] pixels, int offset, int stride, int x, int y, int width, int height)
把位圖的數(shù)據(jù)拷貝到pixels[]中。每一個(gè)都由一個(gè)表示顏色值的int值來(lái)表示。幅度參數(shù)表明調(diào)用者允許的像素?cái)?shù)組行間距。對(duì)通常的填充結(jié)果，只要傳遞寬度值給幅度參數(shù)。
參數(shù)
pixels ????? 接收位圖顏色值的數(shù)組
offset ???? 寫(xiě)入到pixels[]中的第一個(gè)像素索引值
stride??????? pixels[]中的行間距個(gè)數(shù)值(必須大于等于位圖寬度)。不能為負(fù)數(shù)
x ???? ????從位圖中讀取的第一個(gè)像素的x坐標(biāo)值。
???????????????? y?????? ????? 從位圖中讀取的第一個(gè)像素的y坐標(biāo)值
???????????????? width ????? 從每一行中讀取的像素寬度
???????????????? height? 讀取的行數(shù)???????????????
異常
?????????????????? IilegalArgumentExcepiton?????? 如果x，y，width，height越界或stride的絕對(duì)值小于位圖寬度時(shí)將被拋出。
?????????????????? ArrayIndexOutOfBoundsException????????? 如果像素?cái)?shù)組太小而無(wú)法接收指定書(shū)目的像素值時(shí)將被拋出。
?
public final int getRowBytes ()
返回位圖每行像素總數(shù)的字節(jié)數(shù)。要注意，這里說(shuō)的是位圖中原始態(tài)存儲(chǔ)的像素。如果你調(diào)用了getPixels()或者setPixels()，那么像素就會(huì)統(tǒng)一地被處理成32bit值，它是根據(jù)顏色類(lèi)進(jìn)行填充的。
返回值
?????????????????? 原生態(tài)位圖每行像素的字節(jié)總數(shù)。
?
public int getScaledHeight (int targetDensity)
一個(gè)方便的方法，它能返回被像素密度因子整除后的位圖高度值。
參數(shù)
targetDensity ???????? 位圖目標(biāo)畫(huà)布的密度
返回值
?????????????????? 根據(jù)密度比例因子處理后位圖的高度值。
?
public int getScaledHeight (DisplayMetrics metrics)
方便地以DisplayMetrics的目標(biāo)密度值調(diào)用getScaledHeight(int)
?
public int getScaledHeight (Canvas canvas)
方便地以Canvas的目標(biāo)密度值調(diào)用getScaledHeight(int)
?
public int getScaledWidth (DisplayMetrics metrics)
方便地以DisplayMetrics的目標(biāo)密度值調(diào)用getScaledWidth(int)
?
public int getScaledWidth (int targetDensity)
一個(gè)方便的方法，它能返回被像素密度因子整除后的位圖寬度值。
參數(shù)
targetDensity ???????? 位圖目標(biāo)畫(huà)布的密度
返回值
?????????????????? 根據(jù)密度比例因子處理后位圖的寬度值。
?
public int getScaledWidth (Canvas canvas)
方便地以Canvas的目標(biāo)密度值調(diào)用getScaledWidth (int)
?
public final int getWidth ()
返回位圖的寬度。
?
public final boolean hasAlpha ()
返回true，如果位圖的配置支持每個(gè)像素的alpha值，并且這些像素可能包含不透明的alpha值。對(duì)于某些配置，一般都返回false(比如，RGB_565)，因?yàn)樗鼈儾恢С置總€(gè)像素的alpha值。盡管如此，對(duì)配置來(lái)說(shuō)，這些位圖可能被標(biāo)記為它所有的像素都是透明的。在這種情況下，hasAlpha()將會(huì)返回false。如果一個(gè)配置，比如ARGB_8888是沒(méi)有被標(biāo)記的，那么它會(huì)默認(rèn)返回true。
?
public final boolean isMutable ()
如果該位圖被標(biāo)記為可改變(比如，能被畫(huà)進(jìn)去)，那么返回true。
?
public final boolean isRecycled ()
如果該位圖已經(jīng)被回收，返回true。如果那樣，若試圖獲取它的像素值，一個(gè)錯(cuò)誤將會(huì)發(fā)生，并且該位圖不會(huì)被畫(huà)。
返回值
????? 如果位圖已經(jīng)被回收，返回true。
?
public void prepareToDraw ()
重建所有與待畫(huà)位圖相關(guān)的緩存。在位圖可清除的情況下，這個(gè)調(diào)用會(huì)努力保證像素已經(jīng)被解碼。如果這個(gè)方法是被有多個(gè)位圖的序列調(diào)用，優(yōu)先級(jí)在LRU順序中提供(比如，最后被調(diào)用的位圖擁有最高的優(yōu)先級(jí))。對(duì)于和緩存無(wú)關(guān)的位圖，這個(gè)調(diào)用時(shí)一個(gè)no-op，它是無(wú)害的。
?
public void recycle ()
釋放和位圖相關(guān)的本地對(duì)象，且清除對(duì)像素?cái)?shù)據(jù)的引用。該方法不會(huì)同步釋放像素?cái)?shù)據(jù)。它僅僅允許在沒(méi)有其它引用的情況下被系統(tǒng)垃圾回收。這個(gè)位圖被標(biāo)記為“死的”，意味著如果getPixels()或setPixels()被調(diào)用，一個(gè)異常會(huì)拋出，且它不畫(huà)任何東西。這個(gè)操作不可翻轉(zhuǎn)，所以只有當(dāng)你確信這個(gè)位圖沒(méi)有更多的用處時(shí)，它才能被調(diào)用。這是一個(gè)高級(jí)的調(diào)用， 且一般來(lái)說(shuō)它不需要被調(diào)用，因?yàn)橥ǔ５睦厥者^(guò)程會(huì)在該位圖沒(méi)有其它引用的時(shí)候，釋放這些內(nèi)存。
?
public void setDensity (int density)
指定位圖的密度。當(dāng)位圖被畫(huà)到一個(gè)有密度的畫(huà)布上時(shí)，它會(huì)縮放到合適的比例
參數(shù)
density ?? 該位圖的密度縮放因子。如果密度未知，值為DENSITY_NONE。
參見(jiàn)
????? getDensity()
DENSITY_DEFAULT
densityDpi
DENSITY_NONE
?
public void setPixel (int x, int y, int color)
把指定的顏色寫(xiě)入到位圖中x，y的坐標(biāo)值的位置(假設(shè)該位圖是可變的)。
參數(shù)
X ???? ???????? 待替換像素的x坐標(biāo)(0到width-1)。
Y ???? ???????? 待替換像素的y坐標(biāo)(0到height-1)
color???????? 寫(xiě)入到位圖的顏色值
拋出
???????? IilegalStateException ???????????????????? 如果這個(gè)位圖不可改變
IIlegalArgumentException?? 如果x，y的值超出位圖的邊界
?
public void setPixels (int[] pixels, int offset, int stride, int x, int y, int width, int height)
用數(shù)組中的顏色值替換位圖的像素值。數(shù)組中的每個(gè)元素是包裝的整型，代表了顏色值。
參數(shù)
????? pixels??????? 寫(xiě)到位圖中的顏色值
offset??????? 從pixels[]中讀取的第一個(gè)顏色值的索引
stride??????? 位圖行之間跳過(guò)的顏色個(gè)數(shù)。通常這個(gè)值等于位圖寬度，但它可以更更大(或負(fù)數(shù))
X ????????????? 被寫(xiě)入位圖中第一個(gè)像素的x坐標(biāo)。
Y ????????????? 被寫(xiě)入位圖中第一個(gè)像素的y坐標(biāo)
width??????? 從pixels[]中拷貝的每行的顏色個(gè)數(shù)
height?????? 寫(xiě)入到位圖中的行數(shù)
異常
????? IilegalStateException ???????????????????? 如果這個(gè)位圖不可改變
IIlegalArgumentException?? 如果x，y，width，height的值超出位圖的邊界
ArrayIndexOutOfBoundsException 如果像素隊(duì)列太小以致不能接受指定的像素位數(shù)。
?
public void writeToParcel (Parcel p, int flags)
把位圖和它的像素值寫(xiě)入到parcel中。位圖可以通過(guò)調(diào)用CREATOR.createFromParcel()進(jìn)行重建。
參數(shù)
p??????????????? 可以寫(xiě)入位圖數(shù)據(jù)的parcel對(duì)象
flages?????? 附加的標(biāo)記，表明這個(gè)對(duì)象以什么方式寫(xiě)入。可能是0或PARCELABLE_WRITE_RETURN_VALUE
?
補(bǔ)充
???????? 文章精選
?????????????????? Android Bitmap和Canvas學(xué)習(xí)筆記
?????????????????? Android畫(huà)圖學(xué)習(xí)總結(jié)（二）——Bitmap
?????????????????? Android Bitmap內(nèi)存限制
?????????????????? Android Bitmap轉(zhuǎn)字節(jié)數(shù)組后大小問(wèn)題
?????????????????? Android bitmap優(yōu)化
??????????????????
總結(jié)
以上是生活随笔為你收集整理的Android中文API（136） —— Bitmap的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇： 解决“添加删除程序”里面隐藏问题
- 下一篇： VMWARE双机安装说明