OPENSLIDE-WRITE-PNG(1)

💖 OPENSLIDE-WRITE-PNG 💖

okay bestie, welcome to the openslide-write-png page — it's a User Command from the OpenSlide fam, and it's literally here to grab a lil chunk of a virtual slide and spit it out as a PNG. so cute, so useful, let's get into it ✨

---

🌸 NAME 🌸

openslide-write-png — write a region of a virtual slide to a PNG 🎀

---

🦋 SYNOPSIS 🦋

openslide-write-png [--help] [--version] slide-file x y level width height output-file

like, that's the whole vibe. one command, seven-ish little args, no drama 💅

---

✨ DESCRIPTION ✨

So here's the tea: this command writes a region of the specified level of a virtual slide out to a PNG image. no cap, that's the entire job. 🫶

Quick vocab check on the coordinates, because the levels thing trips people up:

• x and y are pixel coordinates in level 0 — that's the highest-resolution slide level, the big one, the main character 👑
• width and height are pixel dimensions in the specified level (not level 0!) — so they get measured at whichever level you asked for 🧚

not me knowing that the level 0 / specified-level switcheroo is exactly where everyone messes up 🙈

And if you're sitting there like "bestie, how do I even know how big each level is??" — the dimensions of each level of a slide can be obtained with openslide-show-properties(1). go peek, it'll tell you 🌈

---

💅 OPTIONS 💅

• --help — display usage summary. short, sweet, does what it says 💖
• --version — display version and copyright information. the receipts, basically 📜

---

🔥 EXIT STATUS 🔥

openslide-write-png returns:

• 0 on success — slay, it worked 🎉
• 1 if an error occurred — something went sideways 😭
• 2 if the arguments are invalid — the args said "no" 💀

---

🍓 NOTES 🍓

okay important heads-up, listen up:

openslide-write-png is a legacy command and no new features will be added. periodt. it's iconic, it's still here, but it's not getting any glow-ups 💅

Its replacement is the region read subcommand of slidetool(1). so if you're starting fresh, that's your girl ✨

---

⭐ COPYRIGHT ⭐

Copyright © 2007-2023 Carnegie Mellon University and others

OpenSlide is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License, version 2.1 ⟨http://gnu.org/licenses/lgpl-2.1.html⟩.

OpenSlide comes with NO WARRANTY, to the extent permitted by law. See the GNU Lesser General Public License for more details.

---

🌈 SEE ALSO 🌈

• openslide-show-properties(1)
• slidetool(1)

---

and that's the whole page, bestie!! mwah 💋 this was OpenSlide 4.0.0, dated 2023-06-30 — go forth and PNG-ify some slides, you've got this 🦋✨