Bitmap类getPixels()方法中参数stride理解

  在学习Graphics中遇到位图(Bitmap)中getPixels()方法，对该方法的用法大体理解，但对其中的stride参数却不明白具体的用法以及用意，经过一番折腾后，有些明了，现记述过程如下：

行文有些详细，请赶时间的同学直接跳到红字总结处查看！！
getPixels()方法的用处为获取位图(Bitmap)中的根据方法参数所决定的像素值(颜色值)，存入类型为int的pixels数组中，至于从RGB转换为int数值的算法是什么，暂时不知，存疑！！

Android英文SDK中有关getPixels()方法的介绍如下：
(引自Android　SDK官网，链接请见附后1)

public void getPixels (int[] pixels, int offset, int stride, int x, int y, int width, int height)

Since: API Level 1
Returns in pixels[] a copy of the data in the bitmap. Each value is a packed int representing a Color. The stride parameter allows the caller to allow for gaps in the returned pixels array between rows. For normal packed results, just pass width for the stride value.
Parameters

pixels The array to receive the bitmap's colors
offset The first index to write into pixels[]
stride The number of entries in pixels[] to skip between rows (must be >= bitmap's width). Can be negative.
x The x coordinate of the first pixel to read from the bitmap
y The y coordinate of the first pixel to read from the bitmap
width The number of pixels to read from each row
height The number of rows to read
Throws

IllegalArgumentException if x, y, width, height exceed the bounds of the bitmap, or if abs(stride) < width.
ArrayIndexOutOfBoundsException if the pixels array is too small to receive the specified number of pixels.　


看完英文文档仍然不甚明白，于是去搜了下中文Android文档相应内容，如下(引自农民伯伯博客，链接请见附后2)：

public void getPixels (int[] pixels, int offset, int stride, int x, int y, int width, int height)

把位图的数据拷贝到pixels[]中。每一个都由一个表示颜色值的int值来表示。幅度参数表明调用者允许的像素数组行间距。对通常的填充结果，只要传递宽度值给幅度参数。
参数
pixels      接收位图颜色值的数组
offset      写入到pixels[]中的第一个像素索引值
stride      pixels[]中的行间距个数值(必须大于等于位图宽度)。可以为负数
x          　从位图中读取的第一个像素的x坐标值。
y           从位图中读取的第一个像素的y坐标值
width    　　从每一行中读取的像素宽度
height 　　　读取的行数              
异常
IilegalArgumentExcepiton       如果x，y，width，height越界或stride的绝对值小于位图宽度时将被抛出。
ArrayIndexOutOfBoundsException          如果像素数组太小而无法接收指定书目的像素值时将被抛出。

看完后仍然对Stride解释中的＂行间距＂不太明白，去查了下Stride在英语中的原义
Stride在柯林斯中的英英释义如下：

1　If you stride somewhere, you walk there with quick, long steps.
　　stride意为"大踏步快速前进"
2　A stride is a long step which you take when you are walking or running.
　　stride在此做名词，意为"大步"
3　Someone's stride is their way of walking with long steps.
　　指代某人具体迈大步的方式．

于是可以把stride理解为人行走过程中所迈大步的一段距离，而在此方法中可以理解为每行的像素数，至于用处是什么，还要继续寻找答案．

然后去StackOverFlow去搜了搜"getPixels()　stride"关键字，查找到如下信息：

1  In most cases the stride is the same as the width. The stride is useful if you are trying to copy/draw a sub-region of a Bitmap. For instance, if you have a 100x100 bitmap and you want to draw the 50x50 top-right corner, you can use a width of 50px and a stride of 100px．(链接请见附后3)

2  Stride is number of bytes used for storing one image row.

Stride can be different from the image width.

Most of the images are 4 byte aligned.

For ex. a 24 bit (RGB) image with width of 50 pixels. The total bytes required will be 150 (3(RGB)*50). As image will be 4 byte aligned, in this case the byte required will become 154.

So you will see stride as 154, width 50 and image alignment as 4 byte.(链接请见附后3)

上面内容表示stride参数有两种用处

第一种：
可以截取图片中部分区域或者图片拼接．

截图：假设读取像素值的原图片宽为w,高为h,此时设置参数pixels[w*h], 参数stride为 w ,参数offset为0，参数x ,y为截图的起点位置，参数width和height为截图的宽度和高度，则此方法运行后，返回的pixels[]数组中从pixels[0]至pixels[width*height-1]里存储的是从图片( x , y )处起读取的截图大小为width * height的像素值．
示例：修改Android SDK自带的AipDemo程序中BitmapDecode示例，更换图像为自制四角四色图：


图像大小为100*100,想截取图片右上1/4图像(图上黄色部分)修改程序部分代码为：

mBitmap2.getPixels(pixels, 0, w, 50, 0, w/2, h/2);
            String text = String.valueOf(pixels[10]);
            Log.i(SampleView.VIEW_LOG_TAG,text);
            mBitmap3 = Bitmap.createBitmap(pixels, 0, w, w, h,
                                           Bitmap.Config.ARGB_8888);
            mBitmap4 = Bitmap.createBitmap(pixels, 0, w, w, h,
                                           Bitmap.Config.ARGB_4444);

运行后得到如下结果：





现在我们看到右边两副ARGB_8888,ARGB_4444图像隐约只在左上角显示原图右上的1/4黄色部分，其余部分为背景色白色，那么问题又来了，此时ARGB_8888,ARGB_4444图像大小为多少?还是原图的大小(100*100)吗，或者是(50*50)了，不然背景色为何是画布的背景色呢?那么把
pixels[100*100]数组设初始值看下情况(通过Log.i()我查到了pixels中存储的像素值为百万左右的负整数，所以这里胡乱取个数-2578654做为初始值，颜色不太好，请见谅)，修改后代码如下：

int[] pixels = new int[w*h];
            for(int i=0; i < w*h; i++){
            	pixels[i] = -2578654;
            }
            mBitmap2.getPixels(pixels, 0, w, 50, 0, w/2, h/2);
            String text = String.valueOf(pixels[10]);
            Log.i(SampleView.VIEW_LOG_TAG,text);
            mBitmap3 = Bitmap.createBitmap(pixels, 0, w, w, h,
                                           Bitmap.Config.ARGB_8888);
            mBitmap4 = Bitmap.createBitmap(pixels, 0, w, w, h,
                                           Bitmap.Config.ARGB_4444);

运行后结果为：






这样我们就可以看到结果了，如果pixels[]中的数值为int默认值(0)的话，图片相应的部分就为背景色，如果设置为别的初始值而在运行中没有被修改的话就还是原样．


下面设置下getPixels[]方法中offset，使得黄色部分截图出现在它在原图中的位置，
offset = x + y*w ，本例代码如下：

mBitmap2.getPixels(pixels, 50, w, 50, 0, w/2, h/2);

运行结果如下





当然可以用这个方法进行更复杂的运算，诸如截取素材图片修改目标图片(已存储至pixels数组中)的指定区域！！


图片拼接:

假设两张图片大小都为 w * h ，getPixels()方法中设置参数pixels[2*w*h],参数offset = 0，stride = 2*w读取第一张图片，再次运行getPixels()方法，设置参数offset = w，stride = 2*w，读取第二张图片，再将pixels[]绘制到画布上就可以看到两张图片已经拼接起来了．
示例如下：

int w = mBitmap2.getWidth();
            int h = mBitmap2.getHeight();
            int n = 2*w;
            Log.i(SampleView.VIEW_LOG_TAG,String.valueOf(w*h));
            int[] pixels = new int[n*h];
            for(int i=0; i < n*h; i++){
            	pixels[i] = -2578654;
            }
            mBitmap2.getPixels(pixels, 0, n, 0, 0, w, h);
            mBitmap2.getPixels(pixels, w, n, 0, 0, w, h);
            mBitmap3 = Bitmap.createBitmap(pixels, 0, n, n, h,
                                           Bitmap.Config.ARGB_8888);

运行结果如下
　




第二种：　
stride表示数组pixels[]中存储的图片每行的数据，在其中可以附加信息，即
stride = width + padding，如下图所示(图片引自链接请见附后4)





这样可以不仅仅存储图片的像素信息，也可以储存相应每行的其它附加信息．


最后，stride参数的意义及用处总结如下：

1　用来表示pixels[]数组中每行的像素个数，用于行与行之间区分，绝对值必须大于参数width，但不必大于所要读取图片的宽度w（在width < w 时成立）．(stride负数有何作用不知，存疑)．另，pixels.length >= stride * height,否则会抛出ArrayIndexOutOfBoundsException　异常

2　stride > width时，可以在pixels[]数组中添加每行的附加信息，可做它用．

附后：
1, int, int, int, int, int, int)]Android英文文档getPixels()方法介绍

2 Android中文文档getPixels()方法介绍

3 StackOverflow中关于getPixels()问答．

4 图片来源

评论

6 楼 舒马赫 2013-04-19  

流弊火火  

5 楼 水木清华77 2013-01-24  

推测stride为负数的时候，应该是从图片的末尾读，倒着读图片

4 楼 hsz001 2012-07-27  

你好，请问下系统提供的 getPixels()方法里面的int[] pixel参数，在取得值之后是按照类似int[width][height]的顺序存储还是按照int[height][width]方式存储呢？

3 楼 lovexp2010 2012-06-20  

  

2 楼 smilett12345 2012-04-01  

受益匪浅

1 楼 renpeng301 2012-03-27  

透彻