Region

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

Parameter konstruktor

NamaDeskripsi
xNumber
Top-left X coordinate
Wajib · Hanya posisi
Tanpa nilai bawaan
yNumber
Top-left Y coordinate
Wajib · Hanya posisi
Tanpa nilai bawaan
widthNumber
Region width
Wajib · Hanya posisi
Tanpa nilai bawaan
heightNumber
Region height
Wajib · Hanya posisi
Tanpa nilai bawaan
scaleString
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.
Opsional · Posisi atau nama
Default: fixed
anchorString
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.
Opsional · Posisi atau nama
Default: none
scale_paramScaleParam
**Applies to templates**. Template matching scale parameters.
Opsional · Posisi atau nama
Default: ScaleParam()

Nilai yang dikembalikan

Contoh

region = Region(100, 200, 300, 400)
hit = region.find("img", 3000, threshold=0.8, rate=3.0)

Field

NamaDeskripsi
xNumber
Top-left horizontal coordinate.
yNumber
Top-left vertical coordinate.
widthNumber
Region width in pixels.
heightNumber
Region height in pixels.
scaleString
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.
Default: fixed
anchorString
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.
Default: none
scale_paramScaleParam
**Applies to templates**. Template matching scale parameters used by find/wait methods on this region.
Default: ScaleParam()
middle_pointPoint
Center point of this region.
Contoh field
search_area = Region(120, 240, 360, 420)
left = search_area.x
top = search_area.y
w = search_area.width
h = search_area.height
scale = search_area.scale
anchor = search_area.anchor
search_area.x = 300
search_area.scale_param = ScaleParam(auto_scale=True, template_scale="LONG_EDGE")
center = search_area.middle_point

# Bongkar Region menjadi x, y, width, height
x, y, width, height = search_area
Contoh konstruktor
search_region = Region(120, 240, 360, 420)
fixed_center = Region(120, 240, 360, 420, "fixed", "center")
left_lane = Region(120, 240, 360, 420, scale="width", anchor="left", scale_param=ScaleParam(auto_scale=True, template_scale="LONG_EDGE"))

Metode

30 metode

Region.from_center

Membuat Region fixed tanpa anchor dari koordinat pusat terbatas dan dimensi positif terbatas. Koordinat pecahan dipertahankan.

Sintaks

Region.from_center(cx, cy, width, height)

Parameter

NamaDeskripsi
cxNumber
Koordinat X pusat.
Wajib · Posisi atau nama
Tanpa nilai bawaan
cyNumber
Koordinat Y pusat.
Wajib · Posisi atau nama
Tanpa nilai bawaan
widthNumber
Lebar positif.
Wajib · Posisi atau nama
Tanpa nilai bawaan
heightNumber
Tinggi positif.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Region — Koordinat dan tepi hasil perhitungan harus terbatas; jika tidak, terjadi error.

Contoh

# Buat area di sekitar pusat
area = Region.from_center(100, 200, 50, 30)

Region.highlighted

Mengembalikan area layar yang sedang diberi bingkai oleh skrip, termasuk bingkai persegi dari Point.highlight().

Sintaks

Region.highlighted()

Nilai yang dikembalikan

list[Region] — daftar wilayah aktif yang disorot.

Contoh

active_regions = Region.highlighted()
for area in active_regions:
    area.highlight("yellow", auto_hide_ms=500)

Region.full_screen

Kembalikan wilayah layar penuh saat ini.

Sintaks

Region.full_screen()

Nilai yang dikembalikan

Region — Region yang mencakup seluruh layar saat ini dari (0, 0).

Contoh

scan = Region.full_screen()
hit = scan.find("ok", 2000)

Region.highlight_off

Matikan semua sorotan wilayah aktif.

Sintaks

Region.highlight_off()

Nilai yang dikembalikan

None — Tidak ada nilai.

Contoh

scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
Region.highlight_off()

Region.macro_width

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

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

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.

Sintaks

region.intersection(other)

Parameter

NamaDeskripsi
otherRegion
Area lainnya.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

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

Memeriksa irisan berluas positif dengan koordinat tersimpan dalam ruang yang sama. Tepi yang hanya bersentuhan tidak beririsan; tanpa menangkap layar, menskalakan, atau memotong.

Sintaks

region.intersects(other)

Parameter

NamaDeskripsi
otherRegion
Area lainnya.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

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

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.

Sintaks

region.contains(point_or_region)

Parameter

NamaDeskripsi
point_or_regionPoint | Region
Titik atau area yang diperiksa.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

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

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.

Sintaks

region.find_text(text, timeout=0, threshold=100, rate=5, language="latin", preserve_case=False)

Parameter

