Template

Gunakan gambar tersimpan sebagai target pengenalan. Anda dapat mengubah ukuran atau memotongnya menjadi Template terpisah, lalu menyimpan hasilnya dengan save_as().

Sintaks

Template(name, /)

Parameter konstruktor

NamaDeskripsi
nameString
Templat tersimpan di makro saat ini, misalnya "buttons/top/attack". Nama kosong, tidak ditemukan, atau ambigu menimbulkan error; ini tidak mengambil gambar baru.
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

Contoh

base = Template("enemy_head")
variant = base.scale(0.9).crop(Region(0, 0, 64, 64)).save_as("enemy_head_small")

Field

NamaDeskripsi
nameString?
Nama templat atau jalur folder relatif di makro saat ini; None untuk gambar tanpa nama.
Contoh konstruktor
base = Template("enemy_head")

Metode

6 metode

Template.exists

Periksa apakah nama templat ada di makro saat ini.

Sintaks

Template.exists(name)

Parameter

NamaDeskripsi
nameString
Template name or relative folder path to check.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Boolean — benar jika templatnya ada.

Contoh

if Template.exists("enemy_head"):
    text("ready")

Template.similarity

Bandingkan pola terang dan gelap keseluruhan dua gambar. Gambar yang tidak terbaca atau berbeda dimensi menimbulkan error. Perbandingan mengabaikan transparansi dan bisa melewatkan perubahan warna, kecerahan, atau detail kecil; 100 tidak berarti piksel identik.

Sintaks

template.similarity(other)

Parameter

NamaDeskripsi
otherTemplate
Template wajib dengan lebar dan tinggi gambar yang sama.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Number — Kemiripan 0 hingga 100 dengan selisih tiap tingkat 1.5625; semakin tinggi nilainya, semakin mirip pola terang dan gelapnya.

Contoh

# Bandingkan dua template tersimpan dengan ukuran yang sama.
before = Template("before")
after = Template("after")
score = before.similarity(after)
print(score)

Template.exists

Periksa apakah berkas gambar Template ini masih ada. Ini tidak memeriksa apakah gambar dapat dibaca.

Sintaks

template.exists()

Nilai yang dikembalikan

Boolean — benar jika file template pendukung ada.

Contoh

t = Template("enemy_head")
if t.exists():
    text("ok")

Template.scale

Ubah ukuran gambar dan kembalikan Template terpisah tanpa mengubah sumber. Gunakan save_as() untuk menyimpannya dengan nama pilihan.

Sintaks

template.scale(scale, scale_y=None)

Parameter

NamaDeskripsi
scaleNumber
Pengali lebar: 1 tetap, 0.5 menjadi setengah, 2 menjadi dua kali. Nilai di bawah 0.01 memakai 0.01. Juga berlaku untuk tinggi jika scale_y tidak diisi.
Wajib · Posisi atau nama
Tanpa nilai bawaan
scale_yNumber
Pengali tinggi, minimal 0.01. Jangan diisi untuk mempertahankan proporsi asli.
Opsional · Posisi atau nama
Default: scale

Nilai yang dikembalikan

Template — Objek templat berskala.

Contoh

t = Template("enemy_head")
small = t.scale(0.8)
hit = Region(0, 0, 1080, 2400).find(small, 3000)

Template.crop

Potong sebagian gambar dan kembalikan Template terpisah tanpa mengubah sumber. Gunakan save_as() untuk menyimpannya dengan nama pilihan.

Sintaks

template.crop(region)

Parameter

NamaDeskripsi
regionRegion
Persegi potong dalam piksel gambar, dihitung dari sudut kiri atas gambar, bukan layar. Bagian desimal koordinat dibuang dan koordinat dibatasi ke tepi gambar.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Template — Objek templat terpotong.

Contoh

t = Template("enemy_head")
face = t.crop(Region(10, 10, 60, 60))

Template.save_as

Simpan gambar di makro saat ini dan kembalikan Template tersimpan. Makro terlindungi tidak dapat menyimpan templat; berkas sumber yang hilang menimbulkan error.

Sintaks

template.save_as(name)

Parameter

NamaDeskripsi
nameString
Nama tidak kosong atau jalur folder relatif, misalnya "buttons/top/attack". Gambar yang sudah ada di jalur itu akan diganti.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Template — Objek templat bernama yang disimpan.

Contoh

captured = Region(200, 300, 120, 90).capture()
saved = captured.save_as("buttons/top/enemy_slot")
if saved.exists():
    text("saved")