此页面由 Cloud Translation API 翻译。

MonkeyImage

存储设备或模拟器屏幕截图的 monkeyrunner 类。在截图过程中，系统会从屏幕缓冲区复制该图片。此对象的方法可让您将该图片转换为各种存储格式，将该图片写入文件，复制该图片的某些部分，还可以将此对象与其他 MonkeyImage 对象进行比较。

您无需创建 MonkeyImage 的新实例，而是可以使用 MonkeyDevice.takeSnapshot() 根据屏幕截图创建一个新实例。例如，使用以下命令：

newimage = MonkeyDevice.takeSnapshot()

摘要

方法
string	convertToBytes (string format) 将当前图片转换为特定格式并以字符串形式返回该图片，然后您可以将其作为二进制字节的可迭代对象来访问。
tuple	getRawPixel (integer x, integer y) 以 (a,r,g,b) 格式的整数元组形式返回图片位置 (x,y) 处的单个像素。
integer	getRawPixelInt (integer x, integer y) 以 32 位整数形式返回图片位置 (x,y) 处的单个像素。
`MonkeyImage`	getSubImage (tuple rect) 根据当前图片的矩形选择区创建一个新的 `MonkeyImage` 对象。
boolean	sameAs (`MonkeyImage` other, float percent) 将此 `MonkeyImage` 对象与另一个对象进行比较，并返回比较结果。`percent` 参数指定两张“等同”的图片之间可以存在的百分比差异。
void	writeToFile (string path, string format) 将当前图片以 `format` 指定的格式写入 `filename` 指定的文件。

公开方法

string convertToBytes ( string format)

将当前图片转换为特定格式并以字符串形式返回该图片，然后您可以将其作为二进制字节的可迭代对象来访问。

参数

format	所需的输出格式。支持所有常用的光栅输出格式。默认值为“png”(Portable Network Graphics)。

tuple getRawPixel (integer x, integer y)

以 (a,r,g,b) 格式的整数元组形式返回图片位置 (x,y) 处的单个像素。

参数

x	像素的水平位置，以屏幕左边的像素 0 开始，与截取屏幕截图时的方向一致。
y	像素的垂直位置，以屏幕顶部的像素 0 开始，与截取屏幕截图时的方向一致。

一个 (a,r,g,b) 格式的表示像素的整数元组，其中 a 是 Alpha 通道值，r、g 和 b 分别表示红色、绿色和蓝色值。

tuple getRawPixelInt (integer x, integer y)

以整数形式返回图片位置 (x,y) 处的单个像素。使用此方法可以节省内存。

参数

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 参数指定两张“等同”的图片之间可以存在的百分比差异。

参数

other	要与此对象进行比较的另一个 `MonkeyImage` 对象。
percent	介于 0.0（含）到 1.0（含）的浮点数，表示要使方法返回 `true`，必须相同的像素所占百分比。默认值为 1.0，表示所有像素均必须匹配。

如果图片匹配，则返回布尔值 true，否则返回布尔值 false。

void writeToFile (string filename, string format)

将当前图片以 format 指定的格式写入 filename 指定的文件。

参数

path	输出文件的完全限定文件名和扩展名。
format	文件的输出格式。如果没有提供格式，该方法将尝试根据文件扩展名猜出格式。如果未提供扩展名且未指定格式，则使用默认格式“png”(Portable Network Graphics)。