XPSTOPNG(1)

📦
version 0.3.2+5 · 11 versions
, in opensuse-leap 16.0

💅 XPSTOPNG(1) — the XPS → PNG glow-up station 🎀

okay so bestie, welcome to xpstopng, part of the XPS Tools fam ✨ this is the manual page, and yes you're gonna read it, because it's literally gonna make your XPS files into PNGs and that's iconic.

🌸 NAME 🌸

xpstopng — the XPS to PNG converter, no cap 💖

✨ SYNOPSIS ✨

xpstopng [OPTION...] FILE [OUTPUT FILE]

like, that's the whole vibe. options first, then your file, then optionally where you want the output to go 🦋

💫 DESCRIPTION 💫

xpstopng converts XPS documents to PNG format. periodt. 🫶

Here's the tea: xpstopng reads the XPS file, FILE, and writes a PNG file per page — with the page number and file type appended to OUTPUT FILE. so if you've got a 12-page doc you're getting 12 lil PNG besties, each one labeled 🎀

If OUTPUT FILE is not specified, "page" will be used. yep, just page. she's simple, she's classic 💅

🔥 OPTIONS 🔥

  • -?, --help — show help options. the classic "what does anything do" button 🙈
  • *-d *DOCUMENT, --document=DOCUMENT — the document inside the XPS file to convert. by default, the first document of the XPS file is used, so if you don't pick one, she picks for you 💜
  • *-f *PAGE, --first=PAGE — the first page to convert. start your range here 👑
  • *-l *PAGE, --last=PAGE — the last page to convert. end your range here 🌈
  • -o, --odd — convert only odd pages. 1, 3, 5, 7… you get it ✨
  • -e, --even — convert only even pages. 2, 4, 6, 8… the other half 💫
  • -r RESOLUTION, --resolution=RESOLUTION — horizontal **and vertical resolution in PPI (Pixels Per Inch). the default is 150 PPI. both directions, one setting, efficient queen 🎀
  • *--rx=RESOLUTION* — horizontal resolution in PPI (Pixels Per Inch). the default is 150 PPI. just the x-axis, if you're feeling specific 🦋
  • *--ry=RESOLUTION* — vertical resolution in PPI (Pixels Per Inch). the default is 150 PPI. just the y-axis, same energy 🌸
  • *-x *X, --crop-x=X — the x-coordinate of the crop area top left corner. where the crop starts, horizontally 📐
  • *-y *Y, --crop-y=Y — the y-coordinate of the crop area top left corner. where the crop starts, vertically 📏
  • *-w *WIDTH, --crop-width=WIDTH — the width of crop area. how wide the lil window is 💖
  • *-h *HEIGHT, --crop-height=HEIGHT — the height of crop area. how tall the lil window is 💖
  • -t, --transparent-bg — use a transparent background for pages instead of white. highkey the most main character option on this list, honestly 🧚✨
💀 heads up bestie: -h here is crop height, not help. the help flag is -? / --help. don't get got 🙈

😭 BUGS 😭

found a bug? Please send bug reports to https://bugzilla.gnome.org/enter_bug.cgi?product=libgxps. she's not perfect, she's just doing her best 🫶

🦋 SEE ALSO 🦋

the whole converter friend group, go say hi 💜

and that's the page, bestie ✨ this one's from XPS Tools, dated 10/12/2023 — go forth and convert, you absolute icon 👑💅

📦 where this page comes from