MonkeyImage

转自：http://wiki.eoeandroid.com/MonkeyImage

一个用来控制设备或模拟器屏幕图像的猴子快跑(monkeyrunner)类。图像在截屏时通过屏幕缓冲区拷贝出来。该对象的方法允许你将图像转换为各种存储格式、存储与文件、剪裁以及和另一个MonkeyImage对象进行比较。

你不需要新建一个MonkeyImage实例。可以用MonkeyDevice.takeSnapshot()方法通过截屏来新建一个实例。例如使用

newimage = MonkeyDevice.takeSnapshot()

概览

方法
string	convertToBytes(string format) 将当前图像转换成特定格式，并且作为 字符串返回。你可以将它作为可迭代的二进制字节来访问。
tuple	getRawPixel(integer x, integer y) 返回图像位置坐标(x,y)上的单个像素点，作为一个 整数元组，以(a,r,g,b)格式。
integer	getRawPixelInt(integer x, integer y) 返回图像位置坐标(x,y)上的单个像素点，作为一个32位的 整数。
MonkeyImage	getSubImage(tuple rect) 将当前图像上矩形选框选出的区域新建一个 MonkeyImage对象。
boolean	sameAs(MonkeyImage other, float percent) 将该 MonkeyImage对象与其他的进行比较，并返回比较的结果。 percent参数指定两个图像之间差异在多少百分比之内可以看做“相等”。
void	writeToFile(string path, string format) 用指定的文件名将图像以指定的格式写入文件。

公有方法

string convertToBytes (string format)

将当前图像转换成特定格式，并且作为字符串返回。你可以将它作为可迭代的二进制字节来访问。

参数

format 期望输出的格式。支持所有常见的栅格化输出格式。默认值是“png”（Portable Network Graphics编写网络图像）。

tuple getRawPixel (integer x, integer y)

返回图像位置坐标(x,y)上的单个像素点，作为一个整数元组，以(a,r,g,b)格式。

参数

x 水平方向像素位置，在截屏方向的最左边为0点。

y 垂直方向像素位置，在截屏方向的最顶端为0点。

返回

以(a,r,g,b)格式返回一个代表像素的整数元组，其中a是透明度，r,g,b分别是红绿蓝三个颜色值。

integer getRawPixel (integer x, integer y)

返回图像位置坐标(x,y)上的单个像素点，作为一个32位的整数。

参数

x 水平方向像素位置，在截屏方向的最左边为0点。

y 垂直方向像素位置，在截屏方向的最顶端为0点。

返回

一个由像素的a，r,g,b的8位通道值组成的32位整数。其中a是最左边的8位值，r是近邻的8位，以此类推。

MonkeyImage getSubImage (tuple rect)

将当前图像上矩形选框选出的区域新建一个MonkeyImage对象。

参数

rect 一个指定区域的元组(x,y,w,h)。x和y指定了选定区域左上角的0始像素位置。w代表选区宽度，h是高度，都是以像素为单位。

图像的方向与截屏时的手机方向相同。

返回

一个包含选定区域的MonkeyImage对象。

boolean sameAs ( MonkeyImage otherImage, float percent )

将该MonkeyImage对象与其他的进行比较，并返回比较的结果。percent参数指定两个图像之间差异在多少百分比之内可以看做“相等”。

参数

otherImage 用来与本对象比较的另一个MonkeyImage对象。

percent 一个0.0-1.0之间（0.0和1.0包含）浮动的浮点数(float)，它表示一个用来使该方法返回“真”的两个图像含有相同像素的百分比。默认值是1.0，即所有的像素必须相同。

返回

两个图像相同则返回“true”，反之返回“false”。

void writeToFile (string filename, string format)

用指定的文件名将图像以指定的格式写入文件。

参数

filename 完全合法的文件名和输出格式的扩展名后缀。

format 文件输出格式。若未指定，则该放假通过文件名的扩展名来猜测文件格式。若未提供扩展名，则默认使用“png”(Portable Network Graphics便携网络图像)格式。