Tirex::Metatile(3pm)

📦
version 0.8.0 · 7 versions
, in ubuntu stonking

✨ Tirex::Metatile — the metatile manual (Perl, bestie) ✨

okay so. you're here for Tirex::Metatile (it's a 3pm page, from the User Contributed Perl Documentation corner of the universe) and honestly? same. it's a Metatile. that's the whole vibe. let's get into it 🎀

🌸 SYNOPSIS 🌸

my $mt = Tirex::Metatile->new( map => 'osm', x => 16, y => 12, z=> 12 );

look at her. one line, one metatile, zero drama. slay.

💖 DESCRIPTION 💖

A metatile. 💅 that's it, that's the description. mysterious, iconic, no notes.

👑 METHODS 👑

🌈 Tirex::Metatile->new( ... )

Creates a brand new metatile object, fresh out the box, main character energy ✨

A metatile always needs these parameters, no skipping, bestie:

  • map — the map config to use for rendering 🗺️
  • x — metatile x coordinate
  • y — metatile y coordinate
  • z — zoom level 🔍

You can give any x and y coordinate in the range 0 .. 2^z-1. and then — plot twist — it gets rounded down to the next tile coordinate. it's giving "we'll take the nearest one, don't worry about it" 🙈

⚠️ Croaks if there is a problem with the parameters. so like, feed her bad params and she Will yell at you. respectfully.

🌟 Tirex::Metatile->new_from_filename_and_map($filename, $map)

Builds a metatile from a filename. the first directory element must be the zoom level, that part is non-negotiable 🫶

and optionally? the filename can start with / or ./. flexible queen.

🦋 Tirex::Metatile->new_from_lon_lat(map => $map, lon => $lon, lat => $lat, z => $z)

Creates a metatile from zoom, longitude, and latitude. coordinates-to-metatile pipeline, lowkey satisfying 🌍✨

💜 $mt->get_x()

Gets the x coordinate. that's it. short king.

💜 $mt->get_y()

Gets the y coordinate. yes bestie, we're doing all of them.

💜 $mt->get_x()

Gets the zoom. (yes, the heading says get_x() — that's what the page says, and we do not edit the lore. iykyk 😭)

💜 $mt->get_map()

Gets the map. just the map. no thoughts, head empty.

🎀 $mt->to_s()

Returns a string describing this metatile, in the format 'map=MAP z=Z x=X y=Y'. a little summary card for your tile 🫶

⭐ $mt->equals($other_metatile)

Returns true if both metatiles are the same, false otherwise. 🪞

and "the same tile" means: same map, same x and y coordinates, and same zoom level. all four or it's not a match, periodt.

🔥 $mt->up()

Returns the metatile one zoom level above this metatile that contains this metatile. yes — the parent, the bigger picture, the girlboss above her 🌈⬆️

🧚 $mt->get_filename()

Returns the filename for this metatile. 📁

The format is something like:

[zoom]/[path].meta

where:

zoom          zoom level
path          path with 4 directory elements and a filename
              based on x and y coordinates

four whole directory elements, she's specific like that 💅

🌸 $mt->exists()

Does the metatile file for this metatile exist? 🤔 yes or no, that's the whole question.

💖 $mt->older($time)

Is the metatile file older than the given time? 🕰️

Returns 2 if the file doesn't exist. (yes, 2. not a typo, not a vibe, that's the rule.)

✨ $mt->newer($time)

Is the metatile file newer than the given time? 🕰️✨

Returns 2 if the file doesn't exist. same energy, same 2.

🌈 $mt->size()

Returns the size of the metatile file. big? small? she's got the number for you 📏

🫶 THE SEND-OFF 🫶

that's the whole page bestie, every method accounted for, nothing skipped, no cap 💯 this little gem lives in the Tirex::Metatile(3pm) section of the User Contributed Perl Documentation, built for perl v5.40.1, and stamped 2026-08-09 — so go forth, make metatiles, and be iconic 💅✨🎀

📦 where this page comes from