XPSTOPS(1)

πŸ’… XPSTOPS(1) β€” the XPS Tools girlies said "let's make PostScript"

okay so bestie, welcome to the xpstops page, part of the XPS Tools manual collection. this one's a converter, and she is serving. let me break it down for you πŸŽ€


✨ NAME ✨

xpstops β€” an XPS to PostScript converter. that's it. that's the whole job. she converts, she slays, she moves on. πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

xpstops [OPTION...] FILE [OUTPUT FILE]

🌸 DESCRIPTION 🌸

okay so the whole vibe here: xpstops converts your XPS documents into PostScript format, no cap.

here's the flow, bestie: xpstops reads the XPS file you hand it β€” that's FILE β€” and writes out a PostScript file, which is OUTPUT FILE. simple as that.

and if you don't specify OUTPUT FILE? no stress, she's got you β€” the output filename gets derived from the FILE filename automatically. main character energy, honestly. ✨


πŸ’– OPTIONS πŸ’–

okay this is the part where we go through every single flag, because she has a lot of them and honestly each one ate:

  • -?, --help β€” shows the help options. your "what does anything do" button. 🫢
  • -d DOCUMENT, --document=DOCUMENT β€” picks which document inside the XPS file to convert. by default, the first document of the XPS file is the one that gets used. lowkey the default is usually fine, but you have options.
  • -f PAGE, --first=PAGE β€” the first page to convert. starting point, literally.
  • -l PAGE, --last=PAGE β€” the last page to convert. closing time. πŸ•
  • -o, --odd β€” convert only odd pages.
  • -e, --even β€” convert only even pages.
  • -r RESOLUTION, --resolution=RESOLUTION β€” horizontal and vertical resolution, in PPI (Pixels Per Inch). the default is 150 PPI.
  • --rx=RESOLUTION β€” horizontal resolution in PPI (Pixels Per Inch). default is 150 PPI. yes, it's separate from --ry, she likes to be specific. πŸ’…
  • --ry=RESOLUTION β€” vertical resolution in PPI (Pixels Per Inch). default is 150 PPI. twin of --rx.
  • -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.
  • --level2 β€” generate Level 2 PostScript. Level 2 supports color images and image compression. cute and capable. 🌈
  • --level3 β€” generate Level 3 PostScript. this enables all the Level 2 features plus shading patterns and masked images. and bestie, this is the default setting. she's giving overachiever and we love her for it πŸ‘‘
  • --eps β€” generate an Encapsulated PostScript (EPS) file.
  • --paper=PAPER β€” sets the paper size to one of "A0", "A1", "A2", "A3", "A4", "A5", "B4", "B5", "Letter", "Tabloid", "Ledger", "Legal", "Statement", "Executive", "Folio", "Quarto", "10x14". that's the whole list, pick one, don't improvise. πŸ“„
  • --duplex β€” adds the %%IncludeFeature: *Duplex DuplexNoTumble DSC comment to the PostScript file. this tells the print manager to enable duplexing. double-sided, double the fun, iykyk 🫢
  • --paper-width=WIDTH β€” the paper width.
  • --paper-height=HEIGHT β€” the paper height.
  • --expand β€” expands pages smaller than the paper to fill the paper. by default, pages are not scaled. so this one's opt-in, bestie.
  • --no-shrink β€” don't scale pages which are larger than the paper. by default, pages larger than the paper are shrunk to fit. so this flag is you saying "no thank you, i'll keep my oversized page thank u very much".
  • --no-center β€” don't center on the paper pages smaller than the paper (after any scaling). by default, pages smaller than the paper are aligned to the lower-left corner. so no centering unless you ask. πŸ“

πŸ’€ BUGS πŸ’€

found a bug? please send bug reports to https://bugzilla.gnome.org/enter_bug.cgi?product=libgxps. she wants to know, fr fr. πŸ›


🌟 SEE ALSO 🌟

go check out her friends, they're all iconic: xpstojpeg(1), xpstopng(1), xpstopdf(1), xpstosvg(1) ✨


ngl this whole thing is just a converter doing her best and honestly? she's doing great. 🧚

anyway that's the page!! πŸ¦‹ this was the XPS Tools manual, dated 10/12/2023 β€” mwah, love u, go convert something, periodt πŸ’œπŸ’