Area layar berbentuk persegi panjang untuk mencari gambar atau warna, mengambil gambar, atau menggambar bingkai. Koordinat memakai piksel pada sumbu horizontal/vertikal saat ini; setelah penskalaan dan pergeseran, hanya bagian di dalam layar yang digunakan. Baca ukurannya dengan x, y, width, height = region.
Sintaks
Region(x, y, width, height, /, scale="fixed", anchor="none", scale_param=ScaleParam())
Cara menyesuaikan koordinat antarlayar penuh: fixed mempertahankan piksel; auto menskalakan X menurut lebar dan Y menurut tinggi; width atau height menskalakan kedua sumbu menurut dimensi itu. Memakai ukuran layar sumber makro, tanpa memutar sumbu atau memakai ukuran jendela aplikasi.
Posisi acuan untuk menyesuaikan koordinat: none (kiri atas), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right. auto memilih tepi atau tengah terdekat.
Cara menyesuaikan koordinat antarlayar penuh: fixed mempertahankan piksel; auto menskalakan X menurut lebar dan Y menurut tinggi; width atau height menskalakan kedua sumbu menurut dimensi itu. Memakai ukuran layar sumber makro, tanpa memutar sumbu atau memakai ukuran jendela aplikasi.
Posisi acuan untuk menyesuaikan koordinat: none (kiri atas), center, top, bottom, left, right, top_left, top_right, bottom_left, bottom_right. auto memilih tepi atau tengah terdekat.
Return the screen width of the device that created this macro, adapted to current screen orientation, when available.
Sintaks
Region.macro_width()
Nilai yang dikembalikan
Number? — Lebar layar sumber makro, atau Tidak Ada bila tidak tersedia.
Contoh
macro_w = Region.macro_width()
Region.macro_height
Static Method
Return the screen height of the device that created this macro, adapted to current screen orientation, when available.
Sintaks
Region.macro_height()
Nilai yang dikembalikan
Number? — Tinggi layar sumber makro, atau Tidak Ada bila tidak tersedia.
Contoh
macro_h = Region.macro_height()
Region.intersection
Method
Mengembalikan irisan berluas positif sebagai Region baru, atau None. Tepi yang hanya bersentuhan tidak beririsan. Menggunakan koordinat tersimpan dalam ruang yang sama tanpa menangkap layar, menskalakan, atau memotong; mempertahankan scale, anchor, dan scale_param Region ini tanpa mengubahnya.
Region? — Koordinat dan tepi hasil perhitungan harus terbatas; jika tidak, terjadi error.
Contoh
# Cari area yang bertumpang tindih
overlap = Region(0, 0, 100, 100).intersection(Region(50, 50, 100, 100))
Region.intersects
Method
Memeriksa irisan berluas positif dengan koordinat tersimpan dalam ruang yang sama. Tepi yang hanya bersentuhan tidak beririsan; tanpa menangkap layar, menskalakan, atau memotong.
Boolean — Koordinat dan tepi hasil perhitungan harus terbatas; jika tidak, terjadi error.
Contoh
# Periksa apakah dua area bertumpang tindih
print(Region(0, 0, 100, 100).intersects(Region(50, 50, 20, 20)))
Region.contains
Method
Memeriksa posisi di dalam area memakai koordinat tersimpan dalam ruang yang sama, tanpa menangkap layar, menskalakan, atau memotong. Titik pada tepi kiri dan atas termasuk, sedangkan pada tepi kanan dan bawah tidak. Region boleh berbagi batas; dimensi kosong atau negatif menghasilkan False.
Boolean — Koordinat dan tepi hasil perhitungan harus terbatas; jika tidak, terjadi error.
Contoh
# Periksa apakah titik berada di dalam area
print(Region(0, 0, 100, 100).contains(Point(10, 10)))
Region.find_text
Method
Cari teks dengan OCR di dalam area ini dalam piksel layar. Hasil harus mencakup kata atau frasa utuh, tanpa memotong huruf, angka, atau garis bawah. Penangkapan layar harus siap. Pencarian diulang sampai ditemukan atau waktu habis, dengan dukungan jeda dan berhenti; cache tangkapan mengikuti pencarian pengenalan lainnya. Kegagalan OCR atau penangkapan menimbulkan kesalahan.
Sistem tulisan OCR: latin, chinese, devanagari, japanese, atau korean. Nilai lain, termasuk alias lokal, menimbulkan kesalahan.
Opsional · Posisi atau nama
Default:"latin"
preserve_caseBoolean
Bedakan huruf besar dan kecil jika True; secara default tidak dibedakan.
Opsional · Posisi atau nama
Default:False
Nilai yang dikembalikan
Match — Match yang ditemukan memiliki bounds dan point dalam piksel layar penuh, confidence dari 0 sampai 1, dan name berisi teks target yang cocok. Jika tidak ditemukan, found=False. Lokasi terpisah dengan skor tertinggi yang sama menimbulkan kesalahan karena ambigu; persempit area pencarian. Hasil yang tumpang tindih dihitung sebagai satu lokasi.
Contoh
# Cari dan ketuk tombol OK di jendela pop-up
hit = Region(500, 100, 400, 300).find_text("OK", timeout=3000)
if hit.found:
click(hit)
Region.find
Method
Cari satu kemunculan templat dalam area ini. Ulangi hingga ditemukan atau batas waktu; timeout=0 memindai sekali. Penangkapan layar harus siap. ScreenCapture.cache_on() memakai ulang satu gambar hingga cache_off(); penggunaan ulang otomatis biasanya sampai 100 ms. Gunakan auto_cache_off() untuk gambar terbaru yang tersedia, dengan beban penangkapan lebih besar.
Nama templat atau jalur folder relatif tanpa ekstensi gambar dalam makro saat ini, atau objek Template. Nama yang tidak dikenal menimbulkan error.
Wajib · Posisi atau nama
Tanpa nilai bawaan
timeoutNumber
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3.0
Nilai yang dikembalikan
Match — Match dengan found=True jika ditemukan; selain itu found=False setelah pemindaian atau batas waktu. Tidak pernah None.
Contoh
region = Region(80, 220, 420, 520)
hit = region.find("ok", 4000, 0.8, 4.0)
MacroPanel.notify(str(hit))
Region.find_multi
Method
Pindai di dalam wilayah ini dan kembalikan semua kecocokan untuk satu templat ketika setidaknya satu templat ditemukan. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.
Nama templat atau jalur folder relatif tanpa ekstensi gambar dalam makro saat ini, atau objek Template. Nama yang tidak dikenal menimbulkan error.
Wajib · Posisi atau nama
Tanpa nilai bawaan
timeoutNumber
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Nama templat/jalur folder relatif tanpa ekstensi gambar, atau objek Template. Nama yang tidak dikenal menimbulkan error.
Wajib · Posisi atau nama
Tanpa nilai bawaan
timeoutNumber
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3.0
Nilai yang dikembalikan
MatchList — Satu Match per templat masukan sesuai urutan, jika ada yang ditemukan; sebagian dapat memiliki found=False. MatchList kosong jika tidak ada yang ditemukan sebelum batas waktu.
Pindai wilayah ini dan kembalikan hanya ketika setiap templat dalam daftar ditemukan. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.
Nama templat/jalur folder relatif tanpa ekstensi gambar, atau objek Template. Nama yang tidak dikenal menimbulkan error.
Wajib · Posisi atau nama
Tanpa nilai bawaan
timeoutNumber
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3.0
Nilai yang dikembalikan
MatchList — Satu Match berhasil per templat masukan sesuai urutan, atau MatchList kosong jika tidak ada pemindaian yang menemukan semuanya sebelum batas waktu.
Cari satu piksel yang diperiksa dengan warna paling dekat ke target dalam area ini. Selisih setiap kanal merah, hijau, dan biru tidak boleh melebihi tolerance; dipilih titik dengan selisih kanal terbesar yang paling kecil. Ulangi hingga ditemukan atau batas waktu; timeout=0 memindai sekali. Memerlukan penangkapan layar yang siap.
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Opsional · Posisi atau nama
Default:0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
Opsional · Posisi atau nama
Default:0
rateNumber
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3
intervalNumber
Jarak yang diminta dalam piksel antarposisi yang diperiksa; minimal 1. Nilai lebih kecil memeriksa lebih banyak piksel dan dapat lebih lama. Jarak dapat bertambah otomatis untuk area besar.
Opsional · Posisi atau nama
Default:10
Nilai yang dikembalikan
Match — Match dengan maksimal satu Point di point, atau found=False dan daftar point kosong jika tidak ada piksel yang diperiksa cocok atau penangkapan tidak tersedia.
Contoh
scan = Region(80, 220, 420, 520)
hit = scan.find_color("#FF4CAF50", tolerance=8, interval=4)
if hit.found:
click(hit.point[0], random=0)
Region.find_any_color
Method
Cari salah satu warna target dalam area ini dengan aturan toleransi RGB find_color. Kembalikan maksimal satu titik terbaik yang diperiksa per warna yang ditemukan, sesuai urutan masukan. Ulangi hingga ada warna ditemukan atau batas waktu; timeout=0 memindai sekali. Memerlukan penangkapan layar yang siap.
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Opsional · Posisi atau nama
Default:0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
Opsional · Posisi atau nama
Default:0
rateNumber
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3
intervalNumber
Jarak yang diminta dalam piksel antarposisi yang diperiksa; minimal 1. Nilai lebih kecil memeriksa lebih banyak piksel dan dapat lebih lama. Jarak dapat bertambah otomatis untuk area besar.
Opsional · Posisi atau nama
Default:10
Nilai yang dikembalikan
Match — Match dengan satu Point terbaik per warna yang ditemukan di point, sesuai urutan masukan. found=False dan daftar point kosong jika tidak ada yang cocok atau penangkapan tidak tersedia.
Contoh
colors = ["#FF0000", "#00FF00", "#0000FF"]
hit = Region.full_screen().find_any_color(colors, tolerance=6)
if hit.found:
click(hit, random=0)
Region.find_multi_color
Method
Cari semua piksel yang diperiksa yang cocok dengan satu warna target memakai aturan toleransi RGB find_color. Daftar atau tuple warna menimbulkan error. Ulangi hingga minimal satu titik ditemukan atau batas waktu; timeout=0 memindai sekali. Memerlukan penangkapan layar yang siap.
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Opsional · Posisi atau nama
Default:0
toleranceNumber
Allowed per-channel RGB delta from 0 to 255.
Opsional · Posisi atau nama
Default:0
rateNumber
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3
intervalNumber
Jarak yang diminta dalam piksel antarposisi yang diperiksa; minimal 1. Nilai lebih kecil memeriksa lebih banyak piksel dan dapat lebih lama. Jarak dapat bertambah otomatis untuk area besar.
Opsional · Posisi atau nama
Default:10
Nilai yang dikembalikan
Match — Match berisi Points yang diperiksa dan cocok di point, dengan warna terdekat lebih dahulu. found=False dan daftar point kosong jika tidak ada yang cocok atau penangkapan tidak tersedia.
Contoh
hit = Region(80, 220, 420, 520).find_multi_color("red", tolerance=4, interval=3)
if hit.found:
first = hit.point[0]
hit.highlight(color="yellow", auto_hide_ms=800)
Region.wait
Method
Tunggu hingga template menghilang dari wilayah ini. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.
Nama templat atau jalur folder relatif tanpa ekstensi gambar dalam makro saat ini, atau objek Template. Nama yang tidak dikenal menimbulkan error.
Wajib · Posisi atau nama
Tanpa nilai bawaan
timeoutNumber
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3.0
Nilai yang dikembalikan
Match — Match terbaru: found=False berarti gambar tidak terlihat; found=True berarti gambar masih terlihat saat penantian berakhir. Tidak pernah None. Memerlukan penangkapan layar yang siap; penangkapan tidak tersedia juga dapat menghasilkan found=False.
Contoh
region = Region(0, 0, 1080, 2400)
result = region.wait("loading", 8000)
MacroPanel.notify(str(result))
Region.wait_any
Method
Tunggu hingga templat apa pun dalam daftar hilang dari wilayah ini. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.
Nama templat/jalur folder relatif tanpa ekstensi gambar, atau objek Template. Nama yang tidak dikenal menimbulkan error.
Wajib · Posisi atau nama
Tanpa nilai bawaan
timeoutNumber
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3.0
Nilai yang dikembalikan
MatchList — Match terbaru untuk setiap templat masukan sesuai urutan, saat ada yang menghilang atau batas waktu. Periksa setiap nilai found; False berarti gambar itu tidak terlihat. Memerlukan penangkapan layar yang siap; penangkapan tidak tersedia juga dapat menghasilkan found=False.
Contoh
watch = ["loading", "syncing"]
result = region.wait_any(watch, 10000)
MacroPanel.notify(str(result))
Region.wait_all
Method
Tunggu hingga semua templat dalam daftar hilang dari wilayah ini. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.
Nama templat/jalur folder relatif tanpa ekstensi gambar, atau objek Template. Nama yang tidak dikenal menimbulkan error.
Wajib · Posisi atau nama
Tanpa nilai bawaan
timeoutNumber
Waktu tunggu maksimum dalam milidetik. Tidak diisi, nol, atau negatif memindai sekali. Pemindaian yang sedang berjalan dapat selesai setelah waktu ini.
Pemindaian yang diminta per detik saat menunggu, dibatasi 1-60. Kecepatan nyata bergantung pada waktu pengenalan.
Opsional · Posisi atau nama
Default:3.0
Nilai yang dikembalikan
MatchList — Match terbaru untuk setiap templat masukan sesuai urutan, saat gambar menghilang atau batas waktu. Semua nilai found adalah False hanya jika semua gambar tidak terlihat. Memerlukan penangkapan layar yang siap; penangkapan tidak tersedia juga dapat menghasilkan found=False.
Contoh
watch = ["loading", "syncing"]
result = region.wait_all(watch, 10000)
MacroPanel.notify(str(result))
Region.capture
Method
Ambil area layar ini sebagai Template. Memerlukan sesi penangkapan layar aktif yang telah disetujui pengguna. Penangkapan tidak tersedia atau area sepenuhnya di luar layar menimbulkan error.
Kecilkan secara horizontal ke arah tengah dengan menggerakkan tepi kiri dan kanan ke dalam.
Sintaks
region.horizontal(value=0.5)
Parameter
Nama
Deskripsi
valueNumber
Total lebar yang dibuang, dibagi sama rata di kedua sisi: 0-1 adalah proporsi, di atas 1 adalah piksel. Maksimal selebar area; nilai negatif menimbulkan error.
Opsional · Posisi atau nama
Default:0.5
Nilai yang dikembalikan
Region — Wilayah terpusat dengan lebar yang dikurangi.
Kecilkan secara vertikal ke arah tengah dengan menggerakkan tepi atas dan bawah ke dalam.
Sintaks
region.vertical(value=0.5)
Parameter
Nama
Deskripsi
valueNumber
Total tinggi yang dibuang, dibagi sama rata di kedua sisi: 0-1 adalah proporsi, di atas 1 adalah piksel. Maksimal setinggi area; nilai negatif menimbulkan error.
Opsional · Posisi atau nama
Default:0.5
Nilai yang dikembalikan
Region — Wilayah terpusat dengan ketinggian berkurang.
Jumlah yang dibuang dari setiap dimensi: 0-1 adalah proporsi dimensi itu; di atas 1 adalah piksel. Dibagi sama rata di sisi berlawanan, maksimal sebesar setiap dimensi. Nilai negatif menimbulkan error.
Opsional · Posisi atau nama
Default:0.5
Nilai yang dikembalikan
Region — Wilayah terpusat tereduksi pada kedua sumbu.
Gambar bingkai persegi panjang di sekitar area ini. Pemanggilan ulang pada Region yang sama mengganti bingkainya. Kembali sebelum gambar selesai; hanya pembaruan terakhir sebelum penyegaran layar berikutnya yang ditampilkan.