MonkeyImage

Class monkeyrunner untuk menyimpan gambar dari perangkat atau layar emulator. Gambar disalin dari buffer layar saat pengambilan screenshot. Metode objek ini memungkinkan Anda mengonversi gambar ke dalam berbagai format penyimpanan, menuliskan gambar ke file, menyalin bagian-bagian gambar, dan membandingkan objek ini dengan objek MonkeyImage lainnya.

Anda tidak perlu membuat instance MonkeyImage baru. Sebagai gantinya, gunakan MonkeyDevice.takeSnapshot() untuk membuat instance baru dari screenshot. Misalnya, gunakan: 

newimage = MonkeyDevice.takeSnapshot()

Ringkasan

Metode
string convertToBytes (string format)
Mengonversi gambar saat ini ke dalam format tertentu dan menampilkannya sebagai string yang kemudian dapat Anda akses sebagai iterable byte biner.
tuple getRawPixel (integer x, integer y)
Menampilkan piksel tunggal di lokasi gambar (x,y), sebagai tuple integer, dalam format (a,r,g,b).
integer getRawPixelInt (integer x, integer y)
Menampilkan piksel tunggal di lokasi gambar (x,y) sebagai integer 32 bit.
MonkeyImage getSubImage (tuple rect)
Membuat objek MonkeyImage baru dari pemilihan persegi panjang gambar saat ini.
boolean sameAs (MonkeyImage other, float percent)
Membandingkan objek MonkeyImage ini dengan objek lain dan menampilkan hasil perbandingan. Argumen percent menentukan selisih persentase yang diizinkan agar dua gambar dapat dianggap "setara".
void writeToFile (string path, string format)
Menuliskan gambar saat ini ke file yang ditentukan oleh filename, dalam format yang ditentukan oleh format.

Metode publik

string convertToBytes ( string format)

Mengonversi gambar saat ini ke dalam format tertentu dan menampilkannya sebagai string yang kemudian dapat Anda akses sebagai iterable byte biner.

Argumen
format Format output yang diinginkan. Mendukung semua format output raster umum. Nilai defaultnya adalah "png" (Portable Network Graphics).

tuple getRawPixel (integer x, integer y)

Menampilkan piksel tunggal di lokasi gambar (x,y) sebagai tuple integer dalam format (a,r,g,b).

Argumen
x Posisi horizontal piksel, dimulai dengan 0 di sebelah kiri layar dengan orientasi seperti ketika screenshot diambil.
y Posisi vertikal piksel, dimulai dengan 0 di bagian atas layar dengan orientasi seperti ketika screenshot diambil.
Hasil
  • Tuple integer yang menunjukkan piksel, dalam format (a,r,g,b) dengan a adalah nilai saluran alfa, dan r, g, dan b berturut-turut adalah nilai merah, hijau, dan biru.

tuple getRawPixelInt (integer x, integer y)

Menampilkan piksel tunggal di lokasi gambar (x,y) sebagai integer. Gunakan metode ini untuk menghemat memori.

Argumen
x Posisi horizontal piksel, dimulai dengan 0 di sebelah kiri layar dengan orientasi seperti ketika screenshot diambil.
y Posisi vertikal piksel, dimulai dengan 0 di bagian atas layar dengan orientasi seperti ketika screenshot diambil.
Hasil
  • Nilai a,r,g, dan b piksel sebagai nilai 8 bit yang digabung menjadi integer 32 bit, dengan a sebagai 8 bit sisi paling kiri, r sebagai sisi paling kanan setelahnya, dan seterusnya.

MonkeyImage getSubImage (tuple rect)

Membuat objek MonkeyImage baru dari pemilihan persegi panjang gambar saat ini.

Argumen
rect Tuple (x, y, w, h) menentukan pemilihan. x dan y menentukan posisi piksel berbasis 0 di sudut kiri atas pemilihan. w menentukan lebar area, dan h menentukan tinggi, keduanya dalam satuan piksel.

Orientasi gambar sama dengan orientasi layar pada saat screenshot diambil.

Hasil
  • Objek MonkeyImage baru yang berisi pemilihan.

boolean sameAs ( MonkeyImage otherImage, float percent )

Membandingkan objek MonkeyImage ini dengan objek lain dan menampilkan hasil perbandingan. Argumen percent menentukan selisih persentase yang diizinkan agar dua gambar dapat dianggap "setara".

Argumen
other Objek MonkeyImage lain yang akan dibandingkan dengan objek ini.
percent Float dalam rentang 0,0 hingga 1,0, inklusif, yang menunjukkan persentase piksel yang harus sama agar metode menampilkan nilai true. Default-nya adalah 1,0, yang menunjukkan bahwa semua piksel harus cocok.
Hasil
  • Boolean true jika gambar cocok, atau boolean false jika sebaliknya.

void writeToFile (string filename, string format)

Menuliskan gambar saat ini ke file yang ditentukan oleh filename, dalam format yang ditentukan oleh format.

Argumen
path Nama file dan ekstensi dari file output yang sepenuhnya memenuhi syarat.
format Format output yang akan digunakan untuk file. Jika tidak ada format yang disediakan, metode akan mencoba menebak format dari ekstensi nama file. Jika tidak ada ekstensi yang disediakan dan tidak ada format yang ditentukan, metode akan menggunakan format default "png" (Portable Network Graphics).