Template image wrapper. You can scale/crop an existing template, save it as a new template name, or check existence.
Template(name, /)base = Template("enemy_head")
variant = base.scale(0.9).crop(Region(0, 0, 64, 64)).save_as("enemy_head_small")base = Template("enemy_head")Check whether a template name exists in the current macro.
Template.exists(name)Boolean — true if the template exists.if Template.exists("enemy_head"):
text("ready")Check whether this Template object still points to an existing file.
template.exists()Boolean — true if the backing template file exists.t = Template("enemy_head")
if t.exists():
text("ok")Create a scaled template copy and return it as another Template object.
template.scale(scale, scale_y=None)| Name | Description |
|---|---|
scaleNumber | Scale factor for X axis (and Y axis when scale_y is omitted). Required · Positional or named No default |
scale_yNumber | Optional Y-axis scale factor. Optional · Positional or named Default: scale |
Template — Scaled template object.t = Template("enemy_head")
small = t.scale(0.8)
hit = Region(0, 0, 1080, 2400).find(small, 3000)Crop this template by a region in template-local pixels and return a new Template object.
template.crop(region)| Name | Description |
|---|---|
regionRegion | Crop region in template-local coordinates. Required · Positional or named No default |
Template — Cropped template object.t = Template("enemy_head")
face = t.crop(Region(10, 10, 60, 60))Save this template object into current macro templates using a new name or relative folder path.
template.save_as(name)| Name | Description |
|---|---|
nameString | New template name, optionally including folders such as "buttons/top/attack". Required · Positional or named No default |
Template — Saved named template object.captured = Region(200, 300, 120, 90).capture()
saved = captured.save_as("buttons/top/enemy_slot")
if saved.exists():
text("saved")