MonkeyImage

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

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

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

newimage = MonkeyDevice.takeSnapshot()

概览

公有方法

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

参数

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

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

参数

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

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

返回

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

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

参数

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

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

返回

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

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

参数

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

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

返回

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

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

参数

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

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

返回

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

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

参数

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

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