DJVUPS(1)

✨ DJVUPS — the djvups manual page, but make it make sense 💅

okay bestie, so this is djvups(1) from DjVuLibre-3.5, and it's literally the glow-up machine that turns your DjVu docs into PostScript. Let's get into it 🦋

🎀 NAME

djvups — Convert DjVu documents to PostScript. no cap, that's the whole job. ✨

🌸 SYNOPSIS

djvups [options] [djvufile] [outputfile]

💖 DESCRIPTION

So here's the tea: this program decodes the DjVu file djvufile and generates a PostScript file named outputfile. iconic behavior.

The DjVu data gets read from standard input when the argument djvufile is not specified, or when it's equal to a single dash. Same energy on the way out: the output data is written to standard output when outputfile is not specified or when it's equal to a single dash. 🫶

PostScript printers have various capabilities, and they're all a little different, so bestie — go investigate the options -level and -gray for obtaining the best results. trust, it matters. 🔥

✨ OPTIONS ✨

• -help — Prints the list of recognized options. the classic "wait what was I doing" button. 🙈
• -verbose — Displays a progress bar. so you can watch the vibes progress in real time. 📊
• -page=pagespec — Specify the document pages to be converted. The page specification pagespec contains one or more comma-separated page ranges. A page range is either a page number, or two page numbers separated by a dash. Specification 1-10, for instance, prints pages 1 to 10. Specification 1,3,99999-4 prints pages 1 and 3, followed by all the document pages in reverse order up to page 4. yes, reverse order. it's giving chaos but it's valid. 💀
• -format=ps — Produce a PostScript file. This is the default. the standard slay. 💅
• -format=eps — Produce an Encapsulated PostScript file. Encapsulated PostScript files are suitable for embedding images into other documents. Encapsulated PostScript file can only contain a single page. Setting this option overrides the options -copies, -orientation, -zoom, -cropmarks, and -booklet. so like… eps said "I'm the main character now." 👑
• -copies=n — Specify the number of copies to print. how many? n. periodt. 📚
• -orientation=orient — Specify whether pages should be printed using the auto, portrait, or landscape orientation. vibe check your paper. 🌈
• -mode=modespec — Specify how pages should be decoded. The default mode, color, renders all the layers of the DjVu documents. Mode black only renders the foreground layer mask. This mode does not work with DjVuPhoto images because these files have no foreground layer mask. Modes foreground and background only render the foreground layer or the background layer of a DjVuDocument image. pick your layer, bestie. 🎀
• -zoom=zoomspec — Specify a zoom factor zoomspec. The default zoom factor, auto, scales the image to fit the page. Argument zoomspec also can be a number in range 25 to 2400 representing a magnification percentage relative to the original size of the document. zoom zoom. 🔍
• -frame=yesno — Specifying yes causes the generation of a thin gray border representing the boundaries of the document pages. The default is no. cute little outline, optional tho. 🌸
• -cropmarks=yesno — Specifying yes causes the generation of crop marks indicating where pages should be cut. The default is no. scissors emoji energy, but on paper. ✂️
• -level=languagelevel — Select the language level of the generated PostScript, languagelevel. Valid language levels are 1, 2, and 3. Level 3 produces the most compact and fast printing PostScript files. Some of these files however require a very modern printer. Level 2 is the default value. The generated PostScript files are almost as compact and work with all but the oldest PostScript printers. Level 1 can be used as a last resort option. > so basically: level 3 is the gorgeous overachiever, level 2 is the reliable bestie, level 1 is the emergency contact. 😭
• -color=yesno — The default value, yes, generates a color PostScript file. Specifying value no converts the image to gray scale. The resulting PostScript file is smaller and marginally more portable. less color, less drama, more portable. 🩶
• -gray — This option is equivalent to option -color=no and is provided for convenience. the shortcut girlies stay winning. 🫶
• -colormatch=yesno — The default value, yes, generates a PostScript file using device independent colors in compliance with the sRGB specification. Modern printers then produce colors that match the original as well as possible. Specifying value no generates a PostScript file using device dependent colors. This is sometimes useful with older printers. You can then use option -gamma to tune the output colors. matching = serving looks. 💜
• -gamma=gammaspec — Specify a gamma correction factor for the device dependent PostScript colors. Argument gammaspec must be in range 0.3 to 5.0. Gamma correction normally pertains to cathodic screens only. It gets meaningful for printers because several models interpret device dependent RGB colors by emulating the color response of a cathodic tube. so yes, your printer is out here cosplaying a CRT. iconic. 🖥️
• -booklet=opt — Turns the booklet printing mode on. The booklet mode prints two pages on each side in a way suitable for making a booklet by folding the sheets. Option opt can take values no for disabling the booklet mode, yes for enabling the recto/verso booklet mode, and recto or verso to print only one side of each sheet. arts and crafts era. 🎨
• -bookletmax=max — Specifies the maximal number of pages per booklet. A single printout might then be composed of several booklets. Argument max is rounded up to the next multiple of 4. Specifying 0 sets no maximal number of pages and ensures that the printout will produce a single booklet. This is the default. 📖
• -bookletalign=align — Specifies a positive or negative offset applied to the verso of each sheet. Argument align is expressed in points (one point is 1/72th of an inch, or 0.352 millimeter). This is useful with certain printers to ensure that both recto and verso are properly aligned. The default value is of course 0. alignment is self care. 🧚
• -bookletfold=base[+incr] — Specifies the extra margin left between both pages on a single sheet. The base value base is expressed in points (one point is 1/72th of an inch, or 0.352 millimeter). This margin is incremented for each outer sheet by value incr expressed in millipoints. The default value is 18+200. 🎀

💫 CREDITS

This program was written by Léon Bottou <leonb@users.sourceforge.net>, Andrei Erofeev <andrew_erofeev@yahoo.com>, and Florin Nicsa. absolute legends, we stan. 👑

👀 SEE ALSO

djvu(1), ddjvu(1). djview(1)

and that's the whole page, bestie 💖 this one's from DjVuLibre-3.5, dated 01/18/2003, and yeah it's giving retro but it still ate. go convert something cute. 🦋✨🌸