Debian Codegraph @

texmf-dist/doc/man/man1/xdvipsk.1

raw
1 .TH XDVIPSK 1 "06 February 2026"
2 .SH NAME
3 xdvipsk \- convert a TeX DVI file to PostScript (dvips extexsion)
4 .SH SYNOPSIS
5 .B xdvipsk
6 .RI [ OPTIONS ]
7 .IR file [\fB.dvi\fP]
8 .SH DESCRIPTION
9 .B xdvipsk
10 has a few base extensions:
11 .TP
12 .B - bitmap images
13 allows flexible inclusion of bitmap images.
14 .I xdvipsk
15 accepts
16 .IR BMP ,
17 .IR PCX ,
18 .IR TIFF ,
19 .IR JPEG ,
20 .I PNG
21 formats and is able to perform the same actions as with
22 .I EPS
23 images: scaling, rotating, trim, viewport.
24 .sp
25 .I xdvispk.def
26 (extended `dvips.def`) driver for graphics package does not yet implement
27 the operations of clipping, trimming and viewport.
28 .TP
29 .B - OpenType fonts
30 adds
31 .B OpenType
32 font support. Map files with information about
33 .I OpenType
34 fonts used in .dvi files are produced by LaTeX package
35 .I luafontmaps.
36 .sp
37 PostScript header file
38 .I texcid.pro
39 is used for inclusion of
40 .B OpenType
41 fonts in PostScript files. It is an analogue of
42 .I texps.pro
43 that is used in case of
44 .I Type1
45 fonts.
46 .TP
47 .B - mapfile, mapline specials
48 accepts font map special commands with prefixes
49 \fImapfile\fP and \fImapline\fP
50 to supplement font mapping provided in
51 .I psfonts.map
52 tables.
53 .I mapfile
54 is used for reading a font map file consisting of one or more font map lines.
55 The name of the map file is given together with an optional leading modifier character (+).
56 There is a companion special type
57 .I mapline
58 that allows to scan single map lines;
59 its map line argument has the same syntax as the map lines from a map file.
60 .sp
61 Both specials can be used concurrently. The operation mode is selected by
62 an optional modifier character (+) in front. This modifier defines how
63 the individual map lines are going to be handled, and how a collision
64 between an already registered map entry and a newer one is resolved;
65 either ignoring a later entry with a warning in case modifier charcter is given,
66 or replacing an existing entry in case no modifier character is given.
67 .TP
68 .B - Lua callbacks
69 adds
70 .B Lua callbacks
71 for
72 .I specials
73 (prescan, scan),
74 \fIafter prescan\fP,
75 .IR drawchar ,
76 .IR drawrule ,
77 .IR stack ,
78 \fIdvips exit\fP.
79 .sp
80 .I xdvipsk
81 reads Lua script file
82 .I xdvipsk.lua
83 if it is found by `kpse` and looks for these Lua functions:
84
85 .B prescan_specials_callback(\fIspecial\fP, \fItable\fP)
86 .IR special -
87 original special data,
88 .I table
89 with keys: `hh`, `vv`, `pagenum`.
90
91 .B scan_specials_callback(\fIspecial\fP, \fItable\fP)
92 .IR special -
93 original special data,
94 .I table
95 with keys: `hh`, `vv`, `pagenum`
96
97 .B after_prescan_callback(\fItable\fP)
98 .I table
99 with keys: `hpapersize`, `vpapersize`, `hoff`, `voff`, `actualdpi`,
100 `vactualdpi`, `num`, `den`, `mag`, `totalpages`
101
102 .B after_drawchar_callback(\fItable\fP)
103 .I table
104 with keys: `charcode`, `cid`, `pixelwidth`, `rhh`, `rvv`, `dir`, `lastfont`,
105 `tounicode`
106
107 .B after_drawrule_callback(\fItable\fP)
108 .I table
109 with keys: `hh`, `vv`, `dir`, `rw`, `rh`
110
111 .B process_stack_callback(\fItable\fP)
112 .I table
113 with keys: `cmd`, `hh`, `vv`, `dir`
114
115 .B dvips_exit_callback(\fItable\fP)
116 .I table
117 with keys: `exitcode`, `log_records_count`
118
119 Return values for specials defines processing behaviour:
120
121 .I - non empty string
122 defines modified `dvi special` to be processed;
123
124 .I - true value
125 means processing original `dvi special` in default way;
126
127 .I - empty string | false value
128 means skipping `dvi special`.
129
130 Default `Lua` script file can be changed by command line argument
131 .I -lua
132 or command
133 .I luascript
134 in
135 .B xdvipsk
136 config files.
137 .TP
138 .B - ToUnicode CMaps
139 .B ToUnicode CMaps
140 support through adding
141 .B GlyphNames2Unicode
142 dictionary to
143 .B T1
144 and
145 .B OpenType
146 fonts.
147 .sp
148 .I GlyphNames2Unicode
149 is an undocumented dictionary which Adobe PostScript printer driver uses to communicate
150 with Adobe Distiller. In this dictionary the keys are glyph names,
151 the values are Unicode UTF-16 codes of them.
152 The dictionary is stored in the
153 .I FontInfo
154 dictionary under the key
155 .IR GlyphNames2Unicode .
156 Ghostscript recognises it and uses to generate `ToUnicode CMaps` with `pdfwrite`.
157 .PP
158 A bit OBSOLETE info can be found at
159 \fIhttps://tug.org/TUGboat/tb38-2/tb119tolusis.pdf\fP
160 .PP
161 Development sources: \fIhttps://github.com/vtex-soft/xdvipsk.git\fP
162 .SH OPTIONS
163 Extra
164 .B xdvipsk
165 options are marked with \fI[+]\fP.
166 .TP
167 .B -
168 Read additional options from standard input after processing the command line.
169 .TP
170 .B --help
171 Print a usage message and exit.
172 .TP
173 .B --version
174 Print the version number and exit.
175 .TP
176 .B -a
177 Conserve memory by making three passes over the .dvi file instead of two
178 and only loading those characters actually used. Generally only useful
179 on machines with a very limited amount of memory, like some PCs.
180 .TP
181 .B -A
182 Print only the odd pages. This option uses TeX page numbers, not
183 physical page numbers.
184 .TP
185 .B -b num
186 Generate
187 .I num
188 copies of each page, but duplicating the page body rather than using the
189 .I /#copies
190 PostScript variable. This can be useful in conjunction with a header file setting
191 .I bop-hook
192 to do color separations or other neat tricks.
193 .TP
194 .B -B
195 Print only the even pages. This option uses TeX page numbers, not
196 physical page numbers.
197 .TP
198 .B -bitmapfontenc [on,off,strict]
199 Turns bitmap font encoding to \fIoff\fP, \fIon\fP (no warnings for missing bitmap font encodings),
200 or \fIstrict\fP (with warnings for missing bitmap font encodings).
201 .TP
202 .B -c num
203 Generate
204 .I num
205 consecutive copies of every page, i.e., the output is
206 uncollated. This merely sets the builtin PostScript variable
207 .I /#copies
208 Default is 1. (For collated copies, see the
209 .I -C
210 option below.)
211 .TP
212 .B -C num
213 Create
214 .I num
215 copies, but collated (by replicating the data in the PostScript file).
216 Slower than the
217 .I -c
218 option, but easier on the hands, and faster than resubmitting the same
219 PostScript file multiple times.
220 .TP
221 .B -d num
222 Set the debug flags, showing what
223 .B dvips
224 is doing. This will work unless Dvips has been compiled without
225 the 'DEBUG' option (not recommended). *Note Debug options::,
226 for the possible values of \fInum\fP.
227 Use '-d -1' as the first option for maximum output.
228 .TP
229 .B -D num
230 Set both the horizontal and vertical resolution to
231 .IR num ,
232 given in dpi (dots per inch). This affects the choice of bitmap fonts that
233 are loaded and also the positioning of letters in resident
234 PostScript fonts. Must be between 10 and 10000. This affects both
235 the horizontal and vertical resolution. If a high
236 resolution (something greater than 400 dpi, say) is selected, the
237 .I -Z
238 flag should probably also be used. If you are using fonts made with
239 Metafont, such as Computer Modern,
240 .B mktexpk
241 needs to know about
242 the value for
243 .I num
244 that you use or Metafont will fail. See the
245 .I modes.mf
246 file (<https://ctan.org/pkg/modes>) for a list of
247 resolutions and mode names for most devices.
248 .TP
249 .B -e num
250 Maximum drift in pixels of each character from its 'true'
251 resolution-independent position on the page. The default value of
252 this parameter is resolution dependent (it is the number of entries
253 in the list [100, 200, 300, 400, 500, 600, 800, 1000, 1200, 1600, 2000, 2400, 2800, 3200, ...]
254 that are less than or equal to the
255 resolution in dots per inch). Allowing individual characters
256 to 'drift' from their correctly rounded positions by a few pixels,
257 while regaining the true position at the beginning of each new
258 word, improves the spacing of letters in words.
259 .TP
260 .B -E
261 Generate an EPSF file with a tight bounding box. This only looks
262 at marks made by characters and rules, not by any included
263 graphics. In addition, it gets the glyph metrics from the
264 .I tfm
265 file, so characters that print outside their enclosing
266 .I tfm
267 box may confuse it. In addition, the bounding box might be a bit too loose
268 if the character glyph has significant left or right side bearings.
269 Nonetheless, this option works well enough for creating small EPSF
270 files for equations or tables or the like. (Of course,
271 .B dvips
272 output, especially when using bitmap fonts, is resolution-dependent
273 and thus does not make very good EPSF files, especially if the
274 images are to be scaled; use these EPSF files with care.) For
275 multiple page input files, also specify '-i' to get each page as a
276 separate EPSF file; otherwise, all the pages are overlaid in the
277 single output file.
278 .TP
279 .B -f
280 Run as a filter. Read the
281 .I .dvi
282 file from standard input and write the PostScript to standard output.
283 The standard input must be seekable, so it cannot be a pipe. If you
284 must use a pipe, write a shell script that copies the pipe output to a
285 temporary file and then points
286 .B dvips
287 at this file. This option also disables the automatic reading of the
288 .I PRINTER
289 environment variable; use
290 .B '-P$PRINTER'
291 after the
292 .B -f
293 to read it anyway. It also turns off the automatic sending of
294 control-D (ASCII code 4) if it was turned on with the
295 .B -F
296 option or in the configuration file; use
297 .B -F
298 after the
299 .B -f
300 to send it anyway.
301 .TP
302 .B -F
303 Write control-D (ASCII code 4) as the very last character of the
304 PostScript file. This is useful when
305 .B dvips
306 is driving the printer
307 directly instead of working through a spooler, as is common on
308 personal systems. On systems shared by more than one person, this
309 is not recommended.
310 .TP
311 .B -G
312 Shift non-printing characters (ASCII 0-32, 127) to higher-numbered
313 positions. This was useful to work around bugs in old versions of
314 Adobe's PDF reader. It's more likely to cause problems nowadays.
315 .TP
316 .B -h name
317 Prepend
318 .I name
319 as an additional header file, or, if
320 .I name
321 is '-', suppress inclusion of default header files. If
322 .B -h
323 is given multiple times, the headers are included in the order given.
324 Any definitions in the header file get added to the PostScript
325 .IR userdict .
326 .TP
327 .B \fI[+]\fP-H
328 Turbo mode for
329 .B PS
330 graphics
331 .TP
332 .B -i
333 Make each section be a separate file; a "section" is a part of the
334 document processed independently, most often created to avoid
335 memory overflow. The filenames are created replacing the suffix of
336 the supplied output file name by a three-digit sequence number.
337 This option is most often used in conjunction with the
338 .I -S
339 option which sets the maximum section length in pages; if
340 .I -i
341 is specified and
342 .I -S
343 is not, each page is output as a separate file.
344 For instance, some phototypesetters cannot print more than ten or
345 so consecutive pages before running out of steam; these options can
346 be used to automatically split a book into ten-page sections, each
347 to its own file.
348 On the other hand, if your document uses very large fonts or very
349 large included figures, Dvips might take it upon itself to split
350 the output into unwanted sections, to try to avoid overflowing
351 printer memory.
352 .TP
353 .B \fI[+]\fP-I p
354 Resize mode for emTeX graphics
355 .TP
356 .B -j
357 Download only needed characters from Type 1 fonts. This is the
358 default in the current release. Some debugging flags trace this operation.
359 You can also control partial downloading on a per-font basis, via the
360 .B psfonts.map
361 file.
362 .B \fI[+]\fP-J
363 Download OpenType fonts partially.
364 .TP
365 .B -k
366 Print crop marks. This option increases the paper size (which should be
367 specified, either with a paper size special or with the
368 .I -T
369 option) by a half inch in each dimension. It translates each page by a
370 quarter inch and draws cross-style crop marks. It is mostly useful with
371 typesetters that can set the page size automatically.
372 This works by downloading 'crop.pro'.
373 .TP
374 .B -K
375 This option causes comments in included PostScript graphics, font files,
376 and headers to be removed. This is sometimes necessary to get around
377 bugs in spoolers or PostScript post-processing programs. Specifically,
378 the %%Page comments, when left in, often cause difficulties. Use of
379 this flag can cause some included graphics to fail, since the PostScript
380 header macros from some software packages read portions of the input
381 stream line by line, searching for a particular comment. This option
382 has been turned off by default because PostScript previewers and
383 spoolers have been getting better.
384 .TP
385 .B -l [=]num[.SEQ]
386 The last page printed will be the first one numbered
387 .I num
388 Default is the last page in the document. If the
389 .I num
390 is prefixed by an equals sign, then it (and any argument to the
391 .I -p
392 option) is treated as a sequence number, rather than a value to compare
393 with
394 .I \ecount0
395 values. Thus, using
396 .I -l =9
397 will end with the ninth page of the document, no matter what the pages
398 are actually numbered.
399 .sp
400 On the other hand, if
401 .I num
402 is suffixed by
403 .IR .SEQ ,
404 the SEQth occurrence of
405 .I num
406 is used; for example,
407 .I -l 99.2
408 says to end processing with the second page numbered 99 in the document.
409 .TP
410 .B -L
411 By default or with
412 .BR -L1 ,
413 the last 'papersize' special wins; with
414 .BR -L0 ,
415 the first special wins.
416 .TP
417 .B -landscaperotate
418 When looking for matching paper sizes, permit rotation of page
419 content on the page to match the given size; the default, as of
420 .B Dvips 2022.1,
421 is not to do this. It should not be needed in modern
422 systems with normal print spoolers, and can be harmful when
423 converting to PDF (*note Config file paper sizes::). This option
424 accepts an optional suffix of 0 (to explicitly disable) or 1 (to
425 explicitly enable); if the option is specified without a suffix, it
426 enables the behavior.
427 .TP
428 .B \fI[+]\fP-lua name
429 Lua script file
430 .I name
431 .TP
432 .B -m
433 Specify manual feed for printer, if supported by the output device.
434 .TP
435 .B -mode mode
436 Use
437 .I mode
438 as the Metafont device name for path searching and font
439 generation. This overrides any value from configuration files. With
440 the default paths, explicitly specifying the mode also makes the program
441 assume the fonts are in a subdirectory named
442 .IR mode .
443 .TP
444 .B -M
445 Turns off automatic font generation ('mktexpk'). If 'mktexpk', the
446 invocation is appended to a file
447 .I missfont.log
448 by default in the
449 current directory. You can then execute the log file to create the
450 missing files after fixing the problem. If the current directory
451 is not writable and the environment variable or configuration file
452 value 'TEXMFOUTPUT' is set, its value is used. Otherwise, nothing
453 is written. The name
454 .I missfont.log
455 is overridden by the 'MISSFONT_LOG' environment variable
456 or configuration file value.
457 .TP
458 .B -n num
459 At most
460 .I num
461 pages will be printed. Default is 100000.
462 .TP
463 .B -N
464 Turns off structured comments such as '%%Page';
465 this might be necessary on some systems
466 that try to interpret PostScript comments in weird ways, or on some
467 PostScript printers. Old versions of TranScript in particular cannot
468 handle modern Encapsulated PostScript.
469 Beware: This also disables page movement,
470 etc., in PostScript viewers such as Ghostview.
471 .TP
472 .BR -noomega
473 This will disable the use of Omega extensions when interpreting DVI
474 files. By default, the additional opcodes
475 .I 129
476 and
477 .I 134
478 are recognized by dvips as Omega or pTeX extensions and interpreted as
479 requests to set 2-byte characters.
480 .TP
481 .BR -noptex
482 This will disable the use of pTeX extensions when interpreting DVI files.
483 By default, the additional opcodes
484 .I 130
485 and
486 .I 135
487 are recognized by dvips as pTeX extensions and interpreted as requests to
488 set 3-byte characters, and
489 .I 255
490 as request to change the typesetting direction.
491 .sp
492 The only drawback is that the virtual font array will (at least temporarily)
493 require 65536 or more positions instead of the default 256 positions, i.e.,
494 the memory requirements of dvips will be somewhat larger. If you find this
495 unacceptable or encounter another problem with the Omega or pTeX extensions,
496 you can switch off the pTeX extension by using
497 .BR -noptex ,
498 or both by using
499 .B -noomega
500 (but please do send a bug report if you find such problems - see the bug
501 address in the
502 .B AUTHORS
503 section below).
504 .TP
505 .BR \fI[+]\fP-noluatex
506 Disable LuaTeX extensions
507 .TP
508 .BR \fI[+]\fP-noToUnicode
509 Disable ToUnicode CMap file generation for OpenType fonts
510 .TP
511 .B -o name
512 Send output to the file
513 .IR name .
514 If
515 .B -o is specified without
516 .I name
517 (i.e., it is the last thing on the command line), the default is
518 .I FILE.ps
519 where the input DVI file was
520 .IR FILE.dvi .
521 If
522 .B -o
523 isn't given at all, the configuration file default is used.
524 .sp
525 If
526 .I name
527 is '-', output goes to standard output. If the first
528 character of
529 .I name
530 is '!' or '|', then the remainder will be used as
531 an argument to
532 .IR popen ;
533 thus, specifying
534 .I |lpr
535 as the output file
536 will automatically queue the file for printing as usual. (The
537 MS-DOS version will print to the local printer device 'PRN' when
538 .I name
539 is
540 .I |lpr
541 and a program by that name cannot be found.)
542 .sp
543 .B -o
544 disables the automatic reading of the
545 .I PRINTER environment
546 variable, and turns off the automatic sending of control-D. See the
547 .B -f
548 option for how to override this.
549 .TP
550 .B -O offset
551 Move the origin by
552 .IR X-OFFSET,Y-OFFSET ,
553 a comma-separated pair of dimensions such as
554 .I .1in,-.3cm
555 (*note papersize special::). The
556 origin of the page is shifted from the default position (of one
557 inch down, one inch to the right from the upper left corner of the
558 paper) by this amount. This is usually best specified in the
559 printer-specific configuration file.
560 .sp
561 This is useful for a printer that consistently offsets output pages
562 by a certain amount. You can use the file 'testpage.tex' to
563 determine the correct value for your printer. Be sure to do
564 several runs with the same 'O' value--some printers vary widely
565 from run to run.
566 .sp
567 If your printer offsets every other page consistently, instead of
568 every page, your best recourse is to use
569 .I bop-hook
570 (*note PostScript hooks::).
571 .TP
572 .B -p [=]num[.SEQ]
573 Exactly analogous to
574 .I -l
575 (q.v.), but specifying the first page number to be printed (processed).
576 .TP
577 .B -pp pagelist
578 Print pages
579 .I FIRST
580 through
581 .IR LAST ;
582 equivalent to
583 .IR -p FIRST -l LAST ,
584 except that multiple
585 .I -pp
586 options accumulate, unlike
587 .I -p
588 and
589 .IR -l .
590 The '-' separator can also be ':'.
591 .TP
592 .B -P PRINTER
593 Read the configuration file
594 .I config.PRINTER
595 (
596 .I PRINTER.cfg
597 on MS-DOS), which typically sets the output name
598 (most likely 'o |lpr -PPRINTER'), resolution, Metafont mode, and perhaps other
599 printer-specific defaults. It works best to put sitewide defaults
600 in the one master
601 .I config.ps
602 file and only things that vary from
603 printer to printer in the
604 .I config.PRINTER
605 files;
606 .I config.ps
607 is read before
608 .IR config.PRINTER .
609 .sp
610 A configuration file for eventual creation of Adobe PDF files is
611 provided in
612 .I config.pdf
613 and thus can be loaded with
614 .IR -Ppdf .
615 It will try to include Type 1 outline fonts into the PostScript file
616 (*note Hypertext caveats::).
617 .sp
618 If no
619 .I -P
620 or
621 .I -o
622 is given, the environment variable
623 .I PRINTER
624 is checked. If that variable exists, and a corresponding
625 .I config.PRINTER
626 (
627 .I PRINTER.cfg
628 on MS-DOS) file exists, it is read.
629 *Note Configuration file searching::.
630 .TP
631 .B -q
632 Run in quiet mode. Don't chatter about pages converted, etc.; report
633 nothing but errors to standard error.
634 .TP
635 .B \fI[+]\fP-Q
636 Skip VTeX private specials.
637 .TP
638 .B -r
639 Output pages in reverse order. By default, page 1 is output first.
640 .TP
641 .B -R[0|1|2]
642 Run securely.
643 .B -R2
644 disables both shell command execution in
645 .I \especial{}
646 (via '`', *note Dynamic creation of graphics::) and
647 config files (via the 'E' option, *note Configuration file
648 commands::) and opening of any absolute or '..'-relative filenames.
649 .BR -R1 ,
650 the default, forbids shell escapes but allows absolute filenames.
651 .B -R0
652 allows both.
653 .TP
654 .B -s
655 Causes the entire global output to be enclosed in a save/restore pair.
656 This causes the file to not be truly conformant, and is thus not
657 recommended, but is useful if you are driving the printer directly and
658 don't care too much about the portability of the output.
659 .TP
660 .B -S num
661 Set the maximum number of pages in each `section'. This option is most
662 commonly used with the
663 .I -i
664 option; see that documentation above for more information.
665 .TP
666 .B -t papertype
667 This sets the paper type to
668 .IR papertype .
669 The
670 .I papertype
671 should be defined in one of the configuration files, along with the
672 appropriate code to select it. (Currently known types include
673 .BR letter ,
674 .BR legal ,
675 .BR ledger ,
676 .BR a4 ,
677 .BR a3 ).
678 You can also specify a
679 .I papertype
680 of
681 .IR landscape ,
682 which rotates a document by 90 degrees.
683 To rotate a document whose paper type is not the default, you
684 can use the
685 .I -t
686 option twice, once for the paper type, and once for
687 .IR landscape .
688 In general, you should not use any
689 .I -t
690 option when using a
691 .I papersize
692 special, which some LaTeX packages (e.g., 'hyperref') insert.
693 One exception is when using a nonstandard paper size that is
694 not already defined in
695 .IR config.ps ;
696 in this case, you need to specify
697 .IR -t unknown .
698 Another exception is when producing multi-page files for
699 further processing; use
700 .I -t nopaper
701 to omit any paper size information in the output. (If you
702 just have a single page document, you can use
703 .I -E
704 to get pure EPSF output.)
705 .TP
706 .B -T papersize
707 Set the paper size to
708 .IR papersize ,
709 a comma-separated pair of dimensions such as '.1in,-.3cm' (*note papersize special::).
710 It overrides any paper size special in the DVI file. Be careful, as
711 the paper size will stick to a predefined size if there is one
712 close enough. To disable this behavior, use
713 .IR -tunknown.
714 .TP
715 .B title s
716 Use
717 .I s
718 as the title in the generated PostScript ('%%Title').
719 If not specified, the default is the basename of the input file;
720 for example, running 'dvips /foo/bar.dvi' will have
721 a '%%Title' of 'bar.dvi'.
722 .TP
723 .B -u psmapfile
724 Set
725 .I psmapfile
726 to be the file that dvips uses for looking up PostScript font aliases. If
727 .I psmapfile
728 begins with a
729 .B +
730 character, then the rest of the name is used as the name of the map file,
731 and the map file is appended to the list of map files (instead of replacing
732 the list). In either case, if
733 .I psmapfile
734 has no extension, then
735 .B .map
736 is added at the end.
737 .TP
738 .B -U
739 Disable a PostScript virtual memory saving optimization that stores the
740 character metric information in the same string that is used to store
741 the bitmap information. This is only necessary when driving the Xerox
742 4045 PostScript interpreter. It is caused by a bug in that interpreter
743 that results in `garbage' on the bottom of each character. Not
744 recommended unless you must drive this printer.
745 .TP
746 .B -v
747 Print the
748 .B dvips
749 version number and exit.
750 .TP
751 .B -V
752 Download non-resident PostScript fonts as bitmaps. This requires
753 use of 'mtpk' or 'gsftopk' or 'pstopk' or some combination thereof
754 to generate the required bitmap fonts; these programs are supplied
755 with Dvips. The bitmap must be put into 'psfonts.map' as the
756 downloadable file for that font. This is useful only for those
757 fonts for which you do not have real outlines, being downloaded to
758 printers that have no resident fonts, i.e., very rarely.
759 .TP
760 .B \fI[+]\fP-W
761 Extended search for emTeX graphics.
762 .TP
763 .B -x num
764 Set the magnification ratio to
765 .IR num/1000 .
766 Overrides the magnification specified in the DVI file.
767 Must be between 10 and 100000. It is recommended that you use standard
768 magstep values (1095, 1200, 1440, 1728, 2074, 2488, 2986, and so on)
769 to help reduce the total number of PK files generated.
770 .I num
771 may be a real number, not an integer, for increased precision.
772 .TP
773 .B -X num
774 Set the horizontal resolution in dots per inch to
775 .IR num .
776 .TP
777 .B -y num
778 Set the magnification ratio to
779 .IR num /1000
780 times the magnification specified in the .dvi file.
781 See
782 .B -x
783 above.
784 .TP
785 .B -Y num
786 Set the vertical resolution in dots per inch to
787 .IR num .
788 .TP
789 .B -z
790 Pass
791 .B html
792 hyperdvi specials through to the output for eventual
793 distillation into PDF. This is not enabled by default to avoid
794 including the header files unnecessarily, and use of temporary files in
795 creating the output.
796 .TP
797 .B -Z
798 Compress bitmap fonts in the output file, thereby reducing the size
799 of what gets downloaded. Especially useful at high resolutions or
800 when very large fonts are used. May slow down printing, especially
801 on early 68000-based PostScript printers. Generally recommend
802 today, and can be enabled in the configuration file (*note
803 Configuration file commands::).
804 .SH "SEE ALSO"
805 afm2tfm(1), tex(1), mf(1), dvips(1), dvitype(1), lpr(1),
806 .IR dvips.texi ,
807 README.overview.md,
808 https://tug.org/dvips, https://github.com/vtex-soft/xdvipsk.
809 .SH ENVIRONMENT
810 Xvipsk uses the same environment variables and algorithms for finding
811 font files as TeX and its friends do. See the documentation for the
812 Kpathsea library for details. (Repeating it here is too cumbersome.)
813 .PP
814 KPATHSEA_DEBUG: Trace Kpathsea lookups; set to -1 for complete tracing.
815 .PP
816 PRINTER: see above.
817 .SH NOTES
818 PostScript is a registered trademark of Adobe Systems Incorporated.
819 .SH AUTHOR
820 Dvips created by
821 Tomas Rokicki; extended to virtual fonts
822 by Don Knuth. Path searching and configuration modifications by
823 Karl Berry.
824 .PP
825 Main extensions by Arūnas Povilaitis;
826 fonts management by Mindaugas Piešina;
827 lua callbacks, configuration, and maintenance by Sigitas Tolušis.
828 .PP
829 Maintained in TeX Live; please send bug reports or other correspondence
830 related to dvips to [email protected] (https://lists.tug.org/tex-k)
831 and related xdvipsk to [email protected] (https://github.com/vtex-soft/xdvipsk)
832