Runtime v2.81 · Na-update noong Set 30, 2026

Template

Pambalot ng larawan ng template.

Syntax

Template(name, /)

Mga parameter ng constructor

PangalanPaglalarawan
nameString
Template name in current macro, optionally as a relative folder path such as "buttons/top/attack".
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

Template

Pagkilos / epekto

Pambalot ng larawan ng template. Maaari mong sukatin/i-crop ang isang kasalukuyang template, i-save ito bilang isang bagong pangalan ng template, o suriin ang pagkakaroon.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Wala

Mga field

PangalanPaglalarawan
nameString?
Template name or relative folder path when this object points to a named template in current macro.
Halimbawa ng constructor
base = Template("enemy_head")

Mga method

5 method

Template.exists

Suriin kung mayroong pangalan ng template sa kasalukuyang macro.

Syntax

Template.exists(name)

Mga parameter

PangalanPaglalarawan
nameString
Template name or relative folder path to check.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Boolean — totoo kung umiiral ang template.

Pagkilos / epekto

Suriin kung mayroong pangalan ng template sa kasalukuyang macro.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Template.exists

Suriin kung ang object na ito ng Template ay tumuturo pa rin sa isang umiiral na file.

Syntax

template.exists()

Mga parameter

Wala

Ibinabalik na halaga

Boolean — true kung umiiral ang backing template file.

Pagkilos / epekto

Suriin kung ang object na ito ng Template ay tumuturo pa rin sa isang umiiral na file.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Template.scale

Gumawa ng naka-scale na kopya ng template at ibalik ito bilang isa pang bagay na Template.

Syntax

template.scale(scale, scale_y=None)

Mga parameter

PangalanPaglalarawan
scaleNumber
Scale factor for X axis (and Y axis when scale_y is omitted).
Kailangan · Ayon sa posisyon o pangalan
Walang default
scale_yNumber
Optional Y-axis scale factor.
Opsyonal · Ayon sa posisyon o pangalan
Default: scale

Ibinabalik na halaga

Template — Naka-scale na template object.

Pagkilos / epekto

Gumawa ng naka-scale na kopya ng template at ibalik ito bilang isa pang bagay na Template.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Template.crop

I-crop ang template na ito ayon sa isang rehiyon sa template-local na mga pixel at magbalik ng bagong Template object.

Syntax

template.crop(region)

Mga parameter

PangalanPaglalarawan
regionRegion
Crop region in template-local coordinates.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Template — Na-crop na object ng template.

Pagkilos / epekto

I-crop ang template na ito ayon sa isang rehiyon sa template-local na mga pixel at magbalik ng bagong Template object.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Template.save_as

I-save ang template object na ito sa kasalukuyang mga macro template gamit ang isang bagong pangalan o relatibong path ng folder.

Syntax

template.save_as(name)

Mga parameter

PangalanPaglalarawan
nameString
New template name, optionally including folders such as "buttons/top/attack".
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Template — Nai-save na pinangalanang template object.

Pagkilos / epekto

I-save ang template object na ito sa kasalukuyang mga macro template gamit ang isang bagong pangalan o relatibong path ng folder.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: Hindi garantisado
  • Sabayang pagpapatakbo: May kondisyon

Ang oras ng pagproseso at paghihintay ay depende sa operasyon. Panatilihin ang nababagong mga value sa flow na may-ari nito; walang pangkalahatang garantiya sa kaligtasan ng pagbabahagi ng mga object sa iba’t ibang flow.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API