グラフィックス（６）-Bitmapの描画とMatrixの操作

drawBitmapメソッドの簡単なサンプル

CanvasクラスのdrawBitmapメソッドを使って、Bitmapを描画する事ができます。

以下に、drawBitmapメソッドを使ってBitmapを描画する、簡単なサンプルを示します。

このプログラムを実行するには、res/drawableデレクトリに、画像ファイルsample.JPGが保存されている必要があります。

画像ファイルは、JPGだけでなくBMP，PNG，GIFも表示可能なようです。

BitmapFactory.decodeResourceメソッドは、res/drawableデレクトリの画像ファイルを、Bitmapオブジェクトとして取得するメソッドです。

drawBitmapメソッドは、CanvasにBitmapオブジェクトを描画するメソッドで、引数の意味については、次の「drawBitmapメソッドのオーバロードメソッド」を参照して下さい。

このプログラムを実行すると、以下のように、画像ファイルsample.JPGが表示されます。

drawBitmapメソッドのオーバロードメソッド

drawBitmapメソッドには、以下のようにオーバロードされたメソッドが存在します。

void drawBitmap(Bitmap bitmap, float left, float top, Paint paint)
Bitmapをcanvasの座標（left, top）の位置を起点として、描画します。
void drawBitmap(Bitmap bitmap, Rect src, Rect dst, Paint paint)
Bitmap内の矩形srcで囲まれた領域を、canvasの矩形dst領域に、描画します。
結果としてBitmapの１部の領域を縮小・拡大して、canvasの矩形dst領域に、描画する事になります。
void drawBitmap(Bitmap bitmap, Rect src, RectF dst, Paint paint)
１つ前のメソッドのdst引数のクラスが、RectクラスではなくRectFクラスに、変わったものです。
void drawBitmap(Bitmap bitmap, Matrix matrix, Paint paint)
matrixオブジェクトの操作に従って、Bitmapを描画します。
void drawBitmap(int[] colors, int offset, int stride, float x, float y, int width, int height, boolean hasAlpha, Paint paint)
引数colorsで示されるピクセル配列より、Bitmapを描画します。
void drawBitmap(int[] colors, int offset, int stride, int x, int y, int width, int height, boolean hasAlpha, Paint paint)
１つ前のメソッドのレガシー（従来）バージョンで、引数x,yの型がfloatではなくint型になっています。
void drawBitmapMesh(Bitmap bitmap, int meshWidth, int meshHeight, float[] verts, int vertOffset, int[] colors, int colorOffset, Paint paint)
BitmapMesh.java - Android Developersにサンプルプログラムがありますが、詳細はよくわかりませんでした。

矩形領域Rectを指定してBitmapの１部の領域を縮小・拡大してcanvasに描画する

次のプログラムは、Bitmap画像の右半分の画像を、縦横それぞれ半分の大きさに縮小して、座標（50, 50）の点を起点として、描画するサンプルです、

このプログラムを実行すると、以下のように画像が表示されます。

Bitmapオブジェクトの新規作成とコピーとBitmapオブジェクト内のcanvasへの描画

Bitmapオブジェクトを新規に作成するには、BitmapクラスのcreateBitmapメソッドを使います。

既存のBitmapオブジェクトをコピーして、新たなBitmapオブジェクトを作成するには、Bitmapクラスのcopyメソッドを使います。

新規に作成したBitmapオブジェクトのCanvasオブジェクトを取得して、図形を描画する事もできます。

以下に、その例を示します。

18行目のisMutableメソッドは、Bitmapが変更可能かどうかを返します。

Bitmapが変更可能でない場合に、変更可能なコピーを作成して、これに描画しています。

9行目のcreateBitmapメソッドと、19行目のcopyメソッドの引数、Bitmap.Config.ARGB_8888は、 32ビットのARGBデータでBitmapを作成する事を、示しています。

Color値は32ビットのARGBデータですので、通常、このBitmap.Config.ARGB_8888を指定して、Bitmapを作成します。

enum型Bitmap.Configは、Bitmapのピクセルフォーマットを指定するもののようで、他にもALPHA_8，ARGB_4444，RGB_565があり、それぞれBitmapがARGBの各値に何ビット使用するかを、示しているようです。

22行目～24行目は、BitmapオブジェクトのCanvasオブジェクトを作成し、bitmapCanvas変数に代入して、このbitmapCanvasに対して、すなわちBitmap内に、円を描画した後、そのBitmapをViewのCanvasに描画しています。

余談ですが、CanvasクラスにはsetBitmapメソッドもあります。

setBitmapメソッドを使うと、上記プログラムの22行目は、以下のコードに置き換えることができます。

このプログラムを実行すると、以下のように画像が表示されます。

Bitmapオブジェクトの、新規作成とコピーのためのメソッドは幾つかあります。

以下に、その書式を列挙します。

Bitmap copy(Bitmap.Config config, boolean isMutable)
static Bitmap createBitmap(Bitmap src)
static Bitmap createBitmap(int[] colors, int width, int height, Bitmap.Config config)
static Bitmap createBitmap(int[] colors, int offset, int stride, int width, int height, Bitmap.Config config)
static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height, Matrix m, boolean filter)
static Bitmap createBitmap(int width, int height, Bitmap.Config config)
static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height)
static Bitmap createScaledBitmap(Bitmap src, int dstWidth, int dstHeight, boolean filter)