XPSTOJPEG(1)

💖 xpstojpeg(1) — the XPS to JPEG glow-up 💖

okay so real talk, bestie: you're looking at a page from XPS Tools, and its whole personality is xpstojpeg — the little icon that turns your XPS docs into JPEGs. no cap, that's the entire arc. ✨

---

🌈 SYNOPSIS 🌈

xpstojpeg [OPTION...] FILE [OUTPUT FILE]

---

🦋 DESCRIPTION 🦋

so xpstojpeg converts XPS documents into JPEG format, and it's giving very "i do one thing and i do it well" energy. 💅

here's the vibe: it reads the XPS file you hand it, FILE, and then it writes one JPEG file per page — with the page number and the file type appended to OUTPUT FILE. so yeah, you don't get one big file, you get a whole lil squad of them. 🎀

and if you don't specify OUTPUT FILE at all? no stress, it just uses "page" as the base name. iconic default behaviour tbh. 🫶

---

✨ OPTIONS ✨

• -?, --help — shows the help options, aka the "tell me everything" button. 🧚
• -d DOCUMENT, --document=DOCUMENT — picks which document inside the XPS file you actually want converted. there can be more than one in there (document in a document, we love a nested moment 😭). by default it takes the first document of the XPS file.
• -f PAGE, --first=PAGE — the first page to convert. set the starting line 💀
• -l PAGE, --last=PAGE — the last page to convert. and that's the range, bestie.
• -o, --odd — convert only odd pages. one, three, five, the whole odd little crew. 🔥
• -e, --even — convert only even pages. two, four, six, you get it. 💜
• -r RESOLUTION, --resolution=RESOLUTION — horizontal and vertical resolution in PPI (Pixels Per Inch), both at once. the default is 150 PPI.
• --rx=RESOLUTION — horizontal resolution in PPI (Pixels Per Inch), just the x side. the default is 150 PPI.
• --ry=RESOLUTION — vertical resolution in PPI (Pixels Per Inch), just the y side. the default is 150 PPI.
• -x X, --crop-x=X — the x-coordinate of the crop area's top left corner.
• -y Y, --crop-y=Y — the y-coordinate of the crop area's top left corner.
• -w WIDTH, --crop-width=WIDTH — the width of the crop area.
• -h HEIGHT, --crop-height=HEIGHT — the height of the crop area.

⚠️ quick vibe check, because this one gets people every time: -h here is crop height, not help. if you want help, it's -?. do not come for me, i don't make the rules, i just report them 🙈

---

💀 BUGS 💀

found something cursed? please send those bug reports to:

https://bugzilla.gnome.org/enter_bug.cgi?product=libgxps

they want to hear it, fr fr. 🍓

---

🌸 SEE ALSO 🌸

• xpstopng(1)
• xpstopdf(1)
• xpstops(1)
• xpstosvg(1)

(the whole sibling squad — go say hi 💖)

---

and that's the whole page, bestie! this little masterpiece is from XPS Tools, dated 10/12/2023, and it ate, no crumbs. go convert something pretty 💅✨🦋