PSNUP(1)

📦 version 61719, in fedora 43, fedora 44

💖 PSNUP — bestie's guide to multiple pages per sheet 💖

okay so this is psnup from the PSUtils collection, living in section 1 of the general commands manual. it's the girl who takes your pages and stacks them, no cap. 🫶

✨ NAME ✨

psnup — multiple pages per sheet 💅

🌸 SYNOPSIS 🌸

psnup [-wwidth] [-hheight] [-ppaper] [-Wwidth] [-Hheight] [-Ppaper]
[-l|-r|-f] [-c] [-mmargin] [-bborder] [-d[lwidth]] [-sscale] [-nup] [-q]
[infile [outfile]]

👑 DESCRIPTION 👑

Psnup puts multiple logical pages onto each physical sheet of paper. iconic behaviour fr fr. ✨

heads up bestie: the input PostScript file should follow the Adobe Document Structuring Conventions. that's the vibe check it has to pass. 📄

The -w option gives the paper width, and the -h option gives the paper height, specified in pt, mm, cm, or in. The -p option can be used instead, to set the paper size; otherwise a default value is used. see paper(1). 🎀

The -W, -H, and -P options set the input paper size, if it is different from the output size. this makes it easy to impose pages of one size on a different size of paper — lowkey genius. 🦋

The -l option should be used for pages which are in landscape orientation (rotated 90 degrees anticlockwise). The -r option should be used for pages which are in seascape orientation (rotated 90 degrees clockwise), and the -f option should be used for pages which have the width and height interchanged, but are not rotated. pick your girl wisely. 💫

Psnup normally uses row-major layout, where adjacent pages are placed in rows across the paper. The -c option changes the order to column-major, where successive pages are placed in columns down the paper. it's giving ✨options✨. 🌈

A margin to leave around the whole page can be specified with the -m option. This is useful for sheets of thumbnail pages, because the normal page margins are reduced by putting multiple pages on a single sheet. 💖

The -b option is used to specify an additional margin around each page on a sheet. 🎀

The -d option draws a line around the border of each page, of the specified width. If the lwidth parameter is omitted, a default linewidth of 1 point is assumed. The linewidth is relative to the original page dimensions, i.e., it is scaled down with the rest of the page. not me being obsessed with tiny borders. 🖊️

The scale chosen by psnup can be overridden with the -s option. This is useful to merge pages which are already reduced. 🧚

The -nup option selects the number of logical pages to put on each sheet of paper. This can be any whole number; psnup tries to optimise the layout so that the minimum amount of space is wasted. If psnup cannot find a layout within its tolerance limit, it will abort with an error message. The alternative form -nnup can also be used, for compatibility with other n-up programs. 💀

Psnup normally prints the page numbers of the pages re-arranged; the -q option suppresses this. 🤫

🌟 OPTIONS 🌟 (the full rundown, bestie)

  • -wwidth — set the paper width. units: pt, mm, cm, or in. 📏
  • -hheight — set the paper height. same units, same energy. 📐
  • -ppaper — set the paper size instead of using -w/-h; otherwise a default value is used. see paper(1). 🎀
  • -Wwidth — set the input paper width, if it's different from the output size. 🦋
  • -Hheight — set the input paper height, if it's different from the output size. ✨
  • -Ppaper — set the input paper size, if it's different from the output size. 💖
  • -l — for pages in landscape orientation (rotated 90 degrees anticlockwise). 🌅
  • -r — for pages in seascape orientation (rotated 90 degrees clockwise). 🌊
  • -f — for pages whose width and height are interchanged, but which are not rotated. 🔄
  • -c — switch the layout order from row-major to column-major, so successive pages go in columns down the paper. 📚
  • -mmargin — leave a margin around the whole page. great for sheets of thumbnail pages, since the normal page margins get reduced when you put multiple pages on one sheet. 🖼️
  • -bborder — specify an additional margin around each page on a sheet. 🎁
  • -d[lwidth] — draw a line around the border of each page, of the specified width. omit lwidth and the default linewidth of 1 point is assumed. the linewidth is relative to the original page dimensions, i.e., it scales down with the rest of the page. 🖊️
  • -sscale — override the scale psnup chose. useful to merge pages which are already reduced. 🧚
  • -nup — select the number of logical pages to put on each sheet. can be any whole number; psnup tries to optimise the layout so the minimum amount of space is wasted. if it can't find a layout within its tolerance limit, it aborts with an error message. 💀
  • -nnup — the alternative form, for compatibility with other n-up programs. same job, different outfit. 👯
  • -q — suppress the printing of the page numbers of the re-arranged pages (psnup normally prints them). 🤫
  • infile — your input file. 📥
  • outfile — your output file. 📤

🌈 EXAMPLES 🌈

The potential use of this utility is varied but one particular use is in conjunction with psbook(1). For example, using groff to create a PostScript document and lpr as the UNIX print spooler a typical command line might look like this:

groff -Tps -ms file | psbook | psnup -2 | lpr

where file is a 4 page document this command will result in a two page document printing two pages of file per page and rearranges the page order to match the input pages 4 and 1 on the first output page and pages 2 then 3 of the input document on the second output page. the way that math works out?? main character energy. 🔥

💜 AUTHOR 💜

Written by Angus J. C. Duggan. we stan. 🫶

🎀 SEE ALSO 🎀

(this section is doing the silent treatment in the original — nothing listed under it, so nothing to add. the cross-refs that do show up live in the DESCRIPTION and EXAMPLES above: paper(1) and psbook(1). iykyk. 🙈)

⭐ TRADEMARKS ⭐

PostScript is a trademark of Adobe Systems Incorporated. ✨

🦋 BUGS 🦋

Psnup does not accept all DSC comments. 😭 that's it, that's the tea.

a gentle reminder bestie: this one's a real tool doing real work on real files. keep your flags exact and your input DSC-compliant. 💅

and that's a wrap on PSNUP(1) from the PSUtils manual, dated and sourced just like the original footer said — PSUtils, PSNUP(1). slay, go print something cute. 🌸💖🎀

📦 where this page comes from