1. 背景

鉴于网上使用MonkeyImage的实例除了方法sameAs外非常难找到，所以本人把实践各个API的过程记录下来然自己有更感性的认识，也为往后的工作打下更好的基础。同一时候也和上一篇文章《》起到相互呼应的作用。

由于并没有MonkeyRunner的项目背景，所以这里很多其它的是描写叙述各个API是怎么一回事。而不是描写叙述在什么场景下须要用到。也就是说是去回答What，而不是How。

首先我们先看下官方给出的MonkeyImage的API描写叙述，对照我如今反编译的最新的源代码是一致的：

Return Type	Methods	Comment
string	(string format) Converts the current image to a particular format and returns it as a string that you can then access as an iterable of binary bytes.
tuple	(integer x, integer y) Returns the single pixel at the image location (x,y), as an a tuple of integer, in the form (a,r,g,b).
integer	(integer x, integer y) Returns the single pixel at the image location (x,y), as a 32-bit integer.
	(tuple rect) Creates a new `MonkeyImage` object from a rectangular selection of the current image.
boolean	( other, float percent) Compares this `MonkeyImage` object to another and returns the result of the comparison. The`percent` argument specifies the percentage difference that is allowed for the two images to be "equal".
void	(string path, string format) Writes the current image to the file specified by `filename`, in the format specified by `format`.

2. String convertToBytes(string format)

2.1 演示样例

img = device.takeSnapshot()png1 = img.convertToBytes()png2 = img.convertToBytes()bmp = img.convertToBytes('bmp')jpg = img.convertToBytes('JPG')gif = img.convertToBytes('gif')raw = img.convertToBytes('raw')invalid = img.convertToBytes('xxx')#is the 2 pngs equal?print "Two png is equal in bytes:",png1 == png2#is the png equals to bmp?print "png and bmp is equal in bytes:", png1 == bmp#is the jpg eqals to the raw?print "jpg and bmp is equals in bytes:",jpg == bmp#is the jpg eqals to the xxx?print "jpg is a valid argument:",jpg != invalid#is the gif eqals to the xxx?

print "gif is a valid argument:",gif != invalid #is the bmp eqals to the xxx? print "bmp is a valid argument:",bmp != invalid #is the raw equas to xxxx? aims at checking whether argument 'raw' is invalid like 'xxx' print 'raw is a valid argument:',raw != invalid #would invalid argument drop to png by default?

print 'Would invalid argument drop to png by default:',png1 == invalid

输出：

2.2 分析

除了默认的png。经常使用格式jpg,gif都支持，但bmp格式无效。至于还支持什么其它格式，尝试跟踪了下代码。没有找到想要的结果

3. tuple getRawPixel(integer x, integer y)和Integer getRawPixelInt (integer x, integer y)

3.1 演示样例

viewer = device.getHierarchyViewer()note = viewer.findViewById('id/title')text = viewer.getText(note)print text.encode('utf-8')point = viewer.getAbsoluteCenterOfView(note)x = point.xy = point.yimg = device.takeSnapshot()pixelTuple = img.getRawPixel(x,y)pixelInt = img.getRawPixelInt(x,y)print "Pixel in tuple:",pixelTupleprint "Pixel in int:", pixelInt

输出：

3.2 分析

这里把两个相似的方法放到一起来比較，他们都是获得指定一个坐标的argb值，当中a就是alpha（透明度）。rgb就是颜色三元组红绿蓝了。但前者返回的是一个元组，后者返回的是整型。

那么两个类型的值是怎么相应起来的呢？事实上就是第一个方法的元组的返回值(a,r,g,b)中的每一个值转换成8个bit的二进制值然后按顺序从左到右排列起来再转换成十进制整型就是第二个方法的返回值了。

以演示样例输出为例，比方b在第一个返回值中是141，换成二进制就是1001101，其它雷同。

再看第二个方法的整型返回值是-7500403。转换成二进制事实上就是11111111100011011000110110001101（至于下图calculator转换后为什么前面那么多个1。事实上不用管他，由于是负数所曾经面要加上FF之类而已）。那么最后的8个bit转换成十进制事实上就是上面的的141.

4. MonkeyImage getSubImage(tuple rect)

4.1 演示样例

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice,MonkeyImagefrom com.android.monkeyrunner.easy import EasyMonkeyDevice,Byfrom com.android.chimpchat.hierarchyviewer import HierarchyViewerfrom com.android.hierarchyviewerlib.models import ViewNode, Windowfrom java.awt import Point#from com.android.hierarchyviewerlib.device import #Connect to the target targetDevicetargetDevice = MonkeyRunner.waitForConnection()easy_device = EasyMonkeyDevice(targetDevice)  #touch a button by id would need thistargetDevice.startActivity(component="com.example.android.notepad/com.example.android.notepad.NotesList")#invoke the menu optionsMonkeyRunner.sleep(6)#targetDevice.press('KEYCODE_MENU', MonkeyDevice.DOWN_AND_UP);'''     public ViewNode findViewById(String id)      * @param id id for the view.     * @return view with the specified ID, or {@code null} if no view found.'''#MonkeyRunner.alert("Continue?", "help", "Ok?")pic = targetDevice.takeSnapshot()pic = pic.getSubImage((0,38,480,762))newPic = targetDevice.takeSnapshot()newPic = newPic.getSubImage((0,38,480,762))print (newPic.sameAs(pic,1.0))newPic.writeToFile('./shot1.png','png')