RENDER_LIST(1)

💖 RENDER_LIST(1) 💖

okay so bestie, welcome to the General Commands Manual section, and today's main character is render_list ✨ — it's a whole vibe, let's get into it.

---

🌸 NAME 🌸

render_list — renders a list of map tiles by sending requests to a rendering daemon. yes queen, that's literally the entire job description 💅

---

✨ SYNOPSIS ✨

render_list [options] < render.list

short, sweet, and she eats every time 🫶

---

🦋 DESCRIPTION 🦋

okay so this manual page is gonna be honest with you: it briefly documents the render_list command. That's it. That's the disclaimer. Slay.

render_list is a helper utility that takes a list of map tiles from stdin and sends the requests to a rendering daemon. she's the middleman, the connector, the group-chat admin who forwards your messages to the right person 📨

---

💅 OPTIONS 💅

This program follows the usual GNU command line syntax, with long options starting with two dashes (-). A summary of options is included below — and bestie, I did NOT skip a single one. Periodt. 💖

• -a, --all — Render all tiles in the given zoom level range instead of reading from STDIN. she does everything herself, no input needed, main character energy 👑
• -c, --config=CONFIG — Specify a renderd.conf file from which to load various option values rather than specifying via command line. The following options will be set (if present); however, they can be overridden if also specified:
  • -s, --socket
  • -n, --num-threads
  • -t, --tile-dir
  • -z, --min-zoom
  • -Z, --max-zoom
• -f, --force — Render tiles even if they seem current. no thoughts, no vibe check, just render 🔥
• -m, --map=MAP — Render tiles in this map (default is 'default').
• -l, --max-load=LOAD — Sleep if load is this high (default is '16'). she's napping when things get too much, and honestly? relatable 😭
• -s, --socket=SOCKET|HOSTNAME:PORT — Unix domain socket name or hostname and port for contacting renderd (default is '/run/renderd/renderd.sock').
• -n, --num-threads=N — The number of parallel request threads (default is '1').
• -t, --tile-dir=TILE_DIR — Tile cache directory (default is '/var/cache/renderd/tiles').
• -z, --min-zoom=ZOOM — Filter input to only render tiles greater than or equal to this zoom level (default is '0').
• -Z, --max-zoom=ZOOM — Filter input to only render tiles less than or equal to this zoom level (default is '20').
• -h, --help — Print out a help text for render_list. the friend who explains everything when you're lost 🥺
• -V, --version — Print out the version number for render_list. iykyk, gotta know which era we're in ⭐

---

🎀 Restricting the tile range 🎀

If you are using -a, --all, you can restrict the tile range by adding these options:

⚠️ please note that tile coordinates must be positive integers and are not latitude and longitude values — bestie, do not come in here putting degrees in the X field, I am begging 🙈

• -g, --min-lat=LATITUDE — minimum latitude
• -G, --max-lat=LATITUDE — maximum latitude
• -w, --min-lon=LONGITUDE — minimum longitude
• -W, --max-lon=LONGITUDE — maximum longitude
• -x, --min-x=X — minimum X tile coordinate
• -X, --max-x=X — maximum X tile coordinate
• -y, --min-y=Y — minimum Y tile coordinate
• -Y, --max-y=Y — maximum Y tile coordinate

---

🍓 Feeding her tiles by hand 🍓

Without -a, --all, send a list of tiles to be rendered from STDIN in the format:

X Y Z e.g.
0 0 1
0 1 1
1 0 1
1 1 1

The above would cause all 4 tiles at zoom 1 to be rendered. Look at her go 🧚

---

🌈 SEE ALSO 🌈

renderd(1)

her ride-or-die, her partner in crime, the one actually doing the rendering 💜

---

💜 AUTHOR 💜

render_list was written by OpenStreetMap project members.

This manual page was written by OpenStreetMap authors. iconic behavior, no notes 👑

---

and that's the whole page bestie!! this came to you from mod_tile v0.8.1, dated 2024-03-20 — mwah, go render something gorgeous 💖✨🎀🦋🌸💅🫶