NamaDeskripsi
textString
Teks yang dicari; tidak boleh kosong.
Wajib · Posisi atau nama
Tanpa nilai bawaan
timeoutNumber
Waktu tunggu maksimum dalam milidetik; nol atau nilai negatif memindai satu kali.
Opsional · Posisi atau nama
Default: 0
thresholdInteger
Ambang kecocokan OCR berupa bilangan bulat dari 0 sampai 100; 100 memerlukan kecocokan tepat setelah normalisasi.
Opsional · Posisi atau nama
Default: 100
rateNumber
Jumlah pemindaian per detik yang diminta saat menunggu, dalam Hz, dibatasi dari 1 sampai 60.
Opsional · Posisi atau nama
Default: 5
languageString
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

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.

Sintaks

region.find(template, timeout=0, threshold=0.7, rate=3.0)

Parameter

NamaDeskripsi
templateString | Template
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.
Opsional · Posisi atau nama
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsional · Posisi atau nama
Default: 0.7
rateNumber
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

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.

Sintaks

region.find_multi(template, timeout=0, threshold=0.7, rate=3.0)

Parameter

NamaDeskripsi
templateString | Template
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.
Opsional · Posisi atau nama
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsional · Posisi atau nama
Default: 0.7
rateNumber
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 — Semua cocok untuk templat, atau daftar kosong saat batas waktu habis.

Contoh

region = Region(80, 220, 420, 520)
matches = region.find_multi("enemy", 3000)
MacroPanel.notify(str(matches))

Region.find_any

Pindai wilayah ini dan kembalikan ketika templat apa pun dalam daftar ditemukan. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.

Sintaks

region.find_any(templates, timeout=0, threshold=0.7, rate=3.0)

Parameter

NamaDeskripsi
templateslist[String | Template]
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.
Opsional · Posisi atau nama
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsional · Posisi atau nama
Default: 0.7
rateNumber
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.

Contoh

region = Region(80, 220, 420, 520)
matches = region.find_any(["enemy_a", "enemy_b"], 2500)
MacroPanel.notify(str(matches))

Region.find_all

Pindai wilayah ini dan kembalikan hanya ketika setiap templat dalam daftar ditemukan. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.

Sintaks

region.find_all(templates, timeout=0, threshold=0.7, rate=3.0)

Parameter

NamaDeskripsi
templateslist[String | Template]
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.
Opsional · Posisi atau nama
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsional · Posisi atau nama
Default: 0.7
rateNumber
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.

Contoh

region = Region(80, 220, 420, 520)
matches = region.find_all(["hp", "mp"], 5000)
MacroPanel.notify(str(matches))

Region.find_color

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.

Sintaks

region.find_color(color, timeout=0, tolerance=0, rate=3, interval=10)

Parameter

NamaDeskripsi
colorColor | String | Number
Target color.
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.
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

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.

Sintaks

region.find_any_color(colors, timeout=0, tolerance=0, rate=3, interval=10)

Parameter

NamaDeskripsi
colorslist[Color | String | Number] | tuple[Color | String | Number]
Target colors.
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.
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

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.

Sintaks

region.find_multi_color(color, timeout=0, tolerance=0, rate=3, interval=10)

Parameter

NamaDeskripsi
colorColor | String | Number
Single target color.
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.
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

Tunggu hingga template menghilang dari wilayah ini. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.

Sintaks

region.wait(template, timeout=0, threshold=0.7, rate=3.0)

Parameter

NamaDeskripsi
templateString | Template
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.
Opsional · Posisi atau nama
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsional · Posisi atau nama
Default: 0.7
rateNumber
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

Tunggu hingga templat apa pun dalam daftar hilang dari wilayah ini. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.

Sintaks

region.wait_any(templates, timeout=0, threshold=0.7, rate=3.0)

Parameter

NamaDeskripsi
templateslist[String | Template]
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.
Opsional · Posisi atau nama
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsional · Posisi atau nama
Default: 0.7
rateNumber
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

Tunggu hingga semua templat dalam daftar hilang dari wilayah ini. Jika batas waktu dihilangkan, hanya satu pemindaian yang dilakukan.

Sintaks

region.wait_all(templates, timeout=0, threshold=0.7, rate=3.0)

Parameter

NamaDeskripsi
templateslist[String | Template]
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.
Opsional · Posisi atau nama
Default: 0
thresholdNumber
Match threshold from 0.0 to 1.0.
Opsional · Posisi atau nama
Default: 0.7
rateNumber
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

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.

Sintaks

region.capture(name=None)

Parameter

NamaDeskripsi
nameString?
Nama menyimpan gambar langsung ke makro saat ini; None membuat gambar sementara. Menyimpan gambar bernama tidak diizinkan dalam makro terlindungi.
Opsional · Posisi atau nama
Default: None

Nilai yang dikembalikan

Template — Template berisi gambar yang diambil.

Contoh

sample = Region(120, 280, 220, 120).capture()
saved = sample.save_as("buttons/top/enemy_slot")

Region.left

Kecilkan wilayah ini ke arah sisi kiri. Tepi kanan bergerak ke kiri sesuai jumlah yang diminta.

Sintaks

region.left(value=0.5)

Parameter

NamaDeskripsi
valueNumber
Lebar yang dibuang: 0-1 adalah proporsi lebar saat ini; di atas 1 adalah piksel, maksimal selebar area. Nilai negatif menimbulkan error.
Opsional · Posisi atau nama
Default: 0.5

Nilai yang dikembalikan

Region — Wilayah baru menyempit dari tepi kanan.

Contoh

full = Region(100, 200, 1000, 500)
left_focus = full.left(0.4)
left_focus_px = full.left(400)

Region.right

Kecilkan wilayah ini ke arah sisi kanan. Tepi kiri bergerak ke kanan sesuai jumlah yang diminta.

Sintaks

region.right(value=0.5)

Parameter

NamaDeskripsi
valueNumber
Lebar yang dibuang: 0-1 adalah proporsi lebar saat ini; di atas 1 adalah piksel, maksimal selebar area. Nilai negatif menimbulkan error.
Opsional · Posisi atau nama
Default: 0.5

Nilai yang dikembalikan

Region — Wilayah baru menyempit dari tepi kiri.

Contoh

full = Region(100, 200, 1000, 500)
right_focus = full.right(0.3)
right_focus_px = full.right(240)

Region.top

Kecilkan wilayah ini ke arah sisi atas. Tepi bawah bergerak ke atas sesuai jumlah yang diminta.

Sintaks

region.top(value=0.5)

Parameter

NamaDeskripsi
valueNumber
Tinggi yang dibuang: 0-1 adalah proporsi tinggi saat ini; di atas 1 adalah piksel, maksimal setinggi area. Nilai negatif menimbulkan error.
Opsional · Posisi atau nama
Default: 0.5

Nilai yang dikembalikan

Region — Wilayah baru menyempit dari tepi bawah.

Contoh

full = Region(100, 200, 1000, 500)
top_focus = full.top(0.25)
top_focus_px = full.top(120)

Region.bottom

Kecilkan wilayah ini ke sisi bawah. Tepi atas bergerak ke bawah sesuai jumlah yang diminta.

Sintaks

region.bottom(value=0.5)

Parameter

NamaDeskripsi
valueNumber
Tinggi yang dibuang: 0-1 adalah proporsi tinggi saat ini; di atas 1 adalah piksel, maksimal setinggi area. Nilai negatif menimbulkan error.
Opsional · Posisi atau nama
Default: 0.5

Nilai yang dikembalikan

Region — Wilayah baru menyempit dari tepi atas.

Contoh

full = Region(100, 200, 1000, 500)
bottom_focus = full.bottom(0.25)
bottom_focus_px = full.bottom(120)

Region.horizontal

Kecilkan secara horizontal ke arah tengah dengan menggerakkan tepi kiri dan kanan ke dalam.

Sintaks

region.horizontal(value=0.5)

Parameter

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

Contoh

full = Region(100, 200, 1000, 500)
center_lane = full.horizontal(0.5)
center_lane_px = full.horizontal(300)

Region.vertical

Kecilkan secara vertikal ke arah tengah dengan menggerakkan tepi atas dan bawah ke dalam.

Sintaks

region.vertical(value=0.5)

Parameter

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

Contoh

full = Region(100, 200, 1000, 500)
center_band = full.vertical(0.5)
center_band_px = full.vertical(200)

Region.middle

Kecilkan lebar dan tinggi ke arah tengah.

Sintaks

region.middle(value=0.5)

Parameter

NamaDeskripsi
valueNumber
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.

Contoh

full = Region(100, 200, 1000, 500)
focus = full.middle(0.4)
focus_px = full.middle(160)

Region.highlight

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.

Sintaks

region.highlight(color="green", line_width=2, auto_hide_ms=0, movable=False)

Parameter

NamaDeskripsi
colorColor | String | Number
Highlight color.
Opsional · Posisi atau nama
Default: green
line_widthNumber
Ketebalan bingkai dalam dp; nilai di bawah 1 menjadi 1.
Opsional · Posisi atau nama
Default: 2
auto_hide_msNumber
Auto-hide after N milliseconds. 0 disables auto-hide.
Opsional · Posisi atau nama
Default: 0
movableBoolean
Allow dragging the highlighted region and write the moved coordinates back into this Region.
Opsional · Posisi atau nama
Default: False

Nilai yang dikembalikan

Region — Mengembalikan wilayah yang sama setelah menyorot gambar.

Contoh

scan = Region(120, 260, 280, 160)
scan.highlight("#FF00BCD4", line_width=3, auto_hide_ms=1500, movable=True)

Region.highlight_off

Hapus bingkai yang dibuat oleh Region ini.

Sintaks

region.highlight_off()

Nilai yang dikembalikan

Region — Mengembalikan wilayah yang sama setelah mematikan sorotan.

Contoh

scan = Region(120, 260, 280, 160)
scan.highlight("green")
wait(1000)
scan.highlight_off()