Tirex::Backend(3pm)

💖 Tirex::Backend 💖

okay bestie, listen — this is the Perl module Tirex::Backend, aka the Generic Tirex rendering backend, straight out of the User Contributed Perl Documentation. she's a parent class, she's iconic, and she's about to make your backend dreams come true ✨

---

🌸 NAME 🌸

Tirex::Backend — Generic Tirex rendering backend 💅

no cap, that's literally her whole deal: she's the blueprint, the mother of all Perl rendering backends 🫶

---

✨ SYNOPSIS ✨

here's the vibe, copy-paste girlies:

use Tirex::Backend::Test;
my $backend = Tirex::Backend::Test->new();
$backend->main();

that's it. that's the whole ritual 🔮

---

🦋 DESCRIPTION 🦋

so, this is a parent class for rendering backends written in Perl. she does not render anything herself — she's giving main character energy as the foundation, and you build on top of her 😌

to actually use her, you make a subclass (like Tirex::Backend::Test, for example — she's the queen of examples 💜). subclass = your own custom backend that inherits all the structure. slay.

---

🎀 METHODS 🎀

🌈 Tirex::Backend->new($name)

bestie, do not instantiate this class directly. like, seriously, don't 👀 she's abstract-ish in spirit. instead, create instances of a subclass. that's the whole point. periodt.

🌟 $backend->check_map_config($map)

this one checks a map config for this backend — syntactic validity, other validity, the whole vibe check 🌸

if it fails? she should croak 😭 (that's Perl-speak for "die loudly", not a frog situation, iykyk).

fr fr — you're supposed to overwrite this in the subclass. don't leave it as-is and expect magic.

💫 $backend->set_status('text')

sets the status text, which shows up in the ps output. so when someone runs ps and sees your process, they see your little status message 👑

🔥 $backend->main()

the core backend method, the moment we've all been waiting for 🎬

call this directly after creating a subclass with new(). she will:

1. parse the config file(s) 📄
2. set everything up 🛠️
3. wait for rendering requests 👀
4. fulfill them by calling create_metatile() 🎨

she's the whole engine. the GOAT.

🧚 $backend->create_metatile($map, $metatile)

creates a metatile. that's it, that's the description 🦋

⚠️ this method has to be overwritten in subclasses — non-negotiable, bestie. if you don't, nothing happens. like, at all. 💀

🍓 $backend->write_metatile($image, $filename, $metatile)

takes a single image the size of a metatile, cuts it into tiles ✂️, then re-assembles those tiles back into a metatile 🌈 and writes it to disk 💾

it's giving craft project. it's giving puzzle. it's giving slay.

👑 $backend->create_error_image($map, $metatile)

creates an error image in case a renderer didn't work 😭

and what does that error image look like? a black/yellow checkerboard pattern 🖤💛 — iconic, honestly, very hazard-tape chic.

this method can be overwritten in subclasses (optional, unlike the others — you have free will here 💅)

---

and that's the whole page bestie!! you ate that 💖✨

signed off with love from perl v5.40.1, dated 2026-08-09 — mwah, go build something gorgeous 🎀🦋💜