Runtime v2.81 · Diperbarui 30 Sep 2026

Template

Pembungkus gambar templat.

Sintaks

Template(name, /)

Parameter konstruktor

NamaDeskripsi
nameString
Template name in current macro, optionally as a relative folder path such as "buttons/top/attack".
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

Template

Perilaku / efek samping

Pembungkus gambar templat. Anda dapat menskalakan/memotong templat yang sudah ada, menyimpannya sebagai nama templat baru, atau memeriksa keberadaannya.

Eksekusi

  • Menunggu selesai: Bersyarat
  • Keamanan akses bersamaan: Tidak dijamin
  • Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Tidak ada

Field

NamaDeskripsi
nameString?
Template name or relative folder path when this object points to a named template in current macro.
Contoh konstruktor
base = Template("enemy_head")

Metode

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

Perilaku / efek samping

Periksa apakah nama templat ada di makro saat ini.

Eksekusi

  • Menunggu selesai: Bersyarat
  • Keamanan akses bersamaan: Tidak dijamin
  • Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Template.exists

Periksa apakah objek Template ini masih mengarah ke file yang sudah ada.

Sintaks

template.exists()

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean — benar jika file template pendukung ada.

Perilaku / efek samping

Periksa apakah objek Template ini masih mengarah ke file yang sudah ada.

Eksekusi

  • Menunggu selesai: Bersyarat
  • Keamanan akses bersamaan: Tidak dijamin
  • Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Template.scale

Buat salinan templat berskala dan kembalikan sebagai objek Templat lainnya.

Sintaks

template.scale(scale, scale_y=None)

Parameter

NamaDeskripsi
scaleNumber
Scale factor for X axis (and Y axis when scale_y is omitted).
Wajib · Posisi atau nama
Tanpa nilai bawaan
scale_yNumber
Optional Y-axis scale factor.
Opsional · Posisi atau nama
Default: scale

Nilai yang dikembalikan

Template — Objek templat berskala.

Perilaku / efek samping

Buat salinan templat berskala dan kembalikan sebagai objek Templat lainnya.

Eksekusi

  • Menunggu selesai: Bersyarat
  • Keamanan akses bersamaan: Tidak dijamin
  • Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Template.crop

Pangkas templat ini berdasarkan wilayah dalam piksel templat-lokal dan kembalikan objek Templat baru.

Sintaks

template.crop(region)

Parameter

NamaDeskripsi
regionRegion
Crop region in template-local coordinates.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Template — Objek templat terpotong.

Perilaku / efek samping

Pangkas templat ini berdasarkan wilayah dalam piksel templat-lokal dan kembalikan objek Templat baru.

Eksekusi

  • Menunggu selesai: Bersyarat
  • Keamanan akses bersamaan: Tidak dijamin
  • Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Template.save_as

Simpan objek templat ini ke dalam templat makro saat ini menggunakan nama baru atau jalur folder relatif.

Sintaks

template.save_as(name)

Parameter

NamaDeskripsi
nameString
New template name, optionally including folders such as "buttons/top/attack".
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Template — Objek templat bernama yang disimpan.

Perilaku / efek samping

Simpan objek templat ini ke dalam templat makro saat ini menggunakan nama baru atau jalur folder relatif.

Eksekusi

  • Menunggu selesai: Bersyarat
  • Keamanan akses bersamaan: Tidak dijamin
  • Eksekusi paralel: Bersyarat

Biaya pemrosesan dan waktu tunggu bergantung pada operasi yang didokumentasikan. Simpan nilai yang dapat berubah dalam alur pemiliknya; berbagi objek sembarang antaralur tidak dijamin aman.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait