MonkeyImage

Class monkeyrunner untuk menyimpan gambar dari perangkat atau layar emulator. Gambar disalin dari buffer layar saat 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 format tertentu dan menampilkannya sebagai string yang kemudian dapat Anda akses sebagai iterable byte biner.
tuple getRawPixel (integer x, integer y)
Menampilkan satu piksel pada lokasi gambar (x,y), sebagai tupel integer, dalam bentuk (a,r,g,b).
integer getRawPixelInt (integer x, integer y)
Menampilkan satu piksel pada 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 yang lain dan menampillkan hasil perbandingan. Argumen percent menentukan perbedaan persentase yang diizinkan untuk dua gambar agar "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 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 satu piksel pada lokasi gambar (x,y), sebagai tuple integer, dalam bentuk (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 bilangan bulat yang mewakili piksel, dalam bentuk (a,r,g,b) di mana a adalah nilai saluran alfa, dan r, g, dan b masing-masing adalah nilai merah, hijau, dan biru.

tuple getRawPixelInt (integer x, integer y)

Menampilkan satu piksel pada 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 digabungkan menjadi bilangan bulat 32 bit, dengan a sebagai 8 bit sisi paling kiri, r sebagai sisi paling kanan disebelahnya, 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 yang lain dan menampilkan hasil perbandingannya. Argumen percent menentukan perbedaan persentase yang diizinkan untuk dua gambar agar “setara”.

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

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).