1 ;;; ps-print.el --- print text from the buffer as PostScript
3 ;; Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
4 ;; 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
6 ;; Author: Jim Thompson (was <thompson@wg2.waii.com>)
7 ;; Jacques Duthen (was <duthen@cegelec-red.fr>)
8 ;; Vinicius Jose Latorre <viniciusjl@ig.com.br>
9 ;; Kenichi Handa <handa@m17n.org> (multi-byte characters)
10 ;; Maintainer: Kenichi Handa <handa@m17n.org> (multi-byte characters)
11 ;; Vinicius Jose Latorre <viniciusjl@ig.com.br>
12 ;; Keywords: wp, print, PostScript
14 ;; X-URL: http://www.emacswiki.org/cgi-bin/wiki/ViniciusJoseLatorre
16 (defconst ps-print-version "7.3.1"
17 "ps-print.el, v 7.3.1 <2007/11/09 vinicius>
19 Vinicius's last change version -- this file may have been edited as part of
20 Emacs without changes to the version number. When reporting bugs, please also
21 report the version of Emacs, if any, that ps-print was distributed with.
23 Please send all bug fixes and enhancements to
24 Vinicius Jose Latorre <viniciusjl@ig.com.br>.")
26 ;; This file is part of GNU Emacs.
28 ;; GNU Emacs is free software; you can redistribute it and/or modify it under
29 ;; the terms of the GNU General Public License as published by the Free
30 ;; Software Foundation; either version 3, or (at your option) any later
33 ;; GNU Emacs is distributed in the hope that it will be useful, but WITHOUT ANY
34 ;; WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
35 ;; FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
38 ;; You should have received a copy of the GNU General Public License along with
39 ;; GNU Emacs; see the file COPYING. If not, write to the Free Software
40 ;; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
44 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
49 ;; This package provides printing of Emacs buffers on PostScript printers; the
50 ;; buffer's bold and italic text attributes are preserved in the printer
51 ;; output. ps-print is intended for use with Emacs or XEmacs, together with a
52 ;; fontifying package such as font-lock or hilit.
54 ;; ps-print uses the same face attributes defined through font-lock or hilit to
55 ;; print a PostScript file, but some faces are better seeing on the screen than
56 ;; on paper, specially when you have a black/white PostScript printer.
58 ;; ps-print allows a remap of face to another one that it is better to print,
59 ;; for example, the face font-lock-comment-face (if you are using font-lock)
60 ;; could have bold or italic attribute when printing, besides foreground color.
61 ;; This remap improves printing look (see How Ps-Print Maps Faces).
67 ;; ps-print provides eight commands for generating PostScript images of Emacs
71 ;; ps-print-buffer-with-faces
73 ;; ps-print-region-with-faces
75 ;; ps-spool-buffer-with-faces
77 ;; ps-spool-region-with-faces
79 ;; These commands all perform essentially the same function: they generate
80 ;; PostScript images suitable for printing on a PostScript printer or
81 ;; displaying with GhostScript. These commands are collectively referred to as
82 ;; "ps-print- commands".
84 ;; The word "print" or "spool" in the command name determines when the
85 ;; PostScript image is sent to the printer:
87 ;; print - The PostScript image is immediately sent to the printer;
89 ;; spool - The PostScript image is saved temporarily in an Emacs
90 ;; buffer. Many images may be spooled locally before
91 ;; printing them. To send the spooled images to the
92 ;; printer, use the command `ps-despool'.
94 ;; The spooling mechanism was designed for printing lots of small files (mail
95 ;; messages or netnews articles) to save paper that would otherwise be wasted
96 ;; on banner pages, and to make it easier to find your output at the printer
97 ;; (it's easier to pick up one 50-page printout than to find 50 single-page
100 ;; ps-print has a hook in the `kill-emacs-hook' so that you won't accidentally
101 ;; quit from Emacs while you have unprinted PostScript waiting in the spool
102 ;; buffer. If you do attempt to exit with spooled PostScript, you'll be asked
103 ;; if you want to print it, and if you decline, you'll be asked to confirm the
104 ;; exit; this is modeled on the confirmation that Emacs uses for modified
107 ;; The word "buffer" or "region" in the command name determines how much of the
108 ;; buffer is printed:
110 ;; buffer - Print the entire buffer.
112 ;; region - Print just the current region.
114 ;; The -with-faces suffix on the command name means that the command will
115 ;; include font, color, and underline information in the PostScript image, so
116 ;; the printed image can look as pretty as the buffer. The ps-print- commands
117 ;; without the -with-faces suffix don't include font, color, or underline
118 ;; information; images printed with these commands aren't as pretty, but are
119 ;; faster to generate.
121 ;; Two ps-print- command examples:
123 ;; ps-print-buffer - print the entire buffer, without font,
124 ;; color, or underline information, and
125 ;; send it immediately to the printer.
127 ;; ps-spool-region-with-faces - print just the current region; include
128 ;; font, color, and underline information,
129 ;; and spool the image in Emacs to send to
130 ;; the printer later.
136 ;; To print your buffer, type
138 ;; M-x ps-print-buffer
140 ;; or substitute one of the other seven ps-print- commands. The command will
141 ;; generate the PostScript image and print or spool it as specified. By giving
142 ;; the command a prefix argument
144 ;; C-u M-x ps-print-buffer
146 ;; it will save the PostScript image to a file instead of sending it to the
147 ;; printer; you will be prompted for the name of the file to save the image to.
148 ;; The prefix argument is ignored by the commands that spool their images, but
149 ;; you may save the spooled images to a file by giving a prefix argument to
152 ;; C-u M-x ps-despool
154 ;; When invoked this way, `ps-despool' will prompt you for the name of the file
157 ;; Any of the `ps-print-' commands can be bound to keys; I recommend binding
158 ;; `ps-spool-buffer-with-faces', `ps-spool-region-with-faces', and
159 ;; `ps-despool'. Here are the bindings I use on my Sun 4 keyboard:
161 ;; (global-set-key 'f22 'ps-spool-buffer-with-faces) ;f22 is prsc
162 ;; (global-set-key '(shift f22) 'ps-spool-region-with-faces)
163 ;; (global-set-key '(control f22) 'ps-despool)
166 ;; The Printer Interface
167 ;; ---------------------
169 ;; The variables `ps-lpr-command' and `ps-lpr-switches' determine what command
170 ;; is used to send the PostScript images to the printer, and what arguments to
171 ;; give the command. These are analogous to `lpr-command' and `lpr-switches'.
173 ;; Make sure that they contain appropriate values for your system;
174 ;; see the usage notes below and the documentation of these variables.
176 ;; The variable `ps-printer-name' determines the name of a local printer for
177 ;; printing PostScript files.
179 ;; The variable `ps-printer-name-option' determines the option used by some
180 ;; utilities to indicate the printer name, it's used only when
181 ;; `ps-printer-name' is a non-empty string. If you're using lpr utility to
182 ;; print, for example, `ps-printer-name-option' should be set to "-P".
184 ;; NOTE: `ps-lpr-command' and `ps-lpr-switches' take their initial values from
185 ;; the variables `lpr-command' and `lpr-switches'. If you have
186 ;; `lpr-command' set to invoke a pretty-printer such as `enscript', then
187 ;; ps-print won't work properly. `ps-lpr-command' must name a program
188 ;; that does not format the files it prints.
189 ;; `ps-printer-name' takes its initial value from the variable
190 ;; `printer-name'. `ps-printer-name-option' tries to guess which system
191 ;; Emacs is running and takes its initial value in accordance with this
194 ;; The variable `ps-print-region-function' specifies a function to print the
195 ;; region on a PostScript printer.
196 ;; See definition of `call-process-region' for calling conventions. The fourth
197 ;; and the sixth arguments are both nil.
199 ;; The variable `ps-manual-feed' indicates if the printer will manually feed
200 ;; paper. If it's nil, automatic feeding takes place. If it's non-nil, manual
201 ;; feeding takes place. The default is nil (automatic feeding).
203 ;; The variable `ps-end-with-control-d' specifies whether C-d (\x04) should be
204 ;; inserted at end of PostScript generated. Non-nil means do so. The default
205 ;; is nil (don't insert).
207 ;; If you're using Emacs for Windows 95/98/NT or MS-DOS, don't forget to
208 ;; customize the following variables: `ps-printer-name',
209 ;; `ps-printer-name-option', `ps-lpr-command', `ps-lpr-switches' and
210 ;; `ps-spool-config'. See these variables documentation in the code or by
211 ;; typing, for example, C-h v ps-printer-name RET.
217 ;; All dimensions are floats in PostScript points.
218 ;; 1 inch == 2.54 cm == 72 points
219 ;; 1 cm == (/ 1 2.54) inch == (/ 72 2.54) points
221 ;; The variable `ps-paper-type' determines the size of paper ps-print formats
222 ;; for; it should contain one of the symbols: `a4' `a3' `letter' `legal'
223 ;; `letter-small' `tabloid' `ledger' `statement' `executive' `a4small' `b4'
226 ;; If variable `ps-warn-paper-type' is nil, it's *not* given an error if
227 ;; PostScript printer doesn't have a paper with the size indicated by
228 ;; `ps-paper-type', instead it uses the default paper size. If variable
229 ;; `ps-warn-paper-type' is non-nil, it's given an error if PostScript printer
230 ;; doesn't have a paper with the size indicated by `ps-paper-type'. It's used
231 ;; when `ps-spool-config' is set to `setpagedevice' (see section Duplex
232 ;; Printers). The default value is non-nil (it gives an error).
234 ;; The variable `ps-landscape-mode' determines the orientation of the printing
235 ;; on the page: nil means `portrait' mode, non-nil means `landscape' mode.
236 ;; There is no oblique mode yet, though this is easy to do in ps.
238 ;; In landscape mode, the text is NOT scaled: you may print 70 lines in
239 ;; portrait mode and only 50 lines in landscape mode. The margins represent
240 ;; margins in the printed paper: the top margin is the margin between the top
241 ;; of the page and the printed header, whatever the orientation is.
243 ;; The variable `ps-number-of-columns' determines the number of columns both in
244 ;; landscape and portrait mode.
246 ;; - (the standard) one column portrait mode.
247 ;; - (my favorite) two columns landscape mode (which spares trees).
249 ;; - one column landscape mode for files with very long lines.
250 ;; - multi-column portrait or landscape mode.
252 ;; The variable `ps-print-upside-down' determines other orientation for
253 ;; printing page: nil means `normal' printing, non-nil means `upside-down'
254 ;; printing (that is, the page is rotated by 180 grades). The default value is
255 ;; nil (`normal' printing).
257 ;; The `upside-down' orientation can be used in portrait or landscape mode.
259 ;; The variable `ps-selected-pages' specifies which pages to print. If it's
260 ;; nil, all pages are printed. If it's a list, the list element may be an
261 ;; integer or a cons cell (FROM . TO) designating FROM page to TO page; any
262 ;; invalid element is ignored, that is, an integer lesser than one or if FROM
263 ;; is greater than TO. Otherwise, it's treated as nil. The default value is
264 ;; nil (print all pages). After ps-print processing `ps-selected-pages' is set
265 ;; to nil. But the latest `ps-selected-pages' is saved in
266 ;; `ps-last-selected-pages' (see it for documentation). So you can restore the
267 ;; latest selected pages by using `ps-last-selected-pages' or by calling
268 ;; `ps-restore-selected-pages' command (see it for documentation).
270 ;; The variable `ps-even-or-odd-pages' specifies if it prints even/odd pages.
274 ;; nil print all pages.
276 ;; even-page print only even pages.
278 ;; odd-page print only odd pages.
280 ;; even-sheet print only even sheets.
282 ;; odd-sheet print only odd sheets.
284 ;; Any other value is treated as nil. The default value is nil.
286 ;; See `ps-even-or-odd-pages' for more detailed documentation.
292 ;; The horizontal layout is determined by the variables
293 ;; `ps-left-margin' `ps-inter-column' `ps-right-margin'
296 ;; ------------------------------------------
298 ;; | lm | text | ic | text | ic | text | rm |
300 ;; ------------------------------------------
302 ;; If `ps-number-of-columns' is 1, `ps-inter-column' is not relevant.
303 ;; Usually, lm = rm > 0 and ic = lm
304 ;; If (ic < 0), the text of adjacent columns can overlap.
310 ;; The vertical layout is determined by the variables
311 ;; `ps-bottom-margin' `ps-top-margin' `ps-header-offset' `ps-footer-offset'
314 ;; |--------| |--------| |--------| |--------|
315 ;; | tm | | tm | | tm | | tm |
316 ;; |--------| |--------| |--------| |--------|
317 ;; | header | | | | header | | |
318 ;; |--------| | | |--------| | |
319 ;; | ho | | | | ho | | |
320 ;; |--------| | | |--------| | |
322 ;; | text | or | text | or | text | or | text |
324 ;; | | |--------| |--------| | |
325 ;; | | | fo | | fo | | |
326 ;; | | |--------| |--------| | |
327 ;; | | | footer | | footer | | |
328 ;; |--------| |--------| |--------| |--------|
329 ;; | bm | | bm | | bm | | bm |
330 ;; |--------| |--------| |--------| |--------|
332 ;; If `ps-print-header' is nil, `ps-header-offset' is not relevant.
333 ;; If `ps-print-footer' is nil, `ps-footer-offset' is not relevant.
334 ;; The margins represent margins in the printed paper:
335 ;; the top margin is the margin between the top of the page and the printed
336 ;; header, whatever the orientation is;
337 ;; the bottom margin is the margin between the bottom of the page and the
338 ;; printed footer, whatever the orientation is.
344 ;; ps-print can print headers at the top of each column or at the top of each
345 ;; page; the default headers contain the following four items: on the left, the
346 ;; name of the buffer and, if the buffer is visiting a file, the file's
347 ;; directory; on the right, the page number and date of printing. The default
348 ;; headers look something like this:
351 ;; /home/jct/emacs-lisp/ps/new 94/12/31
353 ;; When printing on duplex printers, left and right are reversed so that the
354 ;; page numbers are toward the outside (cf. `ps-spool-duplex').
356 ;; Headers are configurable:
357 ;; To turn them off completely, set `ps-print-header' to nil.
358 ;; To turn off the header's gaudy framing box,
359 ;; set `ps-print-header-frame' to nil.
361 ;; The variable `ps-header-frame-alist' specifies header frame properties
362 ;; alist. Valid frame properties are:
364 ;; fore-color Specify the foreground frame color.
365 ;; It should be a float number between 0.0 (black color)
366 ;; and 1.0 (white color), a string which is a color name,
367 ;; or a list of 3 float numbers which corresponds to the
368 ;; Red Green Blue color scale, each float number between
369 ;; 0.0 (dark color) and 1.0 (bright color).
370 ;; The default is 0 ("black").
372 ;; back-color Specify the background frame color (similar to
373 ;; fore-color). The default is 0.9 ("gray90").
375 ;; shadow-color Specify the shadow color (similar to fore-color).
376 ;; The default is 0 ("black").
378 ;; border-color Specify the border color (similar to fore-color).
379 ;; The default is 0 ("black").
381 ;; border-width Specify the border width.
382 ;; The default is 0.4.
384 ;; Any other property is ignored.
386 ;; Don't change this alist directly, instead use customization, or `ps-value',
387 ;; `ps-get', `ps-put' and `ps-del' functions (see them for documentation).
389 ;; To print only one header at the top of each page, set
390 ;; `ps-print-only-one-header' to t.
392 ;; To switch headers, set `ps-switch-header' to:
394 ;; nil Never switch headers.
396 ;; t Always switch headers.
398 ;; duplex Switch headers only when duplexing is on, that is, when
399 ;; `ps-spool-duplex' is non-nil (see Duplex Printers).
401 ;; Any other value is treated as t. The default value is `duplex'.
403 ;; The font family and size of text in the header are determined by the
404 ;; variables `ps-header-font-family', `ps-header-font-size' and
405 ;; `ps-header-title-font-size' (see below).
407 ;; The variable `ps-header-line-pad' determines the portion of a header title
408 ;; line height to insert between the header frame and the text it contains,
409 ;; both in the vertical and horizontal directions: .5 means half a line.
411 ;; Page numbers are printed in `n/m' format, indicating page n of m pages; to
412 ;; omit the total page count and just print the page number, set
413 ;; `ps-show-n-of-n' to nil.
415 ;; The amount of information in the header can be changed by changing the
416 ;; number of lines. To show less, set `ps-header-lines' to 1, and the header
417 ;; will show only the buffer name and page number. To show more, set
418 ;; `ps-header-lines' to 3, and the header will show the time of printing below
421 ;; To change the content of the headers, change the variables `ps-left-header'
422 ;; and `ps-right-header'.
423 ;; These variables are lists, specifying top-to-bottom the text to display on
424 ;; the left or right side of the header. Each element of the list should be a
425 ;; string or a symbol. Strings are inserted directly into the PostScript
426 ;; arrays, and should contain the PostScript string delimiters '(' and ')'.
428 ;; Symbols in the header format lists can either represent functions or
429 ;; variables. Functions are called, and should return a string to show in the
430 ;; header. Variables should contain strings to display in the header. In
431 ;; either case, function or variable, the PostScript string delimiters are
432 ;; added by ps-print, and should not be part of the returned value.
434 ;; Here's an example: say we want the left header to display the text
440 ;; where we have a function to return "Moe"
442 ;; (defun moe-func ()
445 ;; a variable specifying "Larry"
447 ;; (setq larry-var "Larry")
449 ;; and a literal for "Curly". Here's how `ps-left-header' should be set:
451 ;; (setq ps-left-header (list 'moe-func 'larry-var "(Curly)"))
453 ;; Note that Curly has the PostScript string delimiters inside his quotes --
454 ;; those aren't misplaced lisp delimiters!
456 ;; Without them, PostScript would attempt to call the undefined function Curly,
457 ;; which would result in a PostScript error.
459 ;; Since most printers don't report PostScript errors except by aborting the
460 ;; print job, this kind of error can be hard to track down.
462 ;; Consider yourself warned!
464 ;; ps-print also print footers. The footer variables are: `ps-print-footer',
465 ;; `ps-footer-offset', `ps-print-footer-frame', `ps-footer-font-family',
466 ;; `ps-footer-font-size', `ps-footer-line-pad', `ps-footer-lines',
467 ;; `ps-left-footer', `ps-right-footer' and `ps-footer-frame-alist'. These
468 ;; variables are similar to those one that control headers.
470 ;; The variables `ps-print-only-one-header' and `ps-switch-header' also control
471 ;; the footer (The same way that control header).
473 ;; As a footer example, if you want to have a centered page number in the
474 ;; footer but without headers, set:
476 ;; (setq ps-print-header nil
478 ;; ps-print-footer-frame nil
480 ;; ps-right-footer nil
482 ;; (list (concat "{pagenumberstring dup stringwidth pop"
483 ;; " 2 div PrintWidth 2 div exch sub 0 rmoveto}")))
486 ;; PostScript Prologue Header
487 ;; --------------------------
489 ;; It is possible to add PostScript prologue header comments besides that
490 ;; ps-print generates by setting the variable `ps-print-prologue-header'.
492 ;; `ps-print-prologue-header' may be a string or a symbol function which
493 ;; returns a string. Note that this string is inserted on PostScript prologue
494 ;; header section which is used to define some document characteristic through
495 ;; PostScript special comments, like "%%Requirements: jog\n".
497 ;; By default `ps-print-prologue-header' is nil.
499 ;; ps-print always inserts the %%Requirements: comment, so if you need to
500 ;; insert more requirements put them first in `ps-print-prologue-header' using
501 ;; the "%%+" comment. For example, if you need to set numcopies to 3 and jog
502 ;; on requirements and set %%LanguageLevel: to 2, do:
504 ;; (setq ps-print-prologue-header
505 ;; "%%+ numcopies(3) jog\n%%LanguageLevel: 2\n")
507 ;; The duplex requirement is inserted by ps-print (see section Duplex
510 ;; Do not forget to terminate the string with "\n".
512 ;; For more information about PostScript document comments, see:
513 ;; PostScript Language Reference Manual (2nd edition)
514 ;; Adobe Systems Incorporated
515 ;; Appendix G: Document Structuring Conventions -- Version 3.0
517 ;; It is also possible to add an user defined PostScript prologue code before
518 ;; all generated prologue code by setting the variable
519 ;; `ps-user-defined-prologue'.
521 ;; `ps-user-defined-prologue' may be a string or a symbol function which
522 ;; returns a string. Note that this string is inserted after `ps-adobe-tag'
523 ;; and PostScript prologue comments, and before ps-print PostScript prologue
524 ;; code section. That is, this string is inserted after error handler
525 ;; initialization and before ps-print settings.
527 ;; By default `ps-user-defined-prologue' is nil.
529 ;; It's strongly recommended only insert PostScript code and/or comments
530 ;; specific for your printing system particularities. For example, some
531 ;; special initialization that only your printing system needs.
533 ;; Do not insert code for duplex printing, n-up printing or error handler,
534 ;; ps-print handles this in a suitable way.
536 ;; For more information about PostScript, see:
537 ;; PostScript Language Reference Manual (2nd edition)
538 ;; Adobe Systems Incorporated
540 ;; As an example for `ps-user-defined-prologue' setting:
542 ;; ;; Setting for HP PostScript printer
543 ;; (setq ps-user-defined-prologue
544 ;; (concat "<</DeferredMediaSelection true /PageSize [612 792] "
545 ;; "/MediaPosition 2 /MediaType (Plain)>> setpagedevice"))
548 ;; PostScript Error Handler
549 ;; ------------------------
551 ;; ps-print instruments generated PostScript code with an error handler.
553 ;; The variable `ps-error-handler-message' specifies where the error handler
554 ;; message should be sent.
558 ;; none catch the error and *DON'T* send any message.
560 ;; paper catch the error and print on paper the error message.
561 ;; This is the default value.
563 ;; system catch the error and send back the error message to
564 ;; printing system. This is useful only if printing
565 ;; system send back an email reporting the error, or if
566 ;; there is some other alternative way to report back the
567 ;; error from the system to you.
569 ;; paper-and-system catch the error, print on paper the error message and
570 ;; send back the error message to printing system.
572 ;; Any other value is treated as `paper'.
578 ;; If you have a duplex-capable printer (one that prints both sides of the
579 ;; paper), set `ps-spool-duplex' to t.
580 ;; ps-print will insert blank pages to make sure each buffer starts on the
581 ;; correct side of the paper.
583 ;; The variable `ps-spool-config' specifies who is the responsible for setting
584 ;; duplex and page size. Valid values are:
586 ;; lpr-switches duplex and page size are configured by `ps-lpr-switches'.
587 ;; Don't forget to set `ps-lpr-switches' to select duplex
588 ;; printing for your printer.
590 ;; setpagedevice duplex and page size are configured by ps-print using the
591 ;; setpagedevice PostScript operator.
593 ;; nil duplex and page size are configured by ps-print *not* using
594 ;; the setpagedevice PostScript operator.
596 ;; Any other value is treated as nil.
598 ;; The default value is `lpr-switches'.
600 ;; WARNING: The setpagedevice PostScript operator affects ghostview utility
601 ;; when viewing file generated using landscape. Also on some
602 ;; printers, setpagedevice affects zebra stripes; on other printers,
603 ;; setpagedevice affects the left margin.
604 ;; Besides all that, if your printer does not have the paper size
605 ;; specified by setpagedevice, your printing will be aborted.
606 ;; So, if you need to use setpagedevice, set `ps-spool-config' to
607 ;; `setpagedevice', generate a test file and send it to your printer;
608 ;; if the printed file isn't ok, set `ps-spool-config' to nil.
610 ;; The variable `ps-spool-tumble' specifies how the page images on opposite
611 ;; sides of a sheet are oriented with respect to each other. If
612 ;; `ps-spool-tumble' is nil, produces output suitable for binding on the left
613 ;; or right. If `ps-spool-tumble' is non-nil, produces output suitable for
614 ;; binding at the top or bottom. It has effect only when `ps-spool-duplex' is
615 ;; non-nil. The default value is nil.
617 ;; Some printer system prints a header page and forces the first page be
618 ;; printed on header page back, when using duplex. If your printer system has
619 ;; this behavior, set variable `ps-banner-page-when-duplexing' to t.
621 ;; When `ps-banner-page-when-duplexing' is non-nil, it prints a blank page as
622 ;; the very first printed page. So, it behaves as the very first character of
623 ;; buffer (or region) is ^L (\014).
625 ;; The default for `ps-banner-page-when-duplexing' is nil (*don't* skip the
632 ;; The variable `ps-n-up-printing' specifies the number of pages per sheet of
633 ;; paper. The value specified must be between 1 and 100. The default is 1.
635 ;; NOTE: some PostScript printer may crash printing if `ps-n-up-printing' is
636 ;; set to a high value (for example, 23). If this happens, set a lower value.
638 ;; The variable `ps-n-up-margin' specifies the margin in points between the
639 ;; sheet border and the n-up printing. The default is 1 cm (or 0.3937 inches,
642 ;; If variable `ps-n-up-border-p' is non-nil a border is drawn around each
643 ;; page. The default is t.
645 ;; The variable `ps-n-up-filling' specifies how page matrix is filled on each
646 ;; sheet of paper. Following are the valid values for `ps-n-up-filling' with a
647 ;; filling example using a 3x4 page matrix:
649 ;; left-top 1 2 3 4 left-bottom 9 10 11 12
651 ;; 9 10 11 12 1 2 3 4
653 ;; right-top 4 3 2 1 right-bottom 12 11 10 9
655 ;; 12 11 10 9 4 3 2 1
657 ;; top-left 1 4 7 10 bottom-left 3 6 9 12
661 ;; top-right 10 7 4 1 bottom-right 12 9 6 3
665 ;; Any other value is treated as `left-top'.
667 ;; The default value is left-top.
670 ;; Control And 8-bit Characters
671 ;; ----------------------------
673 ;; The variable `ps-print-control-characters' specifies whether you want to see
674 ;; a printable form for control and 8-bit characters, that is, instead of
675 ;; sending, for example, a ^D (\004) to printer, it is sent the string "^D".
677 ;; Valid values for `ps-print-control-characters' are:
679 ;; 8-bit This is the value to use when you want an ASCII encoding of
680 ;; any control or non-ASCII character. Control characters are
681 ;; encoded as "^D", and non-ASCII characters have an
684 ;; control-8-bit This is the value to use when you want an ASCII encoding of
685 ;; any control character, whether it is 7 or 8-bit.
686 ;; European 8-bits accented characters are printed according
689 ;; control Only ASCII control characters have an ASCII encoding.
690 ;; European 8-bits accented characters are printed according
693 ;; nil No ASCII encoding. Any character is printed according the
696 ;; Any other value is treated as nil.
698 ;; The default is `control-8-bit'.
700 ;; Characters TAB, NEWLINE and FORMFEED are always treated by ps-print engine.
703 ;; Printing Multi-byte Buffer
704 ;; --------------------------
706 ;; See ps-mule.el for documentation.
712 ;; The variable `ps-line-number' specifies whether to number each line;
713 ;; non-nil means do so. The default is nil (don't number each line).
715 ;; The variable `ps-line-number-color' specifies the color for line number.
716 ;; See `ps-zebra-color' for documentation. The default is "black" (or 0.0, or
719 ;; The variable `ps-line-number-font' specifies the font for line number.
720 ;; The default is "Times-Italic".
722 ;; The variable `ps-line-number-font-size' specifies the font size in points
723 ;; for line number. See `ps-font-size' for documentation. The default is 6.
725 ;; The variable `ps-line-number-step' specifies the interval that line number
726 ;; is printed. For example, if `ps-line-number-step' is set to 2, the printing
739 ;; integer an integer that specifies the interval that line number is
740 ;; printed. If it's lesser than or equal to zero, it's used the
743 ;; `zebra' specifies that only the line number of the first line in a
744 ;; zebra stripe is to be printed.
746 ;; Any other value is treated as `zebra'.
747 ;; The default value is 1, so each line number is printed.
749 ;; The variable `ps-line-number-start' specifies the starting point in the
750 ;; interval given by `ps-line-number-step'. For example, if
751 ;; `ps-line-number-step' is set to 3 and `ps-line-number-start' is set to 3,
752 ;; the printing will look like:
766 ;; The values for `ps-line-number-start':
768 ;; * If `ps-line-number-step' is an integer, must be between 1 and the value
769 ;; of `ps-line-number-step' inclusive.
771 ;; * If `ps-line-number-step' is set to `zebra', must be between 1 and the
772 ;; value of `ps-zebra-stripe-height' inclusive.
774 ;; The default value is 1, so the line number of the first line of each
775 ;; interval is printed.
781 ;; Zebra stripes are a kind of background that appear "underneath" the text and
782 ;; can make the text easier to read. They look like this:
784 ;; XXXXXXXXXXXXXXXXXXXXXXXX
785 ;; XXXXXXXXXXXXXXXXXXXXXXXX
786 ;; XXXXXXXXXXXXXXXXXXXXXXXX
790 ;; XXXXXXXXXXXXXXXXXXXXXXXX
791 ;; XXXXXXXXXXXXXXXXXXXXXXXX
792 ;; XXXXXXXXXXXXXXXXXXXXXXXX
794 ;; The blocks of X's represent rectangles filled with a light gray color.
795 ;; Each rectangle extends all the way across the page.
797 ;; The height, in lines, of each rectangle is controlled by the variable
798 ;; `ps-zebra-stripe-height', which is 3 by default. The distance between
799 ;; stripes equals the height of a stripe.
801 ;; The variable `ps-zebra-stripes' controls whether to print zebra stripes.
802 ;; Non-nil means yes, nil means no. The default is nil.
804 ;; The variable `ps-zebra-color' controls the zebra stripes gray scale or RGB
805 ;; color. It should be a float number between 0.0 (black color) and 1.0 (white
806 ;; color), a string which is a color name, or a list of 3 numbers which
807 ;; corresponds to the Red Green Blue color scale.
808 ;; The default is 0.95 (or "gray95", or '(0.95 0.95 0.95)).
810 ;; The variable `ps-zebra-stripe-follow' specifies how zebra stripes continue
811 ;; on next page. Visually, valid values are (the character `+' at right of
812 ;; each column indicates that a line is printed):
814 ;; `nil' `follow' `full' `full-follow'
815 ;; Current Page -------- ----------- --------- ----------------
816 ;; 1 XXXXX + 1 XXXXXXXX + 1 XXXXXX + 1 XXXXXXXXXXXXX +
817 ;; 2 XXXXX + 2 XXXXXXXX + 2 XXXXXX + 2 XXXXXXXXXXXXX +
818 ;; 3 XXXXX + 3 XXXXXXXX + 3 XXXXXX + 3 XXXXXXXXXXXXX +
822 ;; 7 XXXXX + 7 XXXXXXXX + 7 XXXXXX + 7 XXXXXXXXXXXXX +
823 ;; 8 XXXXX + 8 XXXXXXXX + 8 XXXXXX + 8 XXXXXXXXXXXXX +
824 ;; 9 XXXXX + 9 XXXXXXXX + 9 XXXXXX + 9 XXXXXXXXXXXXX +
827 ;; -------- ----------- --------- ----------------
828 ;; Next Page -------- ----------- --------- ----------------
829 ;; 12 XXXXX + 12 + 10 XXXXXX + 10 +
830 ;; 13 XXXXX + 13 XXXXXXXX + 11 XXXXXX + 11 +
831 ;; 14 XXXXX + 14 XXXXXXXX + 12 XXXXXX + 12 +
832 ;; 15 + 15 XXXXXXXX + 13 + 13 XXXXXXXXXXXXX +
833 ;; 16 + 16 + 14 + 14 XXXXXXXXXXXXX +
834 ;; 17 + 17 + 15 + 15 XXXXXXXXXXXXX +
835 ;; 18 XXXXX + 18 + 16 XXXXXX + 16 +
836 ;; 19 XXXXX + 19 XXXXXXXX + 17 XXXXXX + 17 +
837 ;; 20 XXXXX + 20 XXXXXXXX + 18 XXXXXX + 18 +
838 ;; 21 + 21 XXXXXXXX +
840 ;; -------- ----------- --------- ----------------
842 ;; Any other value is treated as nil.
844 ;; See also section How Ps-Print Has A Text And/Or Image On Background.
850 ;; ps-print has the following hook variables:
853 ;; It is evaluated once before any printing process. This is the right
854 ;; place to initialize ps-print global data.
855 ;; For an example, see section Adding a New Font Family.
857 ;; `ps-print-begin-sheet-hook'
858 ;; It is evaluated on each beginning of sheet of paper.
859 ;; If `ps-n-up-printing' is equal to 1, `ps-print-begin-page-hook' is never
862 ;; `ps-print-begin-page-hook'
863 ;; It is evaluated on each beginning of page, except in the beginning of
864 ;; page that `ps-print-begin-sheet-hook' is evaluated.
866 ;; `ps-print-begin-column-hook'
867 ;; It is evaluated on each beginning of column, except in the beginning of
868 ;; column that `ps-print-begin-page-hook' is evaluated or that
869 ;; `ps-print-begin-sheet-hook' is evaluated.
875 ;; ps-print now knows rather precisely some fonts: the variable
876 ;; `ps-font-info-database' contains information for a list of font families
877 ;; (currently mainly `Courier' `Helvetica' `Times' `Palatino'
878 ;; `Helvetica-Narrow' `NewCenturySchlbk'). Each font family contains the font
879 ;; names for standard, bold, italic and bold-italic characters, a reference
880 ;; size (usually 10) and the corresponding line height, width of a space and
881 ;; average character width.
883 ;; The variable `ps-font-family' determines which font family is to be used for
884 ;; ordinary text. If its value does not correspond to a known font family, an
885 ;; error message is printed into the `*Messages*' buffer, which lists the
886 ;; currently available font families.
888 ;; The variable `ps-font-size' determines the size (in points) of the font for
889 ;; ordinary text, when generating PostScript. Its value is a float or a cons
890 ;; of floats which has the following form:
892 ;; (LANDSCAPE-SIZE . PORTRAIT-SIZE)
894 ;; Similarly, the variable `ps-header-font-family' determines which font family
895 ;; is to be used for text in the header.
897 ;; The variable `ps-header-font-size' determines the font size, in points, for
898 ;; text in the header (similar to `ps-font-size').
900 ;; The variable `ps-header-title-font-size' determines the font size, in
901 ;; points, for the top line of text in the header (similar to `ps-font-size').
903 ;; The variable `ps-line-spacing' determines the line spacing, in points, for
904 ;; ordinary text, when generating PostScript (similar to `ps-font-size'). The
905 ;; default value is 0 (zero = no line spacing).
907 ;; The variable `ps-paragraph-spacing' determines the paragraph spacing, in
908 ;; points, for ordinary text, when generating PostScript (similar to
909 ;; `ps-font-size'). The default value is 0 (zero = no paragraph spacing).
911 ;; To get all lines with some spacing set both `ps-line-spacing' and
912 ;; `ps-paragraph-spacing' variables.
914 ;; The variable `ps-paragraph-regexp' specifies the paragraph delimiter. It
915 ;; should be a regexp or nil. The default value is "[ \t]*$", that is, an
916 ;; empty line or a line containing only spaces and tabs.
918 ;; The variable `ps-begin-cut-regexp' and `ps-end-cut-regexp' specify the start
919 ;; and end of a region to cut out when printing.
921 ;; As an example, variables `ps-begin-cut-regexp' and `ps-end-cut-regexp' may
922 ;; be set to "^Local Variables:" and "^End:", respectively, in order to leave
923 ;; out some special printing instructions from the actual print. Special
924 ;; printing instructions may be appended to the end of the file just like any
925 ;; other buffer-local variables. See section "Local Variables in Files" on
926 ;; Emacs manual for more information.
928 ;; Variables `ps-begin-cut-regexp' and `ps-end-cut-regexp' control together
929 ;; what actually gets printed. Both variables may be set to nil in which case
930 ;; no cutting occurs. By default, both variables are set to nil.
933 ;; Adding a New Font Family
934 ;; ------------------------
936 ;; To use a new font family, you MUST first teach ps-print this font, i.e., add
937 ;; its information to `ps-font-info-database', otherwise ps-print cannot
938 ;; correctly place line and page breaks.
940 ;; For example, assuming `Helvetica' is unknown, you first need to do the
941 ;; following ONLY ONCE:
943 ;; - create a new buffer
944 ;; - generate the PostScript image to a file (C-u M-x ps-print-buffer)
945 ;; - open this file and find the line:
946 ;; `% 3 cm 20 cm moveto 10/Courier ReportFontInfo showpage'
947 ;; - delete the leading `%' (which is the PostScript comment character)
948 ;; - replace in this line `Courier' by the new font (say `Helvetica') to get
950 ;; `3 cm 20 cm moveto 10/Helvetica ReportFontInfo showpage'
951 ;; - send this file to the printer (or to ghostscript).
952 ;; You should read the following on the output page:
954 ;; For Helvetica 10 point, the line height is 11.56, the space width is 2.78
955 ;; and a crude estimate of average character width is 5.09243
957 ;; - Add these values to the `ps-font-info-database':
958 ;; (setq ps-font-info-database
960 ;; '((Helvetica ; the family key
961 ;; (fonts (normal . "Helvetica")
962 ;; (bold . "Helvetica-Bold")
963 ;; (italic . "Helvetica-Oblique")
964 ;; (bold-italic . "Helvetica-BoldOblique"))
966 ;; (line-height . 11.56)
967 ;; (space-width . 2.78)
968 ;; (avg-char-width . 5.09243)))
969 ;; ps-font-info-database))
970 ;; - Now you can use this font family with any size:
971 ;; (setq ps-font-family 'Helvetica)
972 ;; - if you want to use this family in another emacs session, you must put into
974 ;; (require 'ps-print)
975 ;; (setq ps-font-info-database (append ...)))
976 ;; if you don't want to load ps-print, you have to copy the whole value:
977 ;; (setq ps-font-info-database '(<your stuff> <the standard stuff>))
978 ;; or, use `ps-print-hook' (see section Hooks):
979 ;; (add-hook 'ps-print-hook
981 ;; (or (assq 'Helvetica ps-font-info-database)
982 ;; (setq ps-font-info-database (append ...)))))
984 ;; You can create new `mixed' font families like:
986 ;; (fonts (normal . "Courier-Bold")
987 ;; (bold . "Helvetica")
988 ;; (italic . "ZapfChancery-MediumItalic")
989 ;; (bold-italic . "NewCenturySchlbk-BoldItalic")
990 ;; (w3-table-hack-x-face . "LineDrawNormal"))
992 ;; (line-height . 10.55)
993 ;; (space-width . 6.0)
994 ;; (avg-char-width . 6.0))
996 ;; Now you can use your new font family with any size:
997 ;; (setq ps-font-family 'my-mixed-family)
999 ;; Note that on above example the `w3-table-hack-x-face' entry refers to a face
1000 ;; symbol, so when printing this face it'll be used the font `LineDrawNormal'.
1001 ;; If the face `w3-table-hack-x-face' is remapped to use bold and/or italic
1002 ;; attribute, the corresponding entry (bold, italic or bold-italic) will be
1003 ;; used instead of `w3-table-hack-x-face' entry.
1005 ;; Note also that the font family entry order is irrelevant, so the above
1006 ;; example could also be written:
1009 ;; (fonts (w3-table-hack-x-face . "LineDrawNormal")
1010 ;; (bold . "Helvetica")
1011 ;; (bold-italic . "NewCenturySchlbk-BoldItalic")
1012 ;; (italic . "ZapfChancery-MediumItalic")
1013 ;; (normal . "Courier-Bold"))
1014 ;; (avg-char-width . 6.0)
1015 ;; (space-width . 6.0)
1016 ;; (line-height . 10.55))
1018 ;; Despite the note above, it is recommended that some convention about
1019 ;; entry order be used.
1021 ;; You can get information on all the fonts resident in YOUR printer
1022 ;; by uncommenting the line:
1023 ;; % 3 cm 20 cm moveto ReportAllFontInfo showpage
1025 ;; The PostScript file should be sent to YOUR PostScript printer.
1026 ;; If you send it to ghostscript or to another PostScript printer, you may get
1027 ;; slightly different results.
1028 ;; Anyway, as ghostscript fonts are autoload, you won't get much font info.
1030 ;; Note also that ps-print DOESN'T download any font to your printer, instead
1031 ;; it uses the fonts resident in your printer.
1034 ;; How Ps-Print Deals With Faces
1035 ;; -----------------------------
1037 ;; The ps-print-*-with-faces commands attempt to determine which faces should
1038 ;; be printed in bold or italic, but their guesses aren't always right. For
1039 ;; example, you might want to map colors into faces so that blue faces print in
1040 ;; bold, and red faces in italic.
1042 ;; It is possible to force ps-print to consider specific faces bold, italic or
1043 ;; underline, no matter what font they are displayed in, by setting the
1044 ;; variables `ps-bold-faces', `ps-italic-faces' and `ps-underlined-faces'.
1045 ;; These variables contain lists of faces that ps-print should consider bold,
1046 ;; italic or underline; to set them, put code like the following into your
1049 ;; (setq ps-bold-faces '(my-blue-face))
1050 ;; (setq ps-italic-faces '(my-red-face))
1051 ;; (setq ps-underlined-faces '(my-green-face))
1053 ;; Faces like bold-italic that are both bold and italic should go in *both*
1056 ;; ps-print keeps internal lists of which fonts are bold and which are italic;
1057 ;; these lists are built the first time you invoke ps-print.
1058 ;; For the sake of efficiency, the lists are built only once; the same lists
1059 ;; are referred in later invocations of ps-print.
1061 ;; Because these lists are built only once, it's possible for them to get out
1062 ;; of sync, if a face changes, or if new faces are added. To get the lists
1063 ;; back in sync, you can set the variable `ps-build-face-reference' to t, and
1064 ;; the lists will be rebuilt the next time ps-print is invoked. If you need
1065 ;; that the lists always be rebuilt when ps-print is invoked, set the variable
1066 ;; `ps-always-build-face-reference' to t.
1068 ;; If you need to print without worrying about face background color, set the
1069 ;; variable `ps-use-face-background' which specifies if face background should
1070 ;; be used. Valid values are:
1072 ;; t always use face background color.
1073 ;; nil never use face background color.
1074 ;; (face...) list of faces whose background color will be used.
1076 ;; Any other value will be treated as t.
1077 ;; The default value is nil.
1080 ;; How Ps-Print Deals With Color
1081 ;; -----------------------------
1083 ;; ps-print detects faces with foreground and background colors defined and
1084 ;; embeds color information in the PostScript image.
1085 ;; The default foreground and background colors are defined by the variables
1086 ;; `ps-default-fg' and `ps-default-bg'.
1087 ;; On black/white printers, colors are displayed in gray scale.
1088 ;; To turn off color output, set `ps-print-color-p' to nil.
1089 ;; You can also set `ps-print-color-p' to 'black-white to have a better looking
1090 ;; on black/white printers. See also `ps-black-white-faces' for documentation.
1092 ;; ps-print also detects if the text foreground and background colors are
1093 ;; equals when `ps-fg-validate-p' is non-nil. In this case, if these colors
1094 ;; are used, no text will appear. You can use `ps-fg-list' to give a list of
1095 ;; foreground colors to be used when text foreground and background colors are
1096 ;; equals. It'll be used the first foreground color in `ps-fg-list' which is
1097 ;; different from the background color. If `ps-fg-list' is nil, the default
1098 ;; foreground color is used.
1101 ;; How Ps-Print Maps Faces
1102 ;; -----------------------
1104 ;; As ps-print uses PostScript to print buffers, it is possible to have other
1105 ;; attributes associated with faces. So the new attributes used by ps-print
1108 ;; strikeout - like underline, but the line is in middle of text.
1109 ;; overline - like underline, but the line is over the text.
1110 ;; shadow - text will have a shadow.
1111 ;; box - text will be surrounded by a box.
1112 ;; outline - print characters as hollow outlines.
1114 ;; See the documentation for `ps-extend-face'.
1116 ;; Let's, for example, remap `font-lock-keyword-face' to another foreground
1117 ;; color and bold attribute:
1119 ;; (ps-extend-face '(font-lock-keyword-face "RoyalBlue" nil bold) 'MERGE)
1121 ;; If you want to use a new face, define it first with `defface', and then call
1122 ;; `ps-extend-face' to specify how to print it.
1125 ;; How Ps-Print Has A Text And/Or Image On Background
1126 ;; --------------------------------------------------
1128 ;; ps-print can print texts and/or EPS PostScript images on background; it is
1129 ;; possible to define the following text attributes: font name, font size,
1130 ;; initial position, angle, gray scale and pages to print.
1132 ;; It has the following EPS PostScript images attributes: file name containing
1133 ;; the image, initial position, X and Y scales, angle and pages to print.
1135 ;; See documentation for `ps-print-background-text' and
1136 ;; `ps-print-background-image'.
1138 ;; For example, if we wish to print text "preliminary" on all pages and text
1139 ;; "special" on page 5 and from page 11 to page 17, we could specify:
1141 ;; (setq ps-print-background-text
1142 ;; '(("preliminary")
1144 ;; "LeftMargin" "BottomMargin PrintHeight add" ; X and Y position
1145 ;; ; (upper left corner)
1147 ;; "PrintHeight neg PrintPageWidth atan" ; angle
1148 ;; 5 (11 . 17)) ; page list
1151 ;; Similarly, we could print image "~/images/EPS-image1.ps" on all pages and
1152 ;; image "~/images/EPS-image2.ps" on page 5 and from page 11 to page 17, we
1155 ;; (setq ps-print-background-image
1156 ;; '(("~/images/EPS-image1.ps"
1157 ;; "LeftMargin" "BottomMargin") ; X and Y position (lower left corner)
1158 ;; ("~/images/EPS-image2.ps"
1159 ;; "LeftMargin" "BottomMargin PrintHeight 2 div add" ; X and Y pos.
1160 ;; ; (upper left corner)
1162 ;; 5 (11 . 17)) ; page list
1165 ;; If it is not possible to read (or does not exist) an image file, that file
1168 ;; The printing order is:
1170 ;; 1. Print background color
1171 ;; 2. Print zebra stripes
1172 ;; 3. Print background texts that it should be on all pages
1173 ;; 4. Print background images that it should be on all pages
1174 ;; 5. Print background texts only for current page (if any)
1175 ;; 6. Print background images only for current page (if any)
1177 ;; 8. Print buffer text (with faces, if specified) and line number
1183 ;; Some tools are provided to help you customize your font setup.
1185 ;; `ps-setup' returns (some part of) the current setup.
1187 ;; To avoid wrapping too many lines, you may want to adjust the left and right
1188 ;; margins and the font size. On UN*X systems, do:
1189 ;; pr -t file | awk '{printf "%3d %s\n", length($0), $0}' | sort -r | head
1190 ;; to determine the longest lines of your file.
1191 ;; Then, the command `ps-line-lengths' will give you the correspondence between
1192 ;; a line length (number of characters) and the maximum font size which doesn't
1193 ;; wrap such a line with the current ps-print setup.
1195 ;; The commands `ps-nb-pages-buffer' and `ps-nb-pages-region' display the
1196 ;; correspondence between a number of pages and the maximum font size which
1197 ;; allow the number of lines of the current buffer or of its current region to
1198 ;; fit in this number of pages.
1200 ;; NOTE: line folding is not taken into account in this process and could
1201 ;; change the results.
1203 ;; The command `ps-print-customize' activates a customization buffer for
1204 ;; ps-print options.
1207 ;; New since version 1.5
1208 ;; ---------------------
1210 ;; Color output capability.
1211 ;; Automatic detection of font attributes (bold, italic).
1212 ;; Configurable headers with page numbers.
1214 ;; Support for different paper sizes.
1215 ;; Better conformance to PostScript Document Structure Conventions.
1218 ;; New since version 2.8
1219 ;; ---------------------
1221 ;; [vinicius] Vinicius Jose Latorre <viniciusjl@ig.com.br>
1224 ;; `ps-fg-validate-p', `ps-fg-list'
1227 ;; `ps-time-stamp-yyyy-mm-dd', `ps-time-stamp-iso8601'
1230 ;; `ps-time-stamp-locale-default'
1233 ;; Handle before-string and after-string overlay properties.
1236 ;; `ps-line-number-color', `ps-print-footer', `ps-footer-offset',
1237 ;; `ps-print-footer-frame', `ps-footer-font-family',
1238 ;; `ps-footer-font-size', `ps-footer-line-pad', `ps-footer-lines',
1239 ;; `ps-left-footer', `ps-right-footer', `ps-footer-frame-alist' and
1240 ;; `ps-header-frame-alist'.
1243 ;; `ps-line-spacing', `ps-paragraph-spacing', `ps-paragraph-regexp',
1244 ;; `ps-begin-cut-regexp' and `ps-end-cut-regexp'.
1247 ;; `ps-line-number-font', `ps-line-number-font-size' and
1248 ;; `ps-end-with-control-d'.
1251 ;; `ps-even-or-odd-pages'
1254 ;; `ps-manual-feed', `ps-warn-paper-type', `ps-print-upside-down',
1255 ;; `ps-selected-pages', `ps-last-selected-pages',
1256 ;; `ps-restore-selected-pages', `ps-switch-header',
1257 ;; `ps-line-number-step', `ps-line-number-start',
1258 ;; `ps-zebra-stripe-follow' and `ps-use-face-background'.
1261 ;; PostScript error handler.
1262 ;; `ps-user-defined-prologue' and `ps-error-handler-message'.
1265 ;; `ps-print-customize'.
1268 ;; Better customization.
1269 ;; `ps-banner-page-when-duplexing' and `ps-zebra-color'.
1273 ;; Hook: `ps-print-begin-sheet-hook'.
1275 ;; [kenichi] 1999-05-09 Ken'ichi Handa <handa@m17n.org>
1277 ;; `ps-print-region-function'
1279 ;; [vinicius] Vinicius Jose Latorre <viniciusjl@ig.com.br>
1282 ;; PostScript tumble and setpagedevice.
1285 ;; PostScript prologue header comment insertion.
1286 ;; Skip invisible text better.
1288 ;; [kenichi] 1998-08-19 Ken'ichi Handa <handa@m17n.org>
1290 ;; Multi-byte buffer handling.
1292 ;; [vinicius] Vinicius Jose Latorre <viniciusjl@ig.com.br>
1295 ;; Skip invisible text.
1298 ;; Hooks: `ps-print-hook', `ps-print-begin-page-hook' and
1299 ;; `ps-print-begin-column-hook'.
1300 ;; Put one header per page over the columns.
1301 ;; Better database font management.
1302 ;; Better control characters handling.
1305 ;; Dynamic evaluation at print time of `ps-lpr-switches'.
1306 ;; Handle control characters.
1308 ;; New face attributes.
1311 ;; Text and/or image on background.
1313 ;; [jack] 1996-05-17 Jacques Duthen <duthen@cegelec-red.fr>
1315 ;; Font family and float size for text and header.
1317 ;; Multiple columns.
1318 ;; Tools for page setup.
1321 ;; Known bugs and limitations of ps-print
1322 ;; --------------------------------------
1324 ;; Although color printing will work in XEmacs 19.12, it doesn't work well; in
1325 ;; particular, bold or italic fonts don't print in the right background color.
1327 ;; Invisible properties aren't correctly ignored in XEmacs 19.12.
1329 ;; Automatic font-attribute detection doesn't work well, especially with
1330 ;; hilit19 and older versions of get-create-face. Users having problems with
1331 ;; auto-font detection should use the lists `ps-italic-faces', `ps-bold-faces'
1332 ;; and `ps-underlined-faces' and/or turn off automatic detection by setting
1333 ;; `ps-auto-font-detect' to nil.
1335 ;; Automatic font-attribute detection doesn't work with XEmacs 19.12 in tty
1336 ;; mode; use the lists `ps-italic-faces', `ps-bold-faces' and
1337 ;; `ps-underlined-faces' instead.
1339 ;; Still too slow; could use some hand-optimization.
1341 ;; Default background color isn't working.
1343 ;; Faces are always treated as opaque.
1345 ;; Epoch, Lucid and Emacs 22 not supported. At all.
1347 ;; Fixed-pitch fonts work better for line folding, but are not required.
1349 ;; `ps-nb-pages-buffer' and `ps-nb-pages-region' don't take care of folding
1356 ;; Avoid page break inside a paragraph.
1358 ;; Add `ps-non-bold-faces' and `ps-non-italic-faces' (should be easy).
1360 ;; Improve the memory management for big files (hard?).
1362 ;; `ps-nb-pages-buffer' and `ps-nb-pages-region' should take care of folding
1369 ;; Thanks to Michael Piotrowski <mxp@dynalabs.de> for improving the DSC
1370 ;; compliance of the generated PostScript.
1372 ;; Thanks to Adam Doppelt <adoppelt@avogadro.com> for face mapping suggestion
1373 ;; for black/white PostScript printers.
1375 ;; Thanks to Toni Ronkko <tronkko@hytti.uku.fi> for line and paragraph spacing,
1376 ;; region to cut out when printing and footer suggestions.
1378 ;; Thanks to Pavel Janik ml <Pavel@Janik.cz> for documentation correction.
1380 ;; Thanks to Corinne Ilvedson <cilvedson@draper.com> for line number font size
1383 ;; Thanks to Gord Wait <Gord_Wait@spectrumsignal.com> for
1384 ;; `ps-user-defined-prologue' example setting for HP PostScript printer.
1386 ;; Thanks to Paul Furnanz <pfurnanz@synopsys.com> for XEmacs compatibility
1387 ;; suggestion for `ps-postscript-code-directory' variable.
1389 ;; Thanks to David X Callaway <dxc@xprt.net> for helping debugging PostScript
1390 ;; level 1 compatibility.
1392 ;; Thanks to Colin Marquardt <colin.marquardt@usa.alcatel.com> for:
1393 ;; - upside-down, line number step, line number start and zebra stripe
1394 ;; follow suggestions.
1395 ;; - `ps-time-stamp-yyyy-mm-dd' and `ps-time-stamp-iso8601' suggestion.
1396 ;; - and for XEmacs beta-tests.
1398 ;; Thanks to Klaus Berndl <klaus.berndl@sdm.de> for user defined PostScript
1399 ;; prologue code suggestion, for odd/even printing suggestion and for
1400 ;; `ps-prologue-file' enhancement.
1402 ;; Thanks to Ken'ichi Handa <handa@m17n.org> for multi-byte buffer handling.
1404 ;; Thanks to Matthew O Persico <Matthew.Persico@lazard.com> for line number on
1407 ;; Thanks to Theodore Jump <tjump@cais.com> for adjust PostScript code order on
1410 ;; Thanks to Roland Ducournau <ducour@lirmm.fr> for
1411 ;; `ps-print-control-characters' variable documentation.
1413 ;; Thanks to Marcus G Daniels <marcus@cathcart.sysc.pdx.edu> for a better
1414 ;; database font management.
1416 ;; Thanks to Martin Boyer <gamin@videotron.ca> for some ideas on putting one
1417 ;; header per page over the columns and correct line numbers when printing a
1420 ;; Thanks to Steven L Baur <steve@miranova.com> for dynamic evaluation at
1421 ;; print time of `ps-lpr-switches'.
1423 ;; Thanks to Kevin Rodgers <kevinr@ihs.com> for handling control characters
1424 ;; (his code was severely modified, but the main idea was kept).
1426 ;; Thanks to some suggestions on:
1427 ;; * Face color map: Marco Melgazzi <marco@techie.com>
1428 ;; * XEmacs compatibility: William J. Henney <will@astrosmo.unam.mx>
1429 ;; * Check `ps-paper-type': Sudhakar Frederick <sfrederi@asc.corp.mot.com>
1431 ;; Thanks to Jacques Duthen <duthen@cegelec-red.fr> (Jack) for version 3.4 I
1432 ;; started from. [vinicius]
1434 ;; Thanks to Jim Thompson <?@?> for the 2.8 version I started from. [jack]
1436 ;; Thanks to Kevin Rodgers <kevinr@ihs.com> for adding support for color and
1437 ;; the invisible property.
1439 ;; Thanks to Avishai Yacobi, avishaiy@mcil.comm.mot.com, for writing the
1440 ;; initial port to Emacs 19. His code is no longer part of ps-print, but his
1441 ;; work is still appreciated.
1443 ;; Thanks to Remi Houdaille and Michel Train <michel@metasoft.fdn.org> for
1444 ;; adding underline support. Their code also is no longer part of ps-print,
1445 ;; but their efforts are not forgotten.
1447 ;; Thanks also to all of you who mailed code to add features to ps-print;
1448 ;; although I didn't use your code, I still appreciate your sharing it with me.
1450 ;; Thanks to all who mailed comments, encouragement, and criticism.
1451 ;; Thanks also to all who responded to my survey; I had too many responses to
1452 ;; reply to them all, but I greatly appreciate your interest.
1455 ;; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1463 (or (featurep 'lisp-float-type)
1464 (error "`ps-print' requires floating point support"))
1467 (if (featurep 'xemacs)
1469 (unless (and (boundp 'emacs-major-version)
1470 (>= emacs-major-version 23))
1471 (error "`ps-print' only supports Emacs 23 and higher")))
1474 (defconst ps-windows-system
1475 (memq system-type '(emx win32 w32 mswindows ms-dos windows-nt)))
1476 (defconst ps-lp-system
1477 (memq system-type '(usg-unix-v dgux hpux irix)))
1480 ;; Load XEmacs/Emacs definitions
1481 (eval-and-compile (require 'ps-def))
1484 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1488 ;;; Interface to the command system
1490 (defgroup postscript nil
1496 (defgroup ps-print nil
1497 "PostScript generator for Emacs."
1498 :link '(emacs-library-link :tag "Source Lisp File" "ps-print.el")
1504 (defgroup ps-print-horizontal nil
1505 "Horizontal page layout."
1511 (defgroup ps-print-vertical nil
1512 "Vertical page layout."
1518 (defgroup ps-print-headers nil
1519 "Headers & footers layout."
1521 :tag "Header & Footer"
1525 (defgroup ps-print-font nil
1526 "Fonts customization."
1532 (defgroup ps-print-color nil
1533 "Color customization."
1539 (defgroup ps-print-face nil
1540 "Faces customization."
1547 (defgroup ps-print-n-up nil
1548 "N-up customization."
1554 (defgroup ps-print-zebra nil
1555 "Zebra customization."
1561 (defgroup ps-print-background nil
1562 "Background customization."
1568 (defgroup ps-print-printer '((lpr custom-group))
1569 "Printer customization."
1575 (defgroup ps-print-page nil
1576 "Page customization."
1582 (defgroup ps-print-miscellany nil
1583 "Miscellany customization."
1590 (defcustom ps-error-handler-message 'paper
1591 "*Specify where the error handler message should be sent.
1595 `none' catch the error and *DON'T* send any message.
1597 `paper' catch the error and print on paper the error message.
1599 `system' catch the error and send back the error message to
1600 printing system. This is useful only if printing system
1601 send back an email reporting the error, or if there is
1602 some other alternative way to report back the error from
1605 `paper-and-system' catch the error, print on paper the error message and
1606 send back the error message to printing system.
1608 Any other value is treated as `paper'."
1609 :type '(choice :menu-tag "Error Handler Message"
1610 :tag "Error Handler Message"
1611 (const none) (const paper)
1612 (const system) (const paper-and-system))
1614 :group 'ps-print-miscellany)
1616 (defcustom ps-user-defined-prologue nil
1617 "*User defined PostScript prologue code inserted before all prologue code.
1619 `ps-user-defined-prologue' may be a string or a symbol function which returns a
1620 string. Note that this string is inserted after `ps-adobe-tag' and PostScript
1621 prologue comments, and before ps-print PostScript prologue code section. That
1622 is, this string is inserted after error handler initialization and before
1625 It's strongly recommended only insert PostScript code and/or comments specific
1626 for your printing system particularities. For example, some special
1627 initialization that only your printing system needs.
1629 Do not insert code for duplex printing, n-up printing or error handler,
1630 ps-print handles this in a suitable way.
1632 For more information about PostScript, see:
1633 PostScript Language Reference Manual (2nd edition)
1634 Adobe Systems Incorporated
1636 As an example for `ps-user-defined-prologue' setting:
1638 ;; Setting for HP PostScript printer
1639 (setq ps-user-defined-prologue
1640 (concat \"<</DeferredMediaSelection true /PageSize [612 792] \"
1641 \"/MediaPosition 2 /MediaType (Plain)>> setpagedevice\"))"
1642 :type '(choice :menu-tag "User Defined Prologue"
1643 :tag "User Defined Prologue"
1644 (const :tag "none" nil) string symbol)
1646 :group 'ps-print-miscellany)
1648 (defcustom ps-print-prologue-header nil
1649 "*PostScript prologue header comments besides that ps-print generates.
1651 `ps-print-prologue-header' may be a string or a symbol function which returns a
1652 string. Note that this string is inserted on PostScript prologue header
1653 section which is used to define some document characteristic through PostScript
1654 special comments, like \"%%Requirements: jog\\n\".
1656 ps-print always inserts the %%Requirements: comment, so if you need to insert
1657 more requirements put them first in `ps-print-prologue-header' using the
1658 \"%%+\" comment. For example, if you need to set numcopies to 3 and jog on
1659 requirements and set %%LanguageLevel: to 2, do:
1661 (setq ps-print-prologue-header
1662 \"%%+ numcopies(3) jog\\n%%LanguageLevel: 2\\n\")
1664 The duplex requirement is inserted by ps-print (see `ps-spool-duplex').
1666 Do not forget to terminate the string with \"\\n\".
1668 For more information about PostScript document comments, see:
1669 PostScript Language Reference Manual (2nd edition)
1670 Adobe Systems Incorporated
1671 Appendix G: Document Structuring Conventions -- Version 3.0"
1672 :type '(choice :menu-tag "Prologue Header"
1673 :tag "Prologue Header"
1674 (const :tag "none" nil) string symbol)
1676 :group 'ps-print-miscellany)
1678 (defcustom ps-printer-name (and (boundp 'printer-name)
1679 (symbol-value 'printer-name))
1680 "*The name of a local printer for printing PostScript files.
1682 On Unix-like systems, a string value should be a name understood by lpr's -P
1683 option; a value of nil means use the value of `printer-name' instead.
1685 On MS-DOS and MS-Windows systems, a string value is taken as the name of the
1686 printer device or port to which PostScript files are written, provided
1687 `ps-lpr-command' is \"\". By default it is the same as `printer-name'; typical
1688 non-default settings would be \"LPT1\" to \"LPT3\" for parallel printers, or
1689 \"COM1\" to \"COM4\" or \"AUX\" for serial printers, or \"\\\\hostname\\printer\"
1690 for a shared network printer. You can also set it to a name of a file, in
1691 which case the output gets appended to that file. \(Note that `ps-print'
1692 package already has facilities for printing to a file, so you might as well use
1693 them instead of changing the setting of this variable.\) If you want to
1694 silently discard the printed output, set this to \"NUL\".
1696 Set to t, if the utility given by `ps-lpr-command' needs an empty printer name.
1698 Any other value is treated as t, that is, an empty printer name.
1700 See also `ps-printer-name-option' for documentation."
1701 :type '(choice :menu-tag "Printer Name"
1703 (const :tag "Same as printer-name" nil)
1704 (const :tag "No Printer Name" t)
1705 (file :tag "Print to file")
1706 (string :tag "Pipe to ps-lpr-command"))
1708 :group 'ps-print-printer)
1710 (defcustom ps-printer-name-option
1711 (cond (ps-windows-system
1717 "*Option for `ps-printer-name' variable (see it).
1719 On Unix-like systems, if `lpr' is in use, this should be the string
1720 \"-P\"; if `lp' is in use, this should be the string \"-d\".
1722 On MS-DOS and MS-Windows systems, if `print' is in use, this should be
1725 For any other printing utility, see its documentation.
1727 Set this to \"\" or nil, if the utility given by `ps-lpr-command'
1728 needs an empty printer name option--that is, pass the printer name
1729 with no special option preceding it.
1731 Any value that is not a string is treated as nil.
1733 This variable is used only when `ps-printer-name' is a non-empty string."
1734 :type '(choice :menu-tag "Printer Name Option"
1735 :tag "Printer Name Option"
1736 (const :tag "None" nil)
1737 (string :tag "Option"))
1739 :group 'ps-print-printer)
1741 (defcustom ps-lpr-command lpr-command
1742 "*Name of program for printing a PostScript file.
1744 On MS-DOS and MS-Windows systems, if the value is an empty string then Emacs
1745 will write directly to the printer port named by `ps-printer-name'. The
1746 programs `print' and `nprint' (the standard print programs on Windows NT and
1747 Novell Netware respectively) are handled specially, using `ps-printer-name' as
1748 the destination for output; any other program is treated like `lpr' except that
1749 an explicit filename is given as the last argument."
1752 :group 'ps-print-printer)
1754 (defcustom ps-lpr-switches lpr-switches
1755 "*A list of extra switches to pass to `ps-lpr-command'."
1756 :type '(repeat :tag "PostScript lpr Switches"
1757 (choice :menu-tag "PostScript lpr Switch"
1758 :tag "PostScript lpr Switch"
1759 string symbol (repeat sexp)))
1761 :group 'ps-print-printer)
1763 (defcustom ps-print-region-function nil
1764 "*Specify a function to print the region on a PostScript printer.
1765 See definition of `call-process-region' for calling conventions. The fourth
1766 and the sixth arguments are both nil."
1767 :type '(choice (const nil) function)
1769 :group 'ps-print-printer)
1771 (defcustom ps-manual-feed nil
1772 "*Non-nil means the printer will manually feed paper.
1774 If it's nil, automatic feeding takes place."
1777 :group 'ps-print-printer)
1779 (defcustom ps-end-with-control-d (and ps-windows-system t)
1780 "*Non-nil means insert C-d at end of PostScript file generated."
1784 :group 'ps-print-printer)
1788 ;; All page dimensions are in PostScript points.
1789 ;; 1 inch == 2.54 cm == 72 points
1790 ;; 1 cm == (/ 1 2.54) inch == (/ 72 2.54) points
1792 ;; Letter 8.5 inch x 11.0 inch
1793 ;; Legal 8.5 inch x 14.0 inch
1794 ;; A4 8.26 inch x 11.69 inch = 21.0 cm x 29.7 cm
1796 ;; LetterSmall 7.68 inch x 10.16 inch
1797 ;; Tabloid 11.0 inch x 17.0 inch
1798 ;; Ledger 17.0 inch x 11.0 inch
1799 ;; Statement 5.5 inch x 8.5 inch
1800 ;; Executive 7.5 inch x 10.0 inch
1801 ;; A3 11.69 inch x 16.5 inch = 29.7 cm x 42.0 cm
1802 ;; A4Small 7.47 inch x 10.85 inch
1803 ;; B4 10.125 inch x 14.33 inch
1804 ;; B5 7.16 inch x 10.125 inch
1807 (defcustom ps-page-dimensions-database
1808 (list (list 'a4 (/ (* 72 21.0) 2.54) (/ (* 72 29.7) 2.54) "A4")
1809 (list 'a3 (/ (* 72 29.7) 2.54) (/ (* 72 42.0) 2.54) "A3")
1810 (list 'letter (* 72 8.5) (* 72 11.0) "Letter")
1811 (list 'legal (* 72 8.5) (* 72 14.0) "Legal")
1812 (list 'letter-small (* 72 7.68) (* 72 10.16) "LetterSmall")
1813 (list 'tabloid (* 72 11.0) (* 72 17.0) "Tabloid")
1814 (list 'ledger (* 72 17.0) (* 72 11.0) "Ledger")
1815 (list 'statement (* 72 5.5) (* 72 8.5) "Statement")
1816 (list 'executive (* 72 7.5) (* 72 10.0) "Executive")
1817 (list 'a4small (* 72 7.47) (* 72 10.85) "A4Small")
1818 (list 'b4 (* 72 10.125) (* 72 14.33) "B4")
1819 (list 'b5 (* 72 7.16) (* 72 10.125) "B5"))
1820 "*List associating a symbolic paper type to its width, height and doc media.
1821 See `ps-paper-type'."
1822 :type '(repeat (list :tag "Paper Type"
1823 (symbol :tag "Name")
1824 (number :tag "Width")
1825 (number :tag "Height")
1826 (string :tag "Media")))
1828 :group 'ps-print-page)
1831 (defcustom ps-paper-type 'letter
1832 "*Specify the size of paper to format for.
1833 Should be one of the paper types defined in `ps-page-dimensions-database', for
1834 example `letter', `legal' or `a4'."
1835 :type '(symbol :validate (lambda (wid)
1836 (if (assq (widget-value wid)
1837 ps-page-dimensions-database)
1839 (widget-put wid :error "Unknown paper size")
1842 :group 'ps-print-page)
1844 (defcustom ps-warn-paper-type t
1845 "*Non-nil means give an error if paper size is not equal to `ps-paper-type'.
1847 It's used when `ps-spool-config' is set to `setpagedevice'."
1850 :group 'ps-print-page)
1852 (defcustom ps-landscape-mode nil
1853 "*Non-nil means print in landscape mode."
1856 :group 'ps-print-page)
1858 (defcustom ps-print-upside-down nil
1859 "*Non-nil means print upside-down (that is, rotated by 180 degrees)."
1862 :group 'ps-print-page)
1864 (defcustom ps-selected-pages nil
1865 "*Specify which pages to print.
1867 If nil, print all pages.
1869 If a list, the lists element may be an integer or a cons cell (FROM . TO)
1870 designating FROM page to TO page; any invalid element is ignored, that is, an
1871 integer lesser than one or if FROM is greater than TO.
1873 Otherwise, it's treated as nil.
1875 After ps-print processing `ps-selected-pages' is set to nil. But the
1876 latest `ps-selected-pages' is saved in `ps-last-selected-pages' (which
1877 see). So you can restore the latest selected pages by using
1878 `ps-last-selected-pages' or with the `ps-restore-selected-pages'
1879 command (which see).
1881 See also `ps-even-or-odd-pages'."
1882 :type '(repeat :tag "Selected Pages"
1884 (integer :tag "Number")
1886 (integer :tag "From")
1887 (integer :tag "To"))))
1889 :group 'ps-print-page)
1891 (defcustom ps-even-or-odd-pages nil
1892 "*Specify if it prints even/odd pages.
1896 nil print all pages.
1898 `even-page' print only even pages.
1900 `odd-page' print only odd pages.
1902 `even-sheet' print only even sheets.
1903 That is, if `ps-n-up-printing' is 1, it behaves as `even-page';
1904 but for values greater than 1, it'll print only the even sheet
1907 `odd-sheet' print only odd sheets.
1908 That is, if `ps-n-up-printing' is 1, it behaves as `odd-page';
1909 but for values greater than 1, it'll print only the odd sheet
1912 Any other value is treated as nil.
1914 If you set `ps-selected-pages' (see it for documentation), first the pages are
1915 filtered by `ps-selected-pages' and then by `ps-even-or-odd-pages'. For
1916 example, if we have:
1918 (setq ps-selected-pages '(1 4 (6 . 10) (12 . 16) 20))
1920 Combining with `ps-even-or-odd-pages' and `ps-n-up-printing', we have:
1922 `ps-n-up-printing' = 1:
1923 `ps-even-or-odd-pages' PAGES PRINTED
1924 nil 1, 4, 6, 7, 8, 9, 10, 12, 13, 14, 15, 16, 20
1925 even-page 4, 6, 8, 10, 12, 14, 16, 20
1926 odd-page 1, 7, 9, 13, 15
1927 even-sheet 4, 6, 8, 10, 12, 14, 16, 20
1928 odd-sheet 1, 7, 9, 13, 15
1930 `ps-n-up-printing' = 2:
1931 `ps-even-or-odd-pages' PAGES PRINTED
1932 nil 1/4, 6/7, 8/9, 10/12, 13/14, 15/16, 20
1933 even-page 4/6, 8/10, 12/14, 16/20
1934 odd-page 1/7, 9/13, 15
1935 even-sheet 6/7, 10/12, 15/16
1936 odd-sheet 1/4, 8/9, 13/14, 20
1938 So even-page/odd-page are about page parity and even-sheet/odd-sheet are about
1940 :type '(choice :menu-tag "Print Even/Odd Pages"
1941 :tag "Print Even/Odd Pages"
1942 (const :tag "All Pages" nil)
1943 (const :tag "Only Even Pages" even-page)
1944 (const :tag "Only Odd Pages" odd-page)
1945 (const :tag "Only Even Sheets" even-sheet)
1946 (const :tag "Only Odd Sheets" odd-sheet))
1948 :group 'ps-print-page)
1950 (defcustom ps-print-control-characters 'control-8-bit
1951 "*Specify the printable form for control and 8-bit characters.
1952 That is, instead of sending, for example, a ^D (\\004) to printer,
1953 it is sent the string \"^D\".
1957 `8-bit' This is the value to use when you want an ASCII encoding of
1958 any control or non-ASCII character. Control characters are
1959 encoded as \"^D\", and non-ASCII characters have an
1962 `control-8-bit' This is the value to use when you want an ASCII encoding of
1963 any control character, whether it is 7 or 8-bit.
1964 European 8-bits accented characters are printed according
1967 `control' Only ASCII control characters have an ASCII encoding.
1968 European 8-bits accented characters are printed according
1971 nil No ASCII encoding. Any character is printed according the
1974 Any other value is treated as nil."
1975 :type '(choice :menu-tag "Control Char"
1977 (const 8-bit) (const control-8-bit)
1978 (const control) (const :tag "nil" nil))
1980 :group 'ps-print-miscellany)
1982 (defcustom ps-n-up-printing 1
1983 "*Specify the number of pages per sheet paper."
1985 :tag "N Up Printing"
1988 (if (and (< 0 (widget-value wid))
1989 (<= (widget-value wid) 100))
1993 "Number of pages per sheet paper must be between 1 and 100.")
1996 :group 'ps-print-n-up)
1998 (defcustom ps-n-up-margin (/ (* 72 1.0) 2.54) ; 1 cm
1999 "*Specify the margin in points between the sheet border and n-up printing."
2002 :group 'ps-print-n-up)
2004 (defcustom ps-n-up-border-p t
2005 "*Non-nil means a border is drawn around each page."
2008 :group 'ps-print-n-up)
2010 (defcustom ps-n-up-filling 'left-top
2011 "*Specify how page matrix is filled on each sheet of paper.
2013 Following are the valid values for `ps-n-up-filling' with a filling example
2014 using a 3x4 page matrix:
2016 `left-top' 1 2 3 4 `left-bottom' 9 10 11 12
2020 `right-top' 4 3 2 1 `right-bottom' 12 11 10 9
2024 `top-left' 1 4 7 10 `bottom-left' 3 6 9 12
2028 `top-right' 10 7 4 1 `bottom-right' 12 9 6 3
2032 Any other value is treated as `left-top'."
2033 :type '(choice :menu-tag "N-Up Filling"
2035 (const left-top) (const left-bottom)
2036 (const right-top) (const right-bottom)
2037 (const top-left) (const bottom-left)
2038 (const top-right) (const bottom-right))
2040 :group 'ps-print-n-up)
2042 (defcustom ps-number-of-columns (if ps-landscape-mode 2 1)
2043 "*Specify the number of columns."
2046 :group 'ps-print-miscellany)
2048 (defcustom ps-zebra-stripes nil
2049 "*Non-nil means print zebra stripes.
2050 See also documentation for `ps-zebra-stripe-height' and `ps-zebra-color'."
2053 :group 'ps-print-zebra)
2055 (defcustom ps-zebra-stripe-height 3
2056 "*Number of zebra stripe lines.
2057 See also documentation for `ps-zebra-stripes' and `ps-zebra-color'."
2060 :group 'ps-print-zebra)
2062 (defcustom ps-zebra-color 0.95
2063 "*Zebra stripe gray scale or RGB color.
2064 See also documentation for `ps-zebra-stripes' and `ps-zebra-stripe-height'."
2065 :type '(choice :menu-tag "Zebra Gray/Color"
2066 :tag "Zebra Gray/Color"
2067 (number :tag "Gray Scale" :value 0.95)
2068 (string :tag "Color Name" :value "gray95")
2069 (list :tag "RGB Color" :value (0.95 0.95 0.95)
2071 (number :tag "Green")
2072 (number :tag "Blue")))
2074 :group 'ps-print-zebra)
2076 (defcustom ps-zebra-stripe-follow nil
2077 "*Specify how zebra stripes continue on next page.
2079 Visually, valid values are (the character `+' at right of each column indicates
2080 that a line is printed):
2082 `nil' `follow' `full' `full-follow'
2083 Current Page -------- ----------- --------- ----------------
2084 1 XXXXX + 1 XXXXXXXX + 1 XXXXXX + 1 XXXXXXXXXXXXX +
2085 2 XXXXX + 2 XXXXXXXX + 2 XXXXXX + 2 XXXXXXXXXXXXX +
2086 3 XXXXX + 3 XXXXXXXX + 3 XXXXXX + 3 XXXXXXXXXXXXX +
2090 7 XXXXX + 7 XXXXXXXX + 7 XXXXXX + 7 XXXXXXXXXXXXX +
2091 8 XXXXX + 8 XXXXXXXX + 8 XXXXXX + 8 XXXXXXXXXXXXX +
2092 9 XXXXX + 9 XXXXXXXX + 9 XXXXXX + 9 XXXXXXXXXXXXX +
2095 -------- ----------- --------- ----------------
2096 Next Page -------- ----------- --------- ----------------
2097 12 XXXXX + 12 + 10 XXXXXX + 10 +
2098 13 XXXXX + 13 XXXXXXXX + 11 XXXXXX + 11 +
2099 14 XXXXX + 14 XXXXXXXX + 12 XXXXXX + 12 +
2100 15 + 15 XXXXXXXX + 13 + 13 XXXXXXXXXXXXX +
2101 16 + 16 + 14 + 14 XXXXXXXXXXXXX +
2102 17 + 17 + 15 + 15 XXXXXXXXXXXXX +
2103 18 XXXXX + 18 + 16 XXXXXX + 16 +
2104 19 XXXXX + 19 XXXXXXXX + 17 XXXXXX + 17 +
2105 20 XXXXX + 20 XXXXXXXX + 18 XXXXXX + 18 +
2108 -------- ----------- --------- ----------------
2110 Any other value is treated as nil."
2111 :type '(choice :menu-tag "Zebra Stripe Follow"
2112 :tag "Zebra Stripe Follow"
2113 (const :tag "Always Restart" nil)
2114 (const :tag "Continue on Next Page" follow)
2115 (const :tag "Print Only Full Stripe" full)
2116 (const :tag "Continue on Full Stripe" full-follow))
2118 :group 'ps-print-zebra)
2120 (defcustom ps-line-number nil
2121 "*Non-nil means print line number."
2124 :group 'ps-print-miscellany)
2126 (defcustom ps-line-number-step 1
2127 "*Specify the interval that line number is printed.
2129 For example, `ps-line-number-step' is set to 2, the printing will look like:
2141 integer an integer that specifies the interval that line number is
2142 printed. If it's lesser than or equal to zero, it's used the
2145 `zebra' specifies that only the line number of the first line in a
2146 zebra stripe is to be printed.
2148 Any other value is treated as `zebra'."
2149 :type '(choice :menu-tag "Line Number Step"
2150 :tag "Line Number Step"
2151 (integer :tag "Step Interval")
2152 (const :tag "Synchronize Zebra" zebra))
2154 :group 'ps-print-miscellany)
2156 (defcustom ps-line-number-start 1
2157 "*Specify the starting point in the interval given by `ps-line-number-step'.
2159 For example, if `ps-line-number-step' is set to 3 and `ps-line-number-start' is
2160 set to 3, the printing will look like:
2174 The values for `ps-line-number-start':
2176 * If `ps-line-number-step' is an integer, must be between 1 and the value of
2177 `ps-line-number-step' inclusive.
2179 * If `ps-line-number-step' is set to `zebra', must be between 1 and the
2180 value of `ps-zebra-strip-height' inclusive. Use this combination if you
2181 wish that line number be relative to zebra stripes."
2182 :type '(integer :tag "Start Step Interval")
2184 :group 'ps-print-miscellany)
2186 (defcustom ps-print-background-image nil
2187 "*EPS image list to be printed on background.
2191 (FILENAME X Y XSCALE YSCALE ROTATION PAGES...)
2193 FILENAME is a file name which contains an EPS image or some PostScript
2194 programming like EPS.
2195 FILENAME is ignored, if it doesn't exist or is read protected.
2197 X and Y are relative positions on paper to put the image.
2198 If X and Y are nil, the image is centered on paper.
2200 XSCALE and YSCALE are scale factor to be applied to image before printing.
2201 If XSCALE and YSCALE are nil, the original size is used.
2203 ROTATION is the image rotation angle; if nil, the default is 0.
2205 PAGES designates the page to print background image.
2206 PAGES may be a number or a cons cell (FROM . TO) designating FROM page to TO
2208 If PAGES is nil, print background image on all pages.
2210 X, Y, XSCALE, YSCALE and ROTATION may be a floating point number, an integer
2211 number or a string. If it is a string, the string should contain PostScript
2212 programming that returns a float or integer value.
2214 For example, if you wish to print an EPS image on all pages do:
2216 '((\"~/images/EPS-image.ps\"))"
2219 (file :tag "EPS File")
2220 (choice :tag "X" (const :tag "default" nil) number string)
2221 (choice :tag "Y" (const :tag "default" nil) number string)
2222 (choice :tag "X Scale" (const :tag "default" nil) number string)
2223 (choice :tag "Y Scale" (const :tag "default" nil) number string)
2224 (choice :tag "Rotation" (const :tag "default" nil) number string)
2225 (repeat :tag "Pages" :inline t
2226 (radio (integer :tag "Page")
2228 (integer :tag "From")
2229 (integer :tag "To"))))))
2231 :group 'ps-print-background)
2233 (defcustom ps-print-background-text nil
2234 "*Text list to be printed on background.
2238 (STRING X Y FONT FONTSIZE GRAY ROTATION PAGES...)
2240 STRING is the text to be printed on background.
2242 X and Y are positions on paper to put the text.
2243 If X and Y are nil, the text is positioned at lower left corner.
2245 FONT is a font name to be used on printing the text.
2246 If nil, \"Times-Roman\" is used.
2248 FONTSIZE is font size to be used, if nil, 200 is used.
2250 GRAY is the text gray factor (should be very light like 0.8).
2251 If nil, the default is 0.85.
2253 ROTATION is the text rotation angle; if nil, the angle is given by the diagonal
2254 from lower left corner to upper right corner.
2256 PAGES designates the page to print background text.
2257 PAGES may be a number or a cons cell (FROM . TO) designating FROM page to TO
2259 If PAGES is nil, print background text on all pages.
2261 X, Y, FONTSIZE, GRAY and ROTATION may be a floating point number, an integer
2262 number or a string. If it is a string, the string should contain PostScript
2263 programming that returns a float or integer value.
2265 For example, if you wish to print text \"Preliminary\" on all pages do:
2267 '((\"Preliminary\"))"
2270 (string :tag "Text")
2271 (choice :tag "X" (const :tag "default" nil) number string)
2272 (choice :tag "Y" (const :tag "default" nil) number string)
2273 (choice :tag "Font" (const :tag "default" nil) string)
2274 (choice :tag "Fontsize" (const :tag "default" nil) number string)
2275 (choice :tag "Gray" (const :tag "default" nil) number string)
2276 (choice :tag "Rotation" (const :tag "default" nil) number string)
2277 (repeat :tag "Pages" :inline t
2278 (radio (integer :tag "Page")
2280 (integer :tag "From")
2281 (integer :tag "To"))))))
2283 :group 'ps-print-background)
2285 ;;; Horizontal layout
2287 ;; ------------------------------------------
2289 ;; | lm | text | ic | text | ic | text | rm |
2291 ;; ------------------------------------------
2293 (defcustom ps-left-margin (/ (* 72 2.0) 2.54) ; 2 cm
2294 "*Left margin in points (1/72 inch)."
2297 :group 'ps-print-horizontal)
2299 (defcustom ps-right-margin (/ (* 72 2.0) 2.54) ; 2 cm
2300 "*Right margin in points (1/72 inch)."
2303 :group 'ps-print-horizontal)
2305 (defcustom ps-inter-column (/ (* 72 2.0) 2.54) ; 2 cm
2306 "*Horizontal space between columns in points (1/72 inch)."
2309 :group 'ps-print-horizontal)
2325 (defcustom ps-bottom-margin (/ (* 72 1.5) 2.54) ; 1.5 cm
2326 "*Bottom margin in points (1/72 inch)."
2329 :group 'ps-print-vertical)
2331 (defcustom ps-top-margin (/ (* 72 1.5) 2.54) ; 1.5 cm
2332 "*Top margin in points (1/72 inch)."
2335 :group 'ps-print-vertical)
2337 (defcustom ps-header-offset (/ (* 72 1.0) 2.54) ; 1.0 cm
2338 "*Vertical space in points (1/72 inch) between the main text and the header."
2341 :group 'ps-print-vertical)
2343 (defcustom ps-header-line-pad 0.15
2344 "*Portion of a header title line height to insert.
2345 The insertion is done between the header frame and the text it contains,
2346 both in the vertical and horizontal directions."
2349 :group 'ps-print-vertical)
2351 (defcustom ps-footer-offset (/ (* 72 1.0) 2.54) ; 1.0 cm
2352 "*Vertical space in points (1/72 inch) between the main text and the footer."
2355 :group 'ps-print-vertical)
2357 (defcustom ps-footer-line-pad 0.15
2358 "*Portion of a footer title line height to insert.
2359 The insertion is done between the footer frame and the text it contains,
2360 both in the vertical and horizontal directions."
2363 :group 'ps-print-vertical)
2365 ;;; Header/Footer setup
2367 (defcustom ps-print-header t
2368 "*Non-nil means print a header at the top of each page.
2369 By default, the header displays the buffer name, page number, and, if the
2370 buffer is visiting a file, the file's directory. Headers are customizable by
2371 changing variables `ps-left-header' and `ps-right-header'."
2374 :group 'ps-print-headers)
2376 (defcustom ps-print-header-frame t
2377 "*Non-nil means draw a gaudy frame around the header."
2380 :group 'ps-print-headers)
2382 (defcustom ps-header-frame-alist
2383 '((fore-color . 0.0)
2385 (border-width . 0.4)
2386 (border-color . 0.0)
2387 (shadow-color . 0.0))
2388 "*Specify header frame properties alist.
2390 Valid frame properties are:
2392 `fore-color' Specify the foreground frame color.
2393 It should be a float number between 0.0 (black color)
2394 and 1.0 (white color), a string which is a color name,
2395 or a list of 3 float numbers which corresponds to the
2396 Red Green Blue color scale, each float number between
2397 0.0 (dark color) and 1.0 (bright color).
2399 `back-color' Specify the background frame color (similar to
2402 `shadow-color' Specify the shadow color (similar to `fore-color').
2404 `border-color' Specify the border color (similar to `fore-color').
2406 `border-width' Specify the border width.
2408 Any other property is ignored.
2410 Don't change this alist directly, instead use customization, or `ps-value',
2411 `ps-get', `ps-put' and `ps-del' functions (see them for documentation)."
2414 (choice :menu-tag "Header Frame Element"
2416 (cons :tag "Foreground Color" :format "%v"
2417 (const :format "" fore-color)
2418 (choice :menu-tag "Foreground Color"
2419 :tag "Foreground Color"
2420 (number :tag "Gray Scale" :value 0.0)
2421 (string :tag "Color Name" :value "black")
2422 (list :tag "RGB Color" :value (0.0 0.0 0.0)
2424 (number :tag "Green")
2425 (number :tag "Blue"))))
2426 (cons :tag "Background Color" :format "%v"
2427 (const :format "" back-color)
2428 (choice :menu-tag "Background Color"
2429 :tag "Background Color"
2430 (number :tag "Gray Scale" :value 0.9)
2431 (string :tag "Color Name" :value "gray90")
2432 (list :tag "RGB Color" :value (0.9 0.9 0.9)
2434 (number :tag "Green")
2435 (number :tag "Blue"))))
2436 (cons :tag "Border Width" :format "%v"
2437 (const :format "" border-width)
2438 (number :tag "Border Width" :value 0.4))
2439 (cons :tag "Border Color" :format "%v"
2440 (const :format "" border-color)
2441 (choice :menu-tag "Border Color"
2443 (number :tag "Gray Scale" :value 0.0)
2444 (string :tag "Color Name" :value "black")
2445 (list :tag "RGB Color" :value (0.0 0.0 0.0)
2447 (number :tag "Green")
2448 (number :tag "Blue"))))
2449 (cons :tag "Shadow Color" :format "%v"
2450 (const :format "" shadow-color)
2451 (choice :menu-tag "Shadow Color"
2453 (number :tag "Gray Scale" :value 0.0)
2454 (string :tag "Color Name" :value "black")
2455 (list :tag "RGB Color" :value (0.0 0.0 0.0)
2457 (number :tag "Green")
2458 (number :tag "Blue"))))))
2460 :group 'ps-print-headers)
2462 (defcustom ps-header-lines 2
2463 "*Number of lines to display in page header, when generating PostScript."
2466 :group 'ps-print-headers)
2468 (defcustom ps-print-footer nil
2469 "*Non-nil means print a footer at the bottom of each page.
2470 By default, the footer displays page number.
2471 Footers are customizable by changing variables `ps-left-footer' and
2475 :group 'ps-print-headers)
2477 (defcustom ps-print-footer-frame t
2478 "*Non-nil means draw a gaudy frame around the footer."
2481 :group 'ps-print-headers)
2483 (defcustom ps-footer-frame-alist
2484 '((fore-color . 0.0)
2486 (border-width . 0.4)
2487 (border-color . 0.0)
2488 (shadow-color . 0.0))
2489 "*Specify footer frame properties alist.
2491 Don't change this alist directly, instead use customization, or `ps-value',
2492 `ps-get', `ps-put' and `ps-del' functions (see them for documentation).
2494 See also `ps-header-frame-alist' for documentation."
2496 (choice :menu-tag "Header Frame Element"
2498 (cons :tag "Foreground Color" :format "%v"
2499 (const :format "" fore-color)
2500 (choice :menu-tag "Foreground Color"
2501 :tag "Foreground Color"
2502 (number :tag "Gray Scale" :value 0.0)
2503 (string :tag "Color Name" :value "black")
2504 (list :tag "RGB Color" :value (0.0 0.0 0.0)
2506 (number :tag "Green")
2507 (number :tag "Blue"))))
2508 (cons :tag "Background Color" :format "%v"
2509 (const :format "" back-color)
2510 (choice :menu-tag "Background Color"
2511 :tag "Background Color"
2512 (number :tag "Gray Scale" :value 0.9)
2513 (string :tag "Color Name" :value "gray90")
2514 (list :tag "RGB Color" :value (0.9 0.9 0.9)
2516 (number :tag "Green")
2517 (number :tag "Blue"))))
2518 (cons :tag "Border Width" :format "%v"
2519 (const :format "" border-width)
2520 (number :tag "Border Width" :value 0.4))
2521 (cons :tag "Border Color" :format "%v"
2522 (const :format "" border-color)
2523 (choice :menu-tag "Border Color"
2525 (number :tag "Gray Scale" :value 0.0)
2526 (string :tag "Color Name" :value "black")
2527 (list :tag "RGB Color" :value (0.0 0.0 0.0)
2529 (number :tag "Green")
2530 (number :tag "Blue"))))
2531 (cons :tag "Shadow Color" :format "%v"
2532 (const :format "" shadow-color)
2533 (choice :menu-tag "Shadow Color"
2535 (number :tag "Gray Scale" :value 0.0)
2536 (string :tag "Color Name" :value "black")
2537 (list :tag "RGB Color" :value (0.0 0.0 0.0)
2539 (number :tag "Green")
2540 (number :tag "Blue"))))))
2542 :group 'ps-print-headers)
2544 (defcustom ps-footer-lines 2
2545 "*Number of lines to display in page footer, when generating PostScript."
2548 :group 'ps-print-headers)
2550 (defcustom ps-print-only-one-header nil
2551 "*Non-nil means print only one header/footer at the top/bottom of each page.
2552 This is useful when printing more than one column, so it is possible to have
2553 only one header/footer over all columns or one header/footer per column.
2554 See also `ps-print-header' and `ps-print-footer'."
2557 :group 'ps-print-headers)
2559 (defcustom ps-switch-header 'duplex
2560 "*Specify if headers/footers are switched or not.
2564 nil Never switch headers/footers.
2566 t Always switch headers/footers.
2568 duplex Switch headers/footers only when duplexing is on, that is, when
2569 `ps-spool-duplex' is non-nil.
2571 Any other value is treated as t.
2573 See also `ps-print-header' and `ps-print-footer'."
2574 :type '(choice :menu-tag "Switch Header/Footer"
2575 :tag "Switch Header/Footer"
2576 (const :tag "Never Switch" nil)
2577 (const :tag "Always Switch" t)
2578 (const :tag "Switch When Duplexing" duplex))
2580 :group 'ps-print-headers)
2582 (defcustom ps-show-n-of-n t
2583 "*Non-nil means show page numbers as N/M, meaning page N of M.
2584 NOTE: page numbers are displayed as part of headers,
2585 see variable `ps-print-header'."
2588 :group 'ps-print-headers)
2590 (defcustom ps-spool-config
2591 (if ps-windows-system
2594 "*Specify who is responsible for setting duplex and page size.
2598 `lpr-switches' duplex and page size are configured by `ps-lpr-switches'.
2599 Don't forget to set `ps-lpr-switches' to select duplex
2600 printing for your printer.
2602 `setpagedevice' duplex and page size are configured by ps-print using the
2603 setpagedevice PostScript operator.
2605 nil duplex and page size are configured by ps-print *not* using
2606 the setpagedevice PostScript operator.
2608 Any other value is treated as nil.
2610 WARNING: The setpagedevice PostScript operator affects ghostview utility when
2611 viewing file generated using landscape. Also on some printers,
2612 setpagedevice affects zebra stripes; on other printers, setpagedevice
2613 affects the left margin.
2614 Besides all that, if your printer does not have the paper size
2615 specified by setpagedevice, your printing will be aborted.
2616 So, if you need to use setpagedevice, set `ps-spool-config' to
2617 `setpagedevice', generate a test file and send it to your printer; if
2618 the printed file isn't OK, set `ps-spool-config' to nil."
2619 :type '(choice :menu-tag "Spool Config"
2621 (const lpr-switches) (const setpagedevice)
2622 (const :tag "nil" nil))
2624 :group 'ps-print-headers)
2626 (defcustom ps-spool-duplex nil ; Not many people have duplex printers,
2627 ; so default to nil.
2628 "*Non-nil generates PostScript for a two-sided printer.
2629 For a duplex printer, the `ps-spool-*' and `ps-print-*' commands will insert
2630 blank pages as needed between print jobs so that the next buffer printed will
2631 start on the right page. Also, if headers are turned on, the headers will be
2632 reversed on duplex printers so that the page numbers fall to the left on
2633 even-numbered pages.
2635 See also `ps-spool-tumble'."
2638 :group 'ps-print-headers)
2640 (defcustom ps-spool-tumble nil
2641 "*Specify how the page images on opposite sides of a sheet are oriented.
2642 If `ps-spool-tumble' is nil, produces output suitable for binding on the left
2643 or right. If `ps-spool-tumble' is non-nil, produces output suitable for
2644 binding at the top or bottom.
2646 It has effect only when `ps-spool-duplex' is non-nil."
2649 :group 'ps-print-headers)
2653 (defcustom ps-font-info-database
2654 '((Courier ; the family key
2655 (fonts (normal . "Courier")
2656 (bold . "Courier-Bold")
2657 (italic . "Courier-Oblique")
2658 (bold-italic . "Courier-BoldOblique"))
2660 (line-height . 10.55)
2662 (avg-char-width . 6.0))
2663 (Helvetica ; the family key
2664 (fonts (normal . "Helvetica")
2665 (bold . "Helvetica-Bold")
2666 (italic . "Helvetica-Oblique")
2667 (bold-italic . "Helvetica-BoldOblique"))
2669 (line-height . 11.56)
2670 (space-width . 2.78)
2671 (avg-char-width . 5.09243))
2673 (fonts (normal . "Times-Roman")
2674 (bold . "Times-Bold")
2675 (italic . "Times-Italic")
2676 (bold-italic . "Times-BoldItalic"))
2678 (line-height . 11.0)
2680 (avg-char-width . 4.71432))
2682 (fonts (normal . "Palatino-Roman")
2683 (bold . "Palatino-Bold")
2684 (italic . "Palatino-Italic")
2685 (bold-italic . "Palatino-BoldItalic"))
2687 (line-height . 12.1)
2689 (avg-char-width . 5.08676))
2691 (fonts (normal . "Helvetica-Narrow")
2692 (bold . "Helvetica-Narrow-Bold")
2693 (italic . "Helvetica-Narrow-Oblique")
2694 (bold-italic . "Helvetica-Narrow-BoldOblique"))
2696 (line-height . 11.56)
2697 (space-width . 2.2796)
2698 (avg-char-width . 4.17579))
2700 (fonts (normal . "NewCenturySchlbk-Roman")
2701 (bold . "NewCenturySchlbk-Bold")
2702 (italic . "NewCenturySchlbk-Italic")
2703 (bold-italic . "NewCenturySchlbk-BoldItalic"))
2705 (line-height . 12.15)
2706 (space-width . 2.78)
2707 (avg-char-width . 5.31162))
2708 ;; got no bold for the next ones
2710 (fonts (normal . "AvantGarde-Book")
2711 (italic . "AvantGarde-BookOblique"))
2713 (line-height . 11.77)
2714 (space-width . 2.77)
2715 (avg-char-width . 5.45189))
2717 (fonts (normal . "AvantGarde-Demi")
2718 (italic . "AvantGarde-DemiOblique"))
2720 (line-height . 12.72)
2722 (avg-char-width . 5.51351))
2724 (fonts (normal . "Bookman-Demi")
2725 (italic . "Bookman-DemiItalic"))
2727 (line-height . 11.77)
2729 (avg-char-width . 6.05946))
2731 (fonts (normal . "Bookman-Light")
2732 (italic . "Bookman-LightItalic"))
2734 (line-height . 11.79)
2736 (avg-char-width . 5.67027))
2737 ;; got no bold and no italic for the next ones
2739 (fonts (normal . "Symbol"))
2741 (line-height . 13.03)
2743 (avg-char-width . 3.24324))
2745 (fonts (normal . "Zapf-Dingbats"))
2747 (line-height . 9.63)
2748 (space-width . 2.78)
2749 (avg-char-width . 2.78))
2750 (ZapfChancery-MediumItalic
2751 (fonts (normal . "ZapfChancery-MediumItalic"))
2753 (line-height . 11.45)
2755 (avg-char-width . 4.10811))
2756 ;; We keep this wrong entry name (but with correct font name) for
2757 ;; backward compatibility.
2758 (Zapf-Chancery-MediumItalic
2759 (fonts (normal . "ZapfChancery-MediumItalic"))
2761 (line-height . 11.45)
2763 (avg-char-width . 4.10811))
2765 "*Font info database.
2766 Each element comprises: font family (the key), name, bold, italic, bold-italic,
2767 reference size, line height, space width, average character width.
2768 To get the info for another specific font (say Helvetica), do the following:
2769 - create a new buffer
2770 - generate the PostScript image to a file (C-u M-x ps-print-buffer)
2771 - open this file and delete the leading `%' (which is the PostScript comment
2772 character) from the line
2773 `% 3 cm 20 cm moveto 10/Courier ReportFontInfo showpage'
2775 `3 cm 20 cm moveto 10/Helvetica ReportFontInfo showpage'
2776 - add the values to `ps-font-info-database'.
2777 You can get all the fonts of YOUR printer using `ReportAllFontInfo'.
2779 Note also that ps-print DOESN'T download any font to your printer, instead it
2780 uses the fonts resident in your printer."
2782 (list :tag "Font Definition"
2783 (symbol :tag "Font Family")
2785 (const :format "" fonts)
2786 (repeat :tag "Faces"
2787 (cons (choice :menu-tag "Font Weight/Slant"
2788 :tag "Font Weight/Slant"
2793 (symbol :tag "Face"))
2794 (string :tag "Font Name"))))
2796 (const :format "" size)
2797 (number :tag "Reference Size"))
2799 (const :format "" line-height)
2800 (number :tag "Line Height"))
2802 (const :format "" space-width)
2803 (number :tag "Space Width"))
2805 (const :format "" avg-char-width)
2806 (number :tag "Average Character Width"))))
2808 :group 'ps-print-font)
2810 (defcustom ps-font-family 'Courier
2811 "*Font family name for ordinary text, when generating PostScript."
2814 :group 'ps-print-font)
2816 (defcustom ps-font-size '(7 . 8.5)
2817 "*Font size, in points, for ordinary text, when generating PostScript.
2818 Either a float or a cons of floats (LANDSCAPE-SIZE . PORTRAIT-SIZE)."
2819 :type '(choice :menu-tag "Ordinary Text Font Size"
2820 :tag "Ordinary Text Font Size"
2821 (number :tag "Text Size")
2822 (cons :tag "Landscape/Portrait"
2823 (number :tag "Landscape Text Size")
2824 (number :tag "Portrait Text Size")))
2826 :group 'ps-print-font)
2828 (defcustom ps-header-font-family 'Helvetica
2829 "*Font family name for text in the header, when generating PostScript."
2832 :group 'ps-print-font)
2834 (defcustom ps-header-font-size '(10 . 12)
2835 "*Font size, in points, for text in the header, when generating PostScript.
2836 Either a float or a cons of floats (LANDSCAPE-SIZE . PORTRAIT-SIZE)."
2837 :type '(choice :menu-tag "Header Font Size"
2838 :tag "Header Font Size"
2839 (number :tag "Header Size")
2840 (cons :tag "Landscape/Portrait"
2841 (number :tag "Landscape Header Size")
2842 (number :tag "Portrait Header Size")))
2844 :group 'ps-print-font)
2846 (defcustom ps-header-title-font-size '(12 . 14)
2847 "*Font size, in points, for the top line of text in header, in PostScript.
2848 Either a float or a cons of floats (LANDSCAPE-SIZE . PORTRAIT-SIZE)."
2849 :type '(choice :menu-tag "Header Title Font Size"
2850 :tag "Header Title Font Size"
2851 (number :tag "Header Title Size")
2852 (cons :tag "Landscape/Portrait"
2853 (number :tag "Landscape Header Title Size")
2854 (number :tag "Portrait Header Title Size")))
2856 :group 'ps-print-font)
2858 (defcustom ps-footer-font-family 'Helvetica
2859 "*Font family name for text in the footer, when generating PostScript."
2862 :group 'ps-print-font)
2864 (defcustom ps-footer-font-size '(10 . 12)
2865 "*Font size, in points, for text in the footer, when generating PostScript.
2866 Either a float or a cons of floats (LANDSCAPE-SIZE . PORTRAIT-SIZE)."
2867 :type '(choice :menu-tag "Footer Font Size"
2868 :tag "Footer Font Size"
2869 (number :tag "Footer Size")
2870 (cons :tag "Landscape/Portrait"
2871 (number :tag "Landscape Footer Size")
2872 (number :tag "Portrait Footer Size")))
2874 :group 'ps-print-font)
2876 (defcustom ps-line-number-color "black"
2877 "*Specify color for line-number, when generating PostScript."
2878 :type '(choice :menu-tag "Line Number Color"
2879 :tag "Line Number Color"
2880 (number :tag "Gray Scale" :value 0)
2881 (string :tag "Color Name" :value "black")
2882 (list :tag "RGB Color" :value (0 0 0)
2884 (number :tag "Green")
2885 (number :tag "Blue")))
2887 :group 'ps-print-font
2888 :group 'ps-print-miscellany)
2890 (defcustom ps-line-number-font "Times-Italic"
2891 "*Font for line-number, when generating PostScript."
2894 :group 'ps-print-font
2895 :group 'ps-print-miscellany)
2897 (defcustom ps-line-number-font-size 6
2898 "*Font size, in points, for line number, when generating PostScript.
2899 Either a float or a cons of floats (LANDSCAPE-SIZE . PORTRAIT-SIZE)."
2900 :type '(choice :menu-tag "Line Number Font Size"
2901 :tag "Line Number Font Size"
2902 (number :tag "Font Size")
2903 (cons :tag "Landscape/Portrait"
2904 (number :tag "Landscape Font Size")
2905 (number :tag "Portrait Font Size")))
2907 :group 'ps-print-font
2908 :group 'ps-print-miscellany)
2912 ;; Printing color requires x-color-values.
2913 ;; XEmacs change: Need autoload for the "Options->Printing->Color Printing"
2916 (defcustom ps-print-color-p
2917 (or (fboundp 'x-color-values) ; Emacs
2918 (fboundp 'color-instance-rgb-components))
2920 "*Specify how buffer's text color is printed.
2924 nil Do not print colors.
2928 black-white Print colors on black/white printer.
2929 See also `ps-black-white-faces'.
2931 Any other value is treated as t."
2932 :type '(choice :menu-tag "Print Color"
2934 (const :tag "Do NOT Print Color" nil)
2935 (const :tag "Print Always Color" t)
2936 (const :tag "Print Black/White Color" black-white))
2938 :group 'ps-print-color)
2940 (defcustom ps-default-fg nil
2941 "*RGB values of the default foreground color.
2943 The `ps-default-fg' variable contains the default foreground color used by
2944 ps-print, that is, if there is a face in a text that doesn't have a foreground
2945 color, the `ps-default-fg' color should be used.
2949 t The foreground color of Emacs session will be used.
2951 frame-parameter The foreground-color frame parameter will be used.
2953 NUMBER It's a real value between 0.0 (black) and 1.0 (white) that
2954 indicate the gray color.
2956 COLOR-NAME It's a string which contains the color name. For example:
2959 LIST It's a list of RGB values, that is a list of three real values
2964 Where RED, GREEN and BLUE are reals between 0.0 (no color) and
2967 Any other value is ignored and black color will be used.
2969 This variable is used only when `ps-print-color-p' (which see) is neither nil
2971 :type '(choice :menu-tag "Default Foreground Gray/Color"
2972 :tag "Default Foreground Gray/Color"
2973 (const :tag "Session Foreground" t)
2974 (const :tag "Frame Foreground" frame-parameter)
2975 (number :tag "Gray Scale" :value 0.0)
2976 (string :tag "Color Name" :value "black")
2977 (list :tag "RGB Color" :value (0.0 0.0 0.0)
2979 (number :tag "Green")
2980 (number :tag "Blue")))
2982 :group 'ps-print-color)
2984 (defcustom ps-default-bg nil
2985 "*RGB values of the default background color.
2987 The `ps-default-bg' variable contains the default background color used by
2988 ps-print, that is, if there is a face in a text that doesn't have a background
2989 color, the `ps-default-bg' color should be used.
2993 t The background color of Emacs session will be used.
2995 frame-parameter The background-color frame parameter will be used.
2997 NUMBER It's a real value between 0.0 (black) and 1.0 (white) that
2998 indicate the gray color.
3000 COLOR-NAME It's a string which contains the color name. For example:
3003 LIST It's a list of RGB values, that is a list of three real values
3008 Where RED, GREEN and BLUE are reals between 0.0 (no color) and
3011 Any other value is ignored and white color will be used.
3013 This variable is used only when `ps-print-color-p' (which see) is neither nil
3016 See also `ps-use-face-background'."
3017 :type '(choice :menu-tag "Default Background Gray/Color"
3018 :tag "Default Background Gray/Color"
3019 (const :tag "Session Background" t)
3020 (const :tag "Frame Background" frame-parameter)
3021 (number :tag "Gray Scale" :value 1.0)
3022 (string :tag "Color Name" :value "white")
3023 (list :tag "RGB Color" :value (1.0 1.0 1.0)
3025 (number :tag "Green")
3026 (number :tag "Blue")))
3028 :group 'ps-print-color)
3030 (defcustom ps-fg-list nil
3031 "*Specify foreground color list.
3033 This list is used to chose a text foreground color which is different than the
3034 background color. It'll be used the first foreground color in `ps-fg-list'
3035 which is different from the background color.
3037 If this list is nil, the default foreground color is used. See
3040 The list element valid values are:
3042 NUMBER It's a real value between 0.0 (black) and 1.0 (white) that
3043 indicate the gray color.
3045 COLOR-NAME It's a string which contains the color name. For example:
3048 LIST It's a list of RGB values, that is a list of three real values
3053 Where RED, GREEN and BLUE are reals between 0.0 (no color) and
3056 Any other value is ignored and black color will be used.
3058 This variable is used only when `ps-fg-validate-p' (which see) is non-nil and
3059 when `ps-print-color-p' (which see) is neither nil nor black-white."
3061 (choice :menu-tag "Foreground Gray/Color"
3062 :tag "Foreground Gray/Color"
3063 (number :tag "Gray Scale" :value 0.0)
3064 (string :tag "Color Name" :value "black")
3065 (list :tag "RGB Color" :value (0.0 0.0 0.0)
3067 (number :tag "Green")
3068 (number :tag "Blue"))))
3070 :group 'ps-print-color)
3072 (defcustom ps-fg-validate-p t
3073 "*Non-nil means validate if foreground color is different than background.
3075 If text foreground and background colors are equals, no text will appear.
3077 See also `ps-fg-list'."
3080 :group 'ps-print-color)
3082 (defcustom ps-auto-font-detect t
3083 "*Non-nil means automatically detect bold/italic/underline face attributes.
3084 If nil, we rely solely on the lists `ps-bold-faces', `ps-italic-faces', and
3085 `ps-underlined-faces'."
3088 :group 'ps-print-font)
3090 (defcustom ps-black-white-faces
3091 '((font-lock-builtin-face "black" nil bold )
3092 (font-lock-comment-face "gray20" nil italic)
3093 (font-lock-constant-face "black" nil bold )
3094 (font-lock-function-name-face "black" nil bold )
3095 (font-lock-keyword-face "black" nil bold )
3096 (font-lock-string-face "black" nil italic)
3097 (font-lock-type-face "black" nil italic)
3098 (font-lock-variable-name-face "black" nil bold italic)
3099 (font-lock-warning-face "black" nil bold italic))
3100 "*Specify list of face attributes to print colors on black/white printers.
3102 The list elements are the same as defined on `ps-extend-face' (which see).
3104 This variable is used only when `ps-print-color-p' is set to `black-white'."
3107 (list :tag "Face Specification"
3108 (face :tag "Face Symbol")
3109 (choice :menu-tag "Foreground Color"
3110 :tag "Foreground Color"
3111 (const :tag "Black" nil)
3112 (string :tag "Color Name"))
3113 (choice :menu-tag "Background Color"
3114 :tag "Background Color"
3115 (const :tag "None" nil)
3116 (string :tag "Color Name"))
3118 (choice :menu-tag "Attribute"
3128 :group 'ps-print-face)
3130 (defcustom ps-bold-faces
3131 (unless ps-print-color-p
3132 '(font-lock-function-name-face
3133 font-lock-builtin-face
3134 font-lock-variable-name-face
3135 font-lock-keyword-face
3136 font-lock-warning-face))
3137 "*A list of the \(non-bold\) faces that should be printed in bold font.
3138 This applies to generating PostScript."
3139 :type '(repeat face)
3141 :group 'ps-print-face)
3143 (defcustom ps-italic-faces
3144 (unless ps-print-color-p
3145 '(font-lock-variable-name-face
3147 font-lock-string-face
3148 font-lock-comment-face
3149 font-lock-warning-face))
3150 "*A list of the \(non-italic\) faces that should be printed in italic font.
3151 This applies to generating PostScript."
3152 :type '(repeat face)
3154 :group 'ps-print-face)
3156 (defcustom ps-underlined-faces
3157 (unless ps-print-color-p
3158 '(font-lock-function-name-face
3159 font-lock-constant-face
3160 font-lock-warning-face))
3161 "*A list of the \(non-underlined\) faces that should be printed underlined.
3162 This applies to generating PostScript."
3163 :type '(repeat face)
3165 :group 'ps-print-face)
3167 (defcustom ps-use-face-background nil
3168 "*Specify if face background should be used.
3172 t always use face background color.
3173 nil never use face background color.
3174 (face...) list of faces whose background color will be used.
3176 Any other value will be treated as t."
3177 :type '(choice :menu-tag "Use Face Background"
3178 :tag "Use Face Background"
3179 (const :tag "Always Use Face Background" t)
3180 (const :tag "Never Use Face Background" nil)
3181 (repeat :menu-tag "Face Background List"
3182 :tag "Face Background List"
3185 :group 'ps-print-face)
3187 (defcustom ps-left-header
3188 (list 'ps-get-buffer-name 'ps-header-dirpart)
3189 "*The items to display (each on a line) on the left part of the page header.
3190 This applies to generating PostScript.
3192 The value should be a list of strings and symbols, each representing an entry
3193 in the PostScript array HeaderLinesLeft.
3195 Strings are inserted unchanged into the array; those representing
3196 PostScript string literals should be delimited with PostScript string
3197 delimiters '(' and ')'.
3199 For symbols with bound functions, the function is called and should return a
3200 string to be inserted into the array. For symbols with bound values, the value
3201 should be a string to be inserted into the array. In either case, function or
3202 variable, the string value has PostScript string delimiters added to it.
3204 If symbols are unbounded, they are silently ignored."
3205 :type '(repeat (choice :menu-tag "Left Header"
3209 :group 'ps-print-headers)
3211 (defcustom ps-right-header
3212 (list "/pagenumberstring load"
3213 'ps-time-stamp-locale-default 'ps-time-stamp-hh:mm:ss)
3214 "*The items to display (each on a line) on the right part of the page header.
3215 This applies to generating PostScript.
3217 See the variable `ps-left-header' for a description of the format of this
3220 There are the following basic functions implemented:
3222 `ps-time-stamp-locale-default' Return the locale's \"preferred\" date
3223 as, for example, \"06/18/01\".
3225 `ps-time-stamp-hh:mm:ss' Return time as \"17:28:31\".
3227 `ps-time-stamp-mon-dd-yyyy' Return date as \"Jun 18 2001\".
3229 `ps-time-stamp-yyyy-mm-dd' Return date as \"2001-06-18\" (ISO
3232 `ps-time-stamp-iso8601' Alias for `ps-time-stamp-yyyy-mm-dd'.
3234 You can also create your own time stamp function by using `format-time-string'
3236 :type '(repeat (choice :menu-tag "Right Header"
3240 :group 'ps-print-headers)
3242 (defcustom ps-left-footer
3243 (list 'ps-get-buffer-name 'ps-header-dirpart)
3244 "*The items to display (each on a line) on the left part of the page footer.
3245 This applies to generating PostScript.
3247 The value should be a list of strings and symbols, each representing an entry
3248 in the PostScript array FooterLinesLeft.
3250 Strings are inserted unchanged into the array; those representing PostScript
3251 string literals should be delimited with PostScript string delimiters '(' and
3254 For symbols with bound functions, the function is called and should return a
3255 string to be inserted into the array. For symbols with bound values, the value
3256 should be a string to be inserted into the array. In either case, function or
3257 variable, the string value has PostScript string delimiters added to it.
3259 If symbols are unbounded, they are silently ignored."
3260 :type '(repeat (choice :menu-tag "Left Footer"
3264 :group 'ps-print-headers)
3266 (defcustom ps-right-footer
3267 (list "/pagenumberstring load"
3268 'ps-time-stamp-locale-default 'ps-time-stamp-hh:mm:ss)
3269 "*The items to display (each on a line) on the right part of the page footer.
3270 This applies to generating PostScript.
3272 See the variable `ps-left-footer' for a description of the format of this
3275 There are the following basic functions implemented:
3277 `ps-time-stamp-locale-default' Return the locale's \"preferred\" date
3278 as, for example, \"06/18/01\".
3280 `ps-time-stamp-hh:mm:ss' Return time as \"17:28:31\".
3282 `ps-time-stamp-mon-dd-yyyy' Return date as \"Jun 18 2001\".
3284 `ps-time-stamp-yyyy-mm-dd' Return date as \"2001-06-18\" (ISO
3287 `ps-time-stamp-iso8601' Alias for `ps-time-stamp-yyyy-mm-dd'.
3289 You can also create your own time stamp function by using `format-time-string'
3291 :type '(repeat (choice :menu-tag "Right Footer"
3295 :group 'ps-print-headers)
3297 (defcustom ps-razzle-dazzle t
3298 "*Non-nil means report progress while formatting buffer."
3301 :group 'ps-print-miscellany)
3303 (defcustom ps-adobe-tag "%!PS-Adobe-3.0\n"
3304 "*Contains the header line identifying the output as PostScript.
3305 By default, `ps-adobe-tag' contains the standard identifier. Some printers
3306 require slightly different versions of this line."
3309 :group 'ps-print-miscellany)
3311 (defcustom ps-build-face-reference t
3312 "*Non-nil means build the reference face lists.
3314 ps-print sets this value to nil after it builds its internal reference lists of
3315 bold and italic faces. By setting its value back to t, you can force ps-print
3316 to rebuild the lists the next time you invoke one of the ...-with-faces
3319 You should set this value back to t after you change the attributes of any
3320 face, or create new faces. Most users shouldn't have to worry about its
3324 :group 'ps-print-face)
3326 (defcustom ps-always-build-face-reference nil
3327 "*Non-nil means always rebuild the reference face lists.
3329 If this variable is non-nil, ps-print will rebuild its internal reference lists
3330 of bold and italic faces *every* time one of the ...-with-faces commands is
3331 called. Most users shouldn't need to set this variable."
3334 :group 'ps-print-face)
3336 (defcustom ps-banner-page-when-duplexing nil
3337 "*Non-nil means the very first page is skipped.
3338 It's like the very first character of buffer (or region) is ^L (\\014)."
3341 :group 'ps-print-headers)
3343 (defcustom ps-postscript-code-directory
3344 (or (if (featurep 'xemacs)
3345 (cond ((fboundp 'locate-data-directory) ; XEmacs
3346 (funcall 'locate-data-directory "ps-print"))
3347 ((boundp 'data-directory) ; XEmacs
3348 (symbol-value 'data-directory))
3349 (t ; don't know what to do
3351 data-directory) ; Emacs
3352 (error "`ps-postscript-code-directory' isn't set properly"))
3353 "*Directory where it's located the PostScript prologue file used by ps-print.
3354 By default, this directory is the same as in the variable `data-directory'."
3357 :group 'ps-print-miscellany)
3359 (defcustom ps-line-spacing 0
3360 "*Specify line spacing, in points, for ordinary text.
3362 Either a float or a cons of floats (LANDSCAPE-SIZE . PORTRAIT-SIZE).
3364 See also `ps-paragraph-spacing' and `ps-paragraph-regexp'.
3366 To get all lines with some spacing set both `ps-line-spacing' and
3367 `ps-paragraph-spacing' variables."
3368 :type '(choice :menu-tag "Line Spacing For Ordinary Text"
3369 :tag "Line Spacing For Ordinary Text"
3370 (number :tag "Line Spacing")
3371 (cons :tag "Landscape/Portrait"
3372 (number :tag "Landscape Line Spacing")
3373 (number :tag "Portrait Line Spacing")))
3375 :group 'ps-print-miscellany)
3377 (defcustom ps-paragraph-spacing 0
3378 "*Specify paragraph spacing, in points, for ordinary text.
3380 Either a float or a cons of floats (LANDSCAPE-SIZE . PORTRAIT-SIZE).
3382 See also `ps-line-spacing' and `ps-paragraph-regexp'.
3384 To get all lines with some spacing set both `ps-line-spacing' and
3385 `ps-paragraph-spacing' variables."
3386 :type '(choice :menu-tag "Paragraph Spacing For Ordinary Text"
3387 :tag "Paragraph Spacing For Ordinary Text"
3388 (number :tag "Paragraph Spacing")
3389 (cons :tag "Landscape/Portrait"
3390 (number :tag "Landscape Paragraph Spacing")
3391 (number :tag "Portrait Paragraph Spacing")))
3393 :group 'ps-print-miscellany)
3395 (defcustom ps-paragraph-regexp "[ \t]*$"
3396 "*Specify paragraph delimiter.
3398 It should be a regexp or nil.
3400 See also `ps-paragraph-spacing'."
3401 :type '(choice :menu-tag "Paragraph Delimiter"
3402 (const :tag "No Delimiter" nil)
3403 (regexp :tag "Delimiter Regexp"))
3405 :group 'ps-print-miscellany)
3407 (defcustom ps-begin-cut-regexp nil
3408 "*Specify regexp which is start of a region to cut out when printing.
3410 As an example, variables `ps-begin-cut-regexp' and `ps-end-cut-regexp' may be
3411 set to \"^Local Variables:\" and \"^End:\", respectively, in order to leave out
3412 some special printing instructions from the actual print. Special printing
3413 instructions may be appended to the end of the file just like any other
3414 buffer-local variables. See section \"Local Variables in Files\" on Emacs
3415 manual for more information.
3417 Variables `ps-begin-cut-regexp' and `ps-end-cut-regexp' control together what
3418 actually gets printed. Both variables may be set to nil in which case no
3420 :type '(choice (const :tag "No Delimiter" nil)
3421 (regexp :tag "Delimiter Regexp"))
3423 :group 'ps-print-miscellany)
3425 (defcustom ps-end-cut-regexp nil
3426 "*Specify regexp which is end of the region to cut out when printing.
3428 See `ps-begin-cut-regexp' for more information."
3429 :type '(choice (const :tag "No Delimiter" nil)
3430 (regexp :tag "Delimiter Regexp"))
3432 :group 'ps-print-miscellany)
3435 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3439 (defvar ps-last-selected-pages nil
3440 "Latest `ps-selected-pages' value.")
3443 (defun ps-restore-selected-pages ()
3444 "Restore latest `ps-selected-pages' value."
3446 (setq ps-selected-pages ps-last-selected-pages))
3449 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3454 (defun ps-print-customize ()
3455 "Customization of ps-print group."
3457 (customize-group 'ps-print))
3460 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3465 (defun ps-print-buffer (&optional filename)
3466 "Generate and print a PostScript image of the buffer.
3468 Interactively, when you use a prefix argument (\\[universal-argument]), the command prompts the
3469 user for a file name, and saves the PostScript image in that file instead of
3470 sending it to the printer.
3472 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
3473 send the image to the printer. If FILENAME is a string, save the PostScript
3474 image in a file with that name."
3475 (interactive (list (ps-print-preprint current-prefix-arg)))
3476 (ps-print-without-faces (point-min) (point-max) filename))
3480 (defun ps-print-buffer-with-faces (&optional filename)
3481 "Generate and print a PostScript image of the buffer.
3482 Like `ps-print-buffer', but includes font, color, and underline information in
3483 the generated image. This command works only if you are using a window system,
3484 so it has a way to determine color values."
3485 (interactive (list (ps-print-preprint current-prefix-arg)))
3486 (ps-print-with-faces (point-min) (point-max) filename))
3490 (defun ps-print-region (from to &optional filename)
3491 "Generate and print a PostScript image of the region.
3492 Like `ps-print-buffer', but prints just the current region."
3493 (interactive (ps-print-preprint-region current-prefix-arg))
3494 (ps-print-without-faces from to filename t))
3498 (defun ps-print-region-with-faces (from to &optional filename)
3499 "Generate and print a PostScript image of the region.
3500 Like `ps-print-region', but includes font, color, and underline information in
3501 the generated image. This command works only if you are using a window system,
3502 so it has a way to determine color values."
3503 (interactive (ps-print-preprint-region current-prefix-arg))
3504 (ps-print-with-faces from to filename t))
3508 (defun ps-spool-buffer ()
3509 "Generate and spool a PostScript image of the buffer.
3510 Like `ps-print-buffer' except that the PostScript image is saved in a local
3511 buffer to be sent to the printer later.
3513 Use the command `ps-despool' to send the spooled images to the printer."
3515 (ps-spool-without-faces (point-min) (point-max)))
3519 (defun ps-spool-buffer-with-faces ()
3520 "Generate and spool a PostScript image of the buffer.
3521 Like `ps-spool-buffer', but includes font, color, and underline information in
3522 the generated image. This command works only if you are using a window system,
3523 so it has a way to determine color values.
3525 Use the command `ps-despool' to send the spooled images to the printer."
3527 (ps-spool-with-faces (point-min) (point-max)))
3531 (defun ps-spool-region (from to)
3532 "Generate a PostScript image of the region and spool locally.
3533 Like `ps-spool-buffer', but spools just the current region.
3535 Use the command `ps-despool' to send the spooled images to the printer."
3537 (ps-spool-without-faces from to t))
3541 (defun ps-spool-region-with-faces (from to)
3542 "Generate a PostScript image of the region and spool locally.
3543 Like `ps-spool-region', but includes font, color, and underline information in
3544 the generated image. This command works only if you are using a window system,
3545 so it has a way to determine color values.
3547 Use the command `ps-despool' to send the spooled images to the printer."
3549 (ps-spool-with-faces from to t))
3552 (defun ps-despool (&optional filename)
3553 "Send the spooled PostScript to the printer.
3555 Interactively, when you use a prefix argument (\\[universal-argument]), the command prompts the
3556 user for a file name, and saves the spooled PostScript image in that file
3557 instead of sending it to the printer.
3559 Noninteractively, the argument FILENAME is treated as follows: if it is nil,
3560 send the image to the printer. If FILENAME is a string, save the PostScript
3561 image in a file with that name."
3562 (interactive (list (ps-print-preprint current-prefix-arg)))
3563 (ps-do-despool filename))
3566 (defun ps-line-lengths ()
3567 "Display the correspondence between a line length and a font size.
3568 Done using the current ps-print setup.
3569 Try: pr -t file | awk '{printf \"%3d %s\n\", length($0), $0}' | sort -r | head"
3571 (ps-line-lengths-internal))
3574 (defun ps-nb-pages-buffer (nb-lines)
3575 "Display number of pages to print this buffer, for various font heights.
3576 The table depends on the current ps-print setup."
3577 (interactive (ps-count-lines-preprint (point-min) (point-max)))
3578 (ps-nb-pages nb-lines))
3581 (defun ps-nb-pages-region (nb-lines)
3582 "Display number of pages to print the region, for various font heights.
3583 The table depends on the current ps-print setup."
3584 (interactive (ps-count-lines-preprint (mark) (point)))
3585 (ps-nb-pages nb-lines))
3587 (defvar ps-prefix-quote nil
3588 "Used for `ps-print-quote' (which see).")
3592 "Return the current PostScript-generation setup."
3593 (let (ps-prefix-quote)
3597 (concat "\n;;; (" (if (featurep 'xemacs) "XEmacs" "Emacs")
3598 ") ps-print version " ps-print-version "\n")
3600 (ps-comment-string "emacs-version " emacs-version)
3601 (ps-comment-string "ps-windows-system " ps-windows-system)
3602 (ps-comment-string "ps-lp-system " ps-lp-system)
3604 '(25 . ps-print-color-p)
3605 '(25 . ps-lpr-command)
3606 '(25 . ps-lpr-switches)
3607 '(25 . ps-printer-name)
3608 '(25 . ps-printer-name-option)
3609 '(25 . ps-print-region-function)
3610 '(25 . ps-manual-feed)
3611 '(25 . ps-end-with-control-d)
3613 '(23 . ps-paper-type)
3614 '(23 . ps-warn-paper-type)
3615 '(23 . ps-landscape-mode)
3616 '(23 . ps-print-upside-down)
3617 '(23 . ps-number-of-columns)
3619 '(23 . ps-zebra-stripes)
3620 '(23 . ps-zebra-stripe-height)
3621 '(23 . ps-zebra-stripe-follow)
3622 '(23 . ps-zebra-color)
3623 '(23 . ps-line-number)
3624 '(23 . ps-line-number-step)
3625 '(23 . ps-line-number-start)
3627 '(17 . ps-razzle-dazzle)
3628 '(17 . ps-default-bg)
3629 '(17 . ps-default-fg)
3630 '(17 . ps-fg-validate-p)
3633 '(23 . ps-use-face-background)
3635 '(28 . ps-print-control-characters)
3637 '(26 . ps-print-background-image)
3639 '(25 . ps-print-background-text)
3641 '(29 . ps-error-handler-message)
3642 '(29 . ps-user-defined-prologue)
3643 '(29 . ps-print-prologue-header)
3644 '(29 . ps-postscript-code-directory)
3645 '(29 . ps-adobe-tag)
3647 '(30 . ps-left-margin)
3648 '(30 . ps-right-margin)
3649 '(30 . ps-inter-column)
3650 '(30 . ps-bottom-margin)
3651 '(30 . ps-top-margin)
3652 '(30 . ps-print-only-one-header)
3653 '(30 . ps-switch-header)
3654 '(30 . ps-print-header)
3655 '(30 . ps-header-lines)
3656 '(30 . ps-header-offset)
3657 '(30 . ps-header-line-pad)
3658 '(30 . ps-print-header-frame)
3659 '(30 . ps-header-frame-alist)
3660 '(30 . ps-print-footer)
3661 '(30 . ps-footer-lines)
3662 '(30 . ps-footer-offset)
3663 '(30 . ps-footer-line-pad)
3664 '(30 . ps-print-footer-frame)
3665 '(30 . ps-footer-frame-alist)
3666 '(30 . ps-show-n-of-n)
3667 '(30 . ps-spool-config)
3668 '(30 . ps-spool-duplex)
3669 '(30 . ps-spool-tumble)
3670 '(30 . ps-banner-page-when-duplexing)
3671 '(30 . ps-left-header)
3672 '(30 . ps-right-header)
3673 '(30 . ps-left-footer)
3674 '(30 . ps-right-footer)
3676 '(23 . ps-n-up-printing)
3677 '(23 . ps-n-up-margin)
3678 '(23 . ps-n-up-border-p)
3679 '(23 . ps-n-up-filling)
3681 '(26 . ps-multibyte-buffer)
3682 '(26 . ps-font-family)
3683 '(26 . ps-font-size)
3684 '(26 . ps-header-font-family)
3685 '(26 . ps-header-font-size)
3686 '(26 . ps-header-title-font-size)
3687 '(26 . ps-footer-font-family)
3688 '(26 . ps-footer-font-size)
3689 '(26 . ps-line-number-color)
3690 '(26 . ps-line-number-font)
3691 '(26 . ps-line-number-font-size)
3692 '(26 . ps-line-spacing)
3693 '(26 . ps-paragraph-spacing)
3694 '(26 . ps-paragraph-regexp)
3695 '(26 . ps-begin-cut-regexp)
3696 '(26 . ps-end-cut-regexp)
3698 '(23 . ps-even-or-odd-pages)
3699 '(23 . ps-selected-pages)
3700 '(23 . ps-last-selected-pages)
3702 '(31 . ps-build-face-reference)
3703 '(31 . ps-always-build-face-reference)
3705 '(20 . ps-auto-font-detect)
3706 '(20 . ps-bold-faces)
3707 '(20 . ps-italic-faces)
3708 '(20 . ps-underlined-faces)
3709 '(20 . ps-black-white-faces)
3711 \;; The following customized variables have long lists and are seldom modified:
3712 \;; ps-page-dimensions-database
3713 \;; ps-font-info-database
3715 \;;; ps-print - end of settings\n")
3719 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3720 ;; Utility functions and variables:
3723 (defun ps-print-quote (elt)
3724 "Quote ELT for printing (used for showing settings).
3726 If ELT is nil, return an empty string.
3727 If ELT is string, return it.
3728 Otherwise, ELT should be a cons (LEN . SYM) where SYM is a variable symbol and
3729 LEN is the field length where SYM name will be inserted. The variable
3730 `ps-prefix-quote' is used to form the string, if `ps-prefix-quote' is nil, it's
3731 used \"(setq \" as prefix; otherwise, it's used \" \". So, the string
3734 * If `ps-prefix-quote' is nil:
3735 \"(setq SYM-NAME SYM-VALUE\"
3739 * If `ps-prefix-quote' is non-nil:
3740 \" SYM-NAME SYM-VALUE\"
3744 If `ps-prefix-quote' is nil, it's set to t after generating string."
3747 ((and (consp elt) (integerp (car elt))
3748 (symbolp (cdr elt)) (boundp (cdr elt)))
3749 (let* ((col (car elt))
3751 (key (symbol-name sym))
3753 (val (symbol-value sym)))
3754 (concat (if ps-prefix-quote
3756 (setq ps-prefix-quote t)
3760 (make-string (- col len) ?\s)
3762 (ps-value-string val))))
3767 (defun ps-value-string (val)
3768 "Return a string representation of VAL. Used by `ps-print-quote'."
3773 ((or (symbolp val) (listp val))
3776 (format "%S" val))))
3779 (defun ps-comment-string (str value)
3780 "Return a comment string like \";; STR = VALUE\"."
3781 (format ";; %s = %s" str (ps-value-string value)))
3784 (defun ps-value (alist-sym key)
3785 "Return value from association list ALIST-SYM which car is `eq' to KEY."
3786 (cdr (assq key (symbol-value alist-sym))))
3789 (defun ps-get (alist-sym key)
3790 "Return element from association list ALIST-SYM which car is `eq' to KEY."
3791 (assq key (symbol-value alist-sym)))
3794 (defun ps-put (alist-sym key value)
3795 "Store element (KEY . VALUE) into association list ALIST-SYM.
3796 If KEY already exists in ALIST-SYM, modify cdr to VALUE.
3797 It can be retrieved with `(ps-get ALIST-SYM KEY)'."
3798 (let ((elt: (assq key (symbol-value alist-sym)))) ; to avoid name conflict
3801 (setq elt: (cons key value))
3802 (set alist-sym (cons elt: (symbol-value alist-sym))))
3806 (defun ps-del (alist-sym key)
3807 "Delete by side effect element KEY from association list ALIST-SYM."
3808 (let ((a:list: (symbol-value alist-sym)) ; to avoid name conflict
3811 (if (eq key (car (car a:list:)))
3814 (setcdr old (cdr a:list:))
3815 (set alist-sym (cdr a:list:)))
3818 a:list: (cdr a:list:)))))
3819 (symbol-value alist-sym))
3822 (defun ps-time-stamp-locale-default ()
3823 "Return the locale's \"preferred\" date as, for example, \"06/18/01\"."
3824 (format-time-string "%x"))
3827 (defun ps-time-stamp-mon-dd-yyyy ()
3828 "Return date as \"Jun 18 2001\"."
3829 (format-time-string "%b %d %Y"))
3832 (defun ps-time-stamp-yyyy-mm-dd ()
3833 "Return date as \"2001-06-18\" (ISO date)."
3834 (format-time-string "%Y-%m-%d"))
3837 ;; Alias for `ps-time-stamp-yyyy-mm-dd' (which see).
3838 (defalias 'ps-time-stamp-iso8601 'ps-time-stamp-yyyy-mm-dd)
3841 (defun ps-time-stamp-hh:mm:ss ()
3842 "Return time as \"17:28:31\"."
3843 (format-time-string "%T"))
3846 (defvar ps-print-color-scale 1.0)
3848 (defun ps-color-scale (color)
3849 ;; Scale 16-bit X-COLOR-VALUE to PostScript color value in [0, 1] interval.
3850 (mapcar #'(lambda (value) (/ value ps-print-color-scale))
3851 (ps-color-values color)))
3854 (defun ps-face-underlined-p (face)
3855 (or (face-underline-p face)
3856 (memq face ps-underlined-faces)))
3859 (defun ps-prologue-file (filenumber)
3860 "If prologue FILENUMBER exists and is readable, return contents as string.
3862 Note: No major/minor-mode is activated and no local variables are evaluated for
3863 FILENUMBER, but proper EOL-conversion and character interpretation is
3865 (let ((filename (convert-standard-filename
3866 (expand-file-name (format "ps-prin%d.ps" filenumber)
3867 ps-postscript-code-directory))))
3868 (if (and (file-exists-p filename)
3869 (file-readable-p filename))
3871 (insert-file-contents filename)
3873 (error "ps-print PostScript prologue `%s' file was not found"
3877 (defvar ps-mark-code-directory nil)
3879 (defvar ps-print-prologue-0 ""
3880 "ps-print PostScript error handler.")
3882 (defvar ps-print-prologue-1 ""
3883 "ps-print PostScript prologue.")
3885 ;; Start Editing Here:
3887 (defvar ps-source-buffer nil)
3888 (defvar ps-spool-buffer-name "*PostScript*")
3889 (defvar ps-spool-buffer nil)
3891 (defvar ps-output-head nil)
3892 (defvar ps-output-tail nil)
3894 (defvar ps-page-postscript 0) ; page number
3895 (defvar ps-page-order 0) ; PostScript page counter
3896 (defvar ps-page-sheet 0) ; sheet counter
3897 (defvar ps-page-column 0) ; column counter
3898 (defvar ps-page-printed 0) ; total pages printed
3899 (defvar ps-page-n-up 0) ; n-up counter
3900 (defvar ps-lines-printed 0) ; total lines printed
3901 (defvar ps-showline-count 1) ; line number counter
3902 (defvar ps-first-page nil)
3903 (defvar ps-last-page nil)
3904 (defvar ps-print-page-p t)
3906 (defvar ps-control-or-escape-regexp nil)
3907 (defvar ps-n-up-on nil)
3909 (defvar ps-background-pages nil)
3910 (defvar ps-background-all-pages nil)
3911 (defvar ps-background-text-count 0)
3912 (defvar ps-background-image-count 0)
3914 (defvar ps-current-font 0)
3915 (defvar ps-default-foreground nil)
3916 (defvar ps-default-background nil)
3917 (defvar ps-default-color nil)
3918 (defvar ps-current-color nil)
3919 (defvar ps-current-bg nil)
3920 (defvar ps-foreground-list nil)
3922 (defvar ps-zebra-stripe-full-p nil)
3923 (defvar ps-razchunk 0)
3925 (defvar ps-color-p nil)
3927 ;; These values determine how much print-height to deduct when headers/footers
3928 ;; are turned on. This is a pretty clumsy way of handling it, but it'll do for
3931 (defvar ps-header-pad 0
3932 "Vertical and horizontal space between the header frame and the text.
3933 This is in units of points (1/72 inch).")
3935 (defvar ps-footer-pad 0
3936 "Vertical and horizontal space between the footer frame and the text.
3937 This is in units of points (1/72 inch).")
3939 ;; Define accessors to the dimensions list.
3941 (defmacro ps-page-dimensions-get-width (dims) `(nth 0 ,dims))
3942 (defmacro ps-page-dimensions-get-height (dims) `(nth 1 ,dims))
3943 (defmacro ps-page-dimensions-get-media (dims) `(nth 2 ,dims))
3945 (defvar ps-landscape-page-height nil)
3947 (defvar ps-print-width nil)
3948 (defvar ps-print-height nil)
3950 (defvar ps-height-remaining nil)
3951 (defvar ps-width-remaining nil)
3953 (defvar ps-font-size-internal nil)
3954 (defvar ps-header-font-size-internal nil)
3955 (defvar ps-header-title-font-size-internal nil)
3956 (defvar ps-footer-font-size-internal nil)
3957 (defvar ps-line-spacing-internal nil)
3958 (defvar ps-paragraph-spacing-internal nil)
3961 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
3962 ;; Internal Variables
3965 (defvar ps-black-white-faces-alist nil
3966 "Alist of symbolic faces used for black/white PostScript printers.
3967 An element of this list has the same form as `ps-print-face-extension-alist'
3970 Don't change this list directly; instead,
3971 use `ps-extend-face' and `ps-extend-face-list'.
3972 See documentation for `ps-extend-face' for valid extension symbol.
3973 See also documentation for `ps-print-color-p'.")
3976 (defvar ps-print-face-extension-alist nil
3977 "Alist of symbolic faces *WITH* extension features (box, outline, etc).
3978 An element of this list has the following form:
3980 (FACE . [BITS FG BG])
3982 FACE is a symbol denoting a face name
3983 BITS is a bit vector, where each bit correspond
3984 to a feature (bold, underline, etc)
3985 (see documentation for `ps-print-face-map-alist')
3986 FG foreground color (string or nil)
3987 BG background color (string or nil)
3989 Don't change this list directly; instead,
3990 use `ps-extend-face' and `ps-extend-face-list'.
3991 See documentation for `ps-extend-face' for valid extension symbol.")
3994 (defvar ps-print-face-alist nil
3995 "Alist of symbolic faces *WITHOUT* extension features (box, outline, etc).
3997 An element of this list has the same form as an element of
3998 `ps-print-face-extension-alist'.
4000 Don't change this list directly; this list is used by `ps-face-attributes',
4001 `ps-map-face' and `ps-build-reference-face-lists'.")
4004 (defconst ps-print-face-map-alist
4013 "Alist of all features and the corresponding bit mask.
4014 Each symbol correspond to one bit in a bit vector.")
4017 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4022 (defun ps-extend-face-list (face-extension-list &optional merge-p alist-sym)
4023 "Extend face in ALIST-SYM.
4025 If optional MERGE-P is non-nil, extensions in FACE-EXTENSION-LIST are merged
4026 with face extension in ALIST-SYM; otherwise, overrides.
4028 If optional ALIST-SYM is nil, `ps-print-face-extension-alist' is used;
4029 otherwise, it should be an alist symbol.
4031 The elements in FACE-EXTENSION-LIST are like those for `ps-extend-face'.
4033 See `ps-extend-face' for documentation."
4034 (while face-extension-list
4035 (ps-extend-face (car face-extension-list) merge-p alist-sym)
4036 (setq face-extension-list (cdr face-extension-list))))
4040 (defun ps-extend-face (face-extension &optional merge-p alist-sym)
4041 "Extend face in ALIST-SYM.
4043 If optional MERGE-P is non-nil, extensions in FACE-EXTENSION list are merged
4044 with face extensions in ALIST-SYM; otherwise, overrides.
4046 If optional ALIST-SYM is nil, `ps-print-face-extension-alist' is used;
4047 otherwise, it should be an alist symbol.
4049 The elements of FACE-EXTENSION list have the form:
4051 (FACE-NAME FOREGROUND BACKGROUND EXTENSION...)
4053 FACE-NAME is a face name symbol.
4055 FOREGROUND and BACKGROUND may be nil or a string that denotes the
4056 foreground and background colors respectively.
4058 EXTENSION is one of the following symbols:
4059 bold - use bold font.
4060 italic - use italic font.
4061 underline - put a line under text.
4062 strikeout - like underline, but the line is in middle of text.
4063 overline - like underline, but the line is over the text.
4064 shadow - text will have a shadow.
4065 box - text will be surrounded by a box.
4066 outline - print characters as hollow outlines.
4068 If EXTENSION is any other symbol, it is ignored."
4070 (setq alist-sym 'ps-print-face-extension-alist))
4071 (let* ((background (nth 2 face-extension))
4072 (foreground (nth 1 face-extension))
4073 (face-name (nth 0 face-extension))
4074 (ps-face (cdr (assq face-name (symbol-value alist-sym))))
4075 (face-vector (or ps-face (vector 0 nil nil)))
4076 (face-bit (ps-extension-bit face-extension)))
4078 (aset face-vector 0 (if merge-p
4079 (logior (aref face-vector 0) face-bit)
4081 (and (or (not merge-p) (and foreground (stringp foreground)))
4082 (aset face-vector 1 foreground))
4083 (and (or (not merge-p) (and background (stringp background)))
4084 (aset face-vector 2 background))
4085 ;; if face does not exist, insert it
4087 (set alist-sym (cons (cons face-name face-vector)
4088 (symbol-value alist-sym))))))
4091 (defun ps-extension-bit (face-extension)
4093 ;; map valid symbol extension to bit vector
4094 (setq face-extension (cdr (cdr face-extension)))
4095 (while (setq face-extension (cdr face-extension))
4096 (setq face-bit (logior face-bit
4097 (or (cdr (assq (car face-extension)
4098 ps-print-face-map-alist))
4103 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4104 ;; Adapted from font-lock: (obsolete stuff)
4105 ;; Originally face attributes were specified via `font-lock-face-attributes'.
4106 ;; Users then changed the default face attributes by setting that variable.
4107 ;; However, we try and be back-compatible and respect its value if set except
4108 ;; for faces where M-x customize has been used to save changes for the face.
4111 (defun ps-font-lock-face-attributes ()
4112 (and (boundp 'font-lock-mode) (symbol-value 'font-lock-mode)
4113 (boundp 'font-lock-face-attributes)
4114 (let ((face-attributes (symbol-value 'font-lock-face-attributes)))
4115 (while face-attributes
4116 (let* ((face-attribute
4117 (car (prog1 face-attributes
4118 (setq face-attributes (cdr face-attributes)))))
4119 (face (car face-attribute)))
4120 ;; Rustle up a `defface' SPEC from a
4121 ;; `font-lock-face-attributes' entry.
4122 (unless (get face 'saved-face)
4123 (let ((foreground (nth 1 face-attribute))
4124 (background (nth 2 face-attribute))
4125 (bold-p (nth 3 face-attribute))
4126 (italic-p (nth 4 face-attribute))
4127 (underline-p (nth 5 face-attribute))
4130 (setq face-spec (cons ':foreground
4131 (cons foreground face-spec))))
4133 (setq face-spec (cons ':background
4134 (cons background face-spec))))
4136 (setq face-spec (append '(:weight bold) face-spec)))
4138 (setq face-spec (append '(:slant italic) face-spec)))
4140 (setq face-spec (append '(:underline t) face-spec)))
4141 (custom-declare-face face (list (list t face-spec)) nil)
4145 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4146 ;; Internal functions and variables
4149 (defun ps-message-log-max ()
4150 (and (not (string= (buffer-name) "*Messages*"))
4151 (boundp 'message-log-max)
4155 (defvar ps-print-hook nil)
4156 (defvar ps-print-begin-sheet-hook nil)
4157 (defvar ps-print-begin-page-hook nil)
4158 (defvar ps-print-begin-column-hook nil)
4161 (defun ps-print-without-faces (from to &optional filename region-p)
4162 (ps-spool-without-faces from to region-p)
4163 (ps-do-despool filename))
4166 (defun ps-spool-without-faces (from to &optional region-p)
4167 (let ((message-log-max (ps-message-log-max))) ; to print *Messages* buffer
4168 (run-hooks 'ps-print-hook)
4169 (ps-printing-region region-p from to)
4170 (ps-generate (current-buffer) from to 'ps-generate-postscript)))
4173 (defun ps-print-with-faces (from to &optional filename region-p)
4174 (ps-spool-with-faces from to region-p)
4175 (ps-do-despool filename))
4178 (defun ps-spool-with-faces (from to &optional region-p)
4179 (let ((message-log-max (ps-message-log-max))) ; to print *Messages* buffer
4180 (run-hooks 'ps-print-hook)
4181 (ps-printing-region region-p from to)
4182 (ps-generate (current-buffer) from to 'ps-generate-postscript-with-faces)))
4185 (defun ps-count-lines-preprint (from to)
4187 (error "The mark is not set now"))
4188 (let ((message-log-max (ps-message-log-max))) ; to count lines of *Messages*
4189 (list (count-lines from to))))
4192 (defun ps-count-lines (from to)
4193 (+ (count-lines from to)
4196 (if (= (current-column) 0) 1 0))))
4199 (defvar ps-printing-region nil
4200 "Variable used to indicate the region that ps-print is printing.
4201 It is a cons, the car of which is the line number where the region begins, and
4202 its cdr is the total number of lines in the buffer. Formatting functions can
4203 use this information to print the original line number (and not the number of
4204 lines printed), and to indicate in the header that the printout is of a partial
4208 (defvar ps-printing-region-p nil
4209 "Non-nil means ps-print is printing a region.")
4212 (defun ps-printing-region (region-p from to)
4213 (setq ps-printing-region-p region-p
4216 (ps-count-lines (point-min) (min from to))
4218 (ps-count-lines (point-min) (point-max)))))
4221 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4222 ;; Internal functions
4225 (defsubst ps-font-alist (font-sym)
4226 (get font-sym 'fonts))
4228 (defun ps-font (font-sym font-type)
4229 "Font family name for text of `font-type', when generating PostScript."
4230 (let* ((font-list (ps-font-alist font-sym))
4231 (normal-font (cdr (assq 'normal font-list))))
4232 (while (and font-list (not (eq font-type (car (car font-list)))))
4233 (setq font-list (cdr font-list)))
4234 (or (cdr (car font-list)) normal-font)))
4236 (defsubst ps-fonts (font-sym)
4237 (mapcar 'cdr (ps-font-alist font-sym)))
4239 (defsubst ps-font-number (font-sym font-type)
4240 (or (ps-alist-position font-type (ps-font-alist font-sym))
4243 (defsubst ps-line-height (font-sym)
4244 "The height of a line, for generating PostScript.
4245 This is the value that ps-print uses to determine the height,
4246 y-dimension, of the lines of text it has printed, and thus affects the
4247 point at which page-breaks are placed.
4248 The line-height is *not* the same as the point size of the font."
4249 (get font-sym 'line-height))
4251 (defsubst ps-title-line-height (font-sym)
4252 "The height of a `title' line, for generating PostScript.
4253 This is the value that ps-print uses to determine the height,
4254 y-dimension, of the lines of text it has printed, and thus affects the
4255 point at which page-breaks are placed.
4256 The title-line-height is *not* the same as the point size of the font."
4257 (get font-sym 'title-line-height))
4259 (defsubst ps-space-width (font-sym)
4260 "The width of a space character, for generating PostScript.
4261 This value is used in expanding tab characters."
4262 (get font-sym 'space-width))
4264 (defsubst ps-avg-char-width (font-sym)
4265 "The average width, in points, of a character, for generating PostScript.
4266 This is the value that ps-print uses to determine the length,
4267 x-dimension, of the text it has printed, and thus affects the point at
4268 which long lines wrap around."
4269 (get font-sym 'avg-char-width))
4271 (defun ps-line-lengths-internal ()
4272 "Display the correspondence between a line length and a font size.
4273 Done using the current ps-print setup.
4274 Try: pr -t file | awk '{printf \"%3d %s\n\", length($0), $0}' | sort -r | head"
4275 (let* ((ps-font-size-internal
4276 (or ps-font-size-internal
4277 (ps-get-font-size 'ps-font-size)))
4278 (ps-header-font-size-internal
4279 (or ps-header-font-size-internal
4280 (ps-get-font-size 'ps-header-font-size)))
4281 (ps-header-title-font-size-internal
4282 (or ps-header-title-font-size-internal
4283 (ps-get-font-size 'ps-header-title-font-size)))
4284 (buf (get-buffer-create "*Line-lengths*"))
4285 (ifs ps-font-size-internal) ; initial font size
4286 (icw (ps-avg-char-width 'ps-font-for-text)) ; initial character width
4287 (print-width (progn (ps-get-page-dimensions)
4289 (ps-setup (ps-setup)) ; setup for the current buffer
4290 (fs-min 5) ; minimum font size
4291 cw-min ; minimum character width
4292 nb-cpl-max ; maximum nb of characters per line
4293 (fs-max 14) ; maximum font size
4294 cw-max ; maximum character width
4295 nb-cpl-min ; minimum nb of characters per line
4296 fs ; current font size
4297 cw ; current character width
4298 nb-cpl ; current nb of characters per line
4300 (setq cw-min (/ (* icw fs-min) ifs)
4301 nb-cpl-max (floor (/ print-width cw-min))
4302 cw-max (/ (* icw fs-max) ifs)
4303 nb-cpl-min (floor (/ print-width cw-max))
4306 (goto-char (point-max))
4307 (or (bobp) (insert "\n" (make-string 75 ?\;) "\n"))
4309 "\nnb char per line / font size\n")
4310 (while (<= nb-cpl nb-cpl-max)
4311 (setq cw (/ print-width (float nb-cpl))
4312 fs (/ (* ifs cw) icw))
4313 (insert (format "%16d %s\n" nb-cpl fs))
4314 (setq nb-cpl (1+ nb-cpl)))
4316 (display-buffer buf 'not-this-window)))
4318 (defun ps-nb-pages (nb-lines)
4319 "Display correspondence between font size and the number of pages.
4320 The correspondence is based on having NB-LINES lines of text,
4321 and on the current ps-print setup."
4322 (let* ((ps-font-size-internal
4323 (or ps-font-size-internal
4324 (ps-get-font-size 'ps-font-size)))
4325 (ps-header-font-size-internal
4326 (or ps-header-font-size-internal
4327 (ps-get-font-size 'ps-header-font-size)))
4328 (ps-header-title-font-size-internal
4329 (or ps-header-title-font-size-internal
4330 (ps-get-font-size 'ps-header-title-font-size)))
4331 (ps-line-spacing-internal
4332 (or ps-line-spacing-internal
4333 (ps-get-size ps-line-spacing "line spacing")))
4334 (buf (get-buffer-create "*Nb-Pages*"))
4335 (ils ps-line-spacing-internal) ; initial line spacing
4336 (ifs ps-font-size-internal) ; initial font size
4337 (ilh (ps-line-height 'ps-font-for-text)) ; initial line height
4338 (page-height (progn (ps-get-page-dimensions)
4340 (ps-setup (ps-setup)) ; setup for the current buffer
4341 (fs-min 4) ; minimum font size
4342 lh-min ; minimum line height
4343 nb-lpp-max ; maximum nb of lines per page
4344 nb-page-min ; minimum nb of pages
4345 (fs-max 14) ; maximum font size
4346 lh-max ; maximum line height
4347 nb-lpp-min ; minimum nb of lines per page
4348 nb-page-max ; maximum nb of pages
4349 fs ; current font size
4350 lh ; current line height
4351 nb-lpp ; current nb of lines per page
4352 nb-page ; current nb of pages
4354 (setq lh-min (/ (- (* (+ ilh ils) fs-min) ils) ifs)
4355 nb-lpp-max (floor (/ page-height lh-min))
4356 nb-page-min (ceiling (/ (float nb-lines) nb-lpp-max))
4357 lh-max (/ (- (* (+ ilh ils) fs-max) ils) ifs)
4358 nb-lpp-min (floor (/ page-height lh-max))
4359 nb-page-max (ceiling (/ (float nb-lines) nb-lpp-min))
4360 nb-page nb-page-min)
4362 (goto-char (point-max))
4363 (or (bobp) (insert "\n" (make-string 75 ?\;) "\n"))
4365 (format "\nThere are %d lines.\n\n" nb-lines)
4366 "nb page / font size\n")
4367 (while (<= nb-page nb-page-max)
4368 (setq nb-lpp (ceiling (/ nb-lines (float nb-page)))
4369 lh (/ page-height nb-lpp)
4370 fs (/ (* ifs lh) ilh))
4371 (insert (format "%7d %s\n" nb-page fs))
4372 (setq nb-page (1+ nb-page)))
4374 (display-buffer buf 'not-this-window)))
4376 ;; macros used in `ps-select-font'
4377 (defmacro ps-lookup (key) `(cdr (assq ,key font-entry)))
4378 (defmacro ps-size-scale (key) `(/ (* (ps-lookup ,key) font-size) size))
4380 (defun ps-select-font (font-family sym font-size title-font-size)
4381 (let ((font-entry (cdr (assq font-family ps-font-info-database))))
4383 (error "Don't have data to scale font %s. Known fonts families are %s"
4385 (mapcar 'car ps-font-info-database)))
4386 (let ((size (ps-lookup 'size)))
4387 (put sym 'fonts (ps-lookup 'fonts))
4388 (put sym 'space-width (ps-size-scale 'space-width))
4389 (put sym 'avg-char-width (ps-size-scale 'avg-char-width))
4390 (put sym 'line-height (ps-size-scale 'line-height))
4391 (put sym 'title-line-height
4392 (/ (* (ps-lookup 'line-height) title-font-size) size)))))
4394 (defun ps-get-page-dimensions ()
4395 (let ((page-dimensions (cdr (assq ps-paper-type ps-page-dimensions-database)))
4396 page-width page-height)
4398 ((null page-dimensions)
4399 (error "`ps-paper-type' must be one of:\n%s"
4400 (mapcar 'car ps-page-dimensions-database)))
4401 ((< ps-number-of-columns 1)
4402 (error "The number of columns %d should be positive"
4403 ps-number-of-columns)))
4405 (ps-select-font ps-font-family 'ps-font-for-text
4406 ps-font-size-internal ps-font-size-internal)
4407 (ps-select-font ps-header-font-family 'ps-font-for-header
4408 ps-header-font-size-internal
4409 ps-header-title-font-size-internal)
4410 (ps-select-font ps-footer-font-family 'ps-font-for-footer
4411 ps-footer-font-size-internal ps-footer-font-size-internal)
4413 (setq page-width (ps-page-dimensions-get-width page-dimensions)
4414 page-height (ps-page-dimensions-get-height page-dimensions))
4417 (if ps-landscape-mode
4418 ;; exchange width and height
4419 (setq page-width (prog1 page-height (setq page-height page-width))))
4421 ;; It is used to get the lower right corner (only in landscape mode)
4422 (setq ps-landscape-page-height page-height)
4424 ;; | lm | text | ic | text | ic | text | rm |
4425 ;; page-width == lm + n * pw + (n - 1) * ic + rm
4426 ;; => pw == (page-width - lm -rm - (n - 1) * ic) / n
4427 (setq ps-print-width (/ (- page-width
4428 ps-left-margin ps-right-margin
4429 (* (1- ps-number-of-columns) ps-inter-column))
4430 ps-number-of-columns))
4431 (if (<= ps-print-width 0)
4432 (error "Bad horizontal layout:
4434 ps-left-margin == %s
4435 ps-right-margin == %s
4436 ps-inter-column == %s
4437 ps-number-of-columns == %s
4438 | lm | text | ic | text | ic | text | rm |
4439 page-width == lm + n * print-width + (n - 1) * ic + rm
4440 => print-width == %d !"
4445 ps-number-of-columns
4448 (setq ps-print-height
4449 (- page-height ps-bottom-margin ps-top-margin))
4450 (if (<= ps-print-height 0)
4451 (error "Bad vertical layout:
4453 ps-bottom-margin == %s
4454 page-height == bm + print-height + tm
4455 => print-height == %d !"
4459 ;; If headers are turned on, deduct the height of the header from the print
4462 (setq ps-header-pad (* ps-header-line-pad
4463 (ps-title-line-height 'ps-font-for-header))
4464 ps-print-height (- ps-print-height
4467 (ps-title-line-height 'ps-font-for-header)
4468 (* (ps-line-height 'ps-font-for-header)
4469 (1- ps-header-lines))
4471 (if (<= ps-print-height 0)
4472 (error "Bad vertical layout (header):
4474 ps-bottom-margin == %s
4475 ps-header-offset == %s
4478 page-height == bm + print-height + tm - ho - hh
4479 => print-height == %d !"
4485 (ps-title-line-height 'ps-font-for-header)
4486 (* (ps-line-height 'ps-font-for-header)
4487 (1- ps-header-lines))
4490 ;; If footers are turned on, deduct the height of the footer from the print
4493 (setq ps-footer-pad (* ps-footer-line-pad
4494 (ps-title-line-height 'ps-font-for-footer))
4495 ps-print-height (- ps-print-height
4498 (* (ps-line-height 'ps-font-for-footer)
4499 (1- ps-footer-lines))
4501 (if (<= ps-print-height 0)
4502 (error "Bad vertical layout (footer):
4504 ps-bottom-margin == %s
4505 ps-footer-offset == %s
4508 page-height == bm + print-height + tm - fo - fh
4509 => print-height == %d !"
4515 (* (ps-line-height 'ps-font-for-footer)
4516 (1- ps-footer-lines))
4519 ;; ps-zebra-stripe-follow is `full' or `full-follow'
4520 (if ps-zebra-stripe-full-p
4521 (let* ((line-height (ps-line-height 'ps-font-for-text))
4522 (zebra (* (+ line-height ps-line-spacing-internal)
4523 ps-zebra-stripe-height)))
4524 (setq ps-print-height (- (* (floor ps-print-height zebra) zebra)
4526 (if (<= ps-print-height 0)
4527 (error "Bad vertical layout (full zebra stripe follow):
4528 ps-zebra-stripe-follow == %s
4529 ps-zebra-stripe-height == %s
4530 font-text-height == %s
4532 page-height == ((floor print-height ((th + ls) * zh)) * ((th + ls) * zh)) - th
4533 => print-height == %d !"
4534 ps-zebra-stripe-follow
4535 ps-zebra-stripe-height
4536 (ps-line-height 'ps-font-for-text)
4537 ps-line-spacing-internal
4538 ps-print-height))))))
4541 (defun ps-print-preprint-region (prefix-arg)
4542 (or (ps-mark-active-p)
4543 (error "The mark is not set now"))
4544 (list (point) (mark) (ps-print-preprint prefix-arg)))
4547 (defun ps-print-preprint (prefix-arg)
4549 (or (numberp prefix-arg)
4551 (let* ((name (concat (file-name-nondirectory (or (buffer-file-name)
4554 (prompt (format "Save PostScript to file (default %s): " name))
4555 (res (read-file-name prompt default-directory name nil)))
4556 (while (cond ((file-directory-p res)
4558 (setq prompt "It's a directory"))
4559 ((not (file-writable-p res))
4561 (setq prompt "File is unwritable"))
4562 ((file-exists-p res)
4563 (setq prompt "File exists")
4564 (not (y-or-n-p (format "File `%s' exists; overwrite? "
4567 (setq res (read-file-name
4568 (format "%s; save PostScript to file: " prompt)
4569 (file-name-directory res) nil nil
4570 (file-name-nondirectory res))))
4571 (if (file-directory-p res)
4572 (expand-file-name name (file-name-as-directory res))
4575 ;; The following functions implement a simple list-buffering scheme so
4576 ;; that ps-print doesn't have to repeatedly switch between buffers
4577 ;; while spooling. The functions `ps-output' and `ps-output-string' build
4578 ;; up the lists; the function `ps-flush-output' takes the lists and
4579 ;; insert its contents into the spool buffer (*PostScript*).
4581 (defvar ps-string-escape-codes
4582 (let ((table (make-vector 256 nil))
4584 ;; control characters
4585 (while (<= char ?\037)
4586 (aset table char (format "\\%03o" char))
4587 (setq char (1+ char)))
4588 ;; printable characters
4589 (while (< char ?\177)
4590 (aset table char (format "%c" char))
4591 (setq char (1+ char)))
4592 ;; DEL and 8-bit characters
4593 (while (<= char ?\377)
4594 (aset table char (format "\\%o" char))
4595 (setq char (1+ char)))
4596 ;; Override ASCII formatting characters with named escape code:
4597 (aset table ?\n "\\n") ; [NL] linefeed
4598 (aset table ?\r "\\r") ; [CR] carriage return
4599 (aset table ?\t "\\t") ; [HT] horizontal tab
4600 (aset table ?\b "\\b") ; [BS] backspace
4601 (aset table ?\f "\\f") ; [NP] form feed
4602 ;; Escape PostScript escape and string delimiter characters:
4603 (aset table ?\\ "\\\\")
4604 (aset table ?\( "\\(")
4605 (aset table ?\) "\\)")
4607 "Vector used to map characters to PostScript string escape codes.")
4609 (defsubst ps-output-string-prim (string)
4610 (insert "(") ;insert start-string delimiter
4611 (save-excursion ;insert string
4612 (insert (string-as-unibyte string)))
4613 ;; Find and quote special characters as necessary for PS
4614 ;; This skips everything except control chars, non-ASCII chars, (, ) and \.
4615 (while (progn (skip-chars-forward " -'*-[]-~") (not (eobp)))
4616 (let ((special (following-char)))
4619 (if (and (<= 0 special) (<= special 255))
4620 (aref ps-string-escape-codes special)
4621 ;; insert hexadecimal representation if character code is out of range
4622 (format "\\%04X" special)
4624 (goto-char (point-max))
4625 (insert ")")) ;insert end-string delimiter
4627 (defsubst ps-init-output-queue ()
4628 (setq ps-output-head (list "")
4629 ps-output-tail ps-output-head))
4632 (defun ps-selected-pages ()
4634 (setq ps-first-page (car (car ps-selected-pages))
4635 ps-last-page (cdr (car ps-selected-pages))
4636 ps-selected-pages (cdr ps-selected-pages))
4637 (and ps-selected-pages
4638 (< ps-last-page ps-page-postscript)))))
4641 (defsubst ps-print-page-p ()
4642 (setq ps-print-page-p
4643 (and (cond ((null ps-first-page))
4644 ((<= ps-page-postscript ps-last-page)
4645 (<= ps-first-page ps-page-postscript))
4648 (and (<= ps-first-page ps-page-postscript)
4649 (<= ps-page-postscript ps-last-page)))
4652 (cond ((eq ps-even-or-odd-pages 'even-page)
4653 (= (logand ps-page-postscript 1) 0))
4654 ((eq ps-even-or-odd-pages 'odd-page)
4655 (= (logand ps-page-postscript 1) 1))
4660 (defsubst ps-print-sheet-p ()
4661 (setq ps-print-page-p
4662 (cond ((eq ps-even-or-odd-pages 'even-sheet)
4663 (= (logand ps-page-sheet 1) 0))
4664 ((eq ps-even-or-odd-pages 'odd-sheet)
4665 (= (logand ps-page-sheet 1) 1))
4670 (defun ps-output (&rest args)
4671 (when ps-print-page-p
4672 (setcdr ps-output-tail args)
4673 (while (cdr ps-output-tail)
4674 (setq ps-output-tail (cdr ps-output-tail)))))
4676 (defun ps-output-string (string)
4677 (ps-output t string))
4679 ;; Output strings in the list ARGS in the PostScript prologue part.
4680 (defun ps-output-prologue (args)
4681 (ps-output 'prologue (if (stringp args) (list args) args)))
4683 (defun ps-flush-output ()
4685 (set-buffer ps-spool-buffer)
4686 (goto-char (point-max))
4687 (while ps-output-head
4688 (let ((it (car ps-output-head)))
4691 (setq ps-output-head (cdr ps-output-head))
4692 (ps-output-string-prim (car ps-output-head)))
4694 (setq ps-output-head (cdr ps-output-head))
4696 (search-backward "\nBeginDoc")
4698 (apply 'insert (car ps-output-head))))
4701 (setq ps-output-head (cdr ps-output-head))))
4702 (ps-init-output-queue))
4704 (defun ps-insert-file (fname)
4707 (set-buffer ps-spool-buffer)
4708 (goto-char (point-max))
4709 (insert-file-contents fname)))
4711 ;; These functions insert the arrays that define the contents of the headers.
4713 (defvar ps-encode-header-string-function nil)
4715 (defun ps-generate-header-line (fonttag &optional content)
4716 (ps-output " [" fonttag " ")
4718 ;; Literal strings should be output as is -- the string must contain its own
4719 ;; PS string delimiters, '(' and ')', if necessary.
4721 (ps-output content))
4723 ;; Functions are called -- they should return strings; they will be inserted
4724 ;; as strings and the PS string delimiters added.
4725 ((functionp content)
4726 (if (functionp ps-encode-header-string-function)
4727 (dolist (l (funcall ps-encode-header-string-function
4728 (funcall content) fonttag))
4729 (ps-output-string l))
4730 (ps-output-string (funcall content))))
4732 ;; Variables will have their contents inserted. They should contain
4733 ;; strings, and will be inserted as strings.
4734 ((and (symbolp content) (boundp content))
4735 (if (fboundp ps-encode-header-string-function)
4736 (dolist (l (funcall ps-encode-header-string-function
4737 (symbol-value content) fonttag))
4738 (ps-output-string l))
4739 (ps-output-string (symbol-value content))))
4741 ;; Anything else will get turned into an empty string.
4743 (ps-output-string "")))
4746 (defun ps-generate-header (name fonttag0 fonttag1 contents)
4747 (ps-output "/" name "[\n")
4748 (and contents (> ps-header-lines 0)
4750 (ps-generate-header-line fonttag0 (car contents))
4751 (while (and (< count ps-header-lines)
4752 (setq contents (cdr contents)))
4753 (ps-generate-header-line fonttag1 (car contents))
4754 (setq count (1+ count)))))
4755 (ps-output "]def\n"))
4758 (defun ps-output-boolean (name bool)
4759 (ps-output (format "/%s %s def\n" name (if bool "true" "false"))))
4762 (defun ps-output-frame-properties (name alist)
4763 (ps-output "/" name " ["
4764 (ps-format-color (cdr (assq 'fore-color alist)) 0.0)
4765 (ps-format-color (cdr (assq 'back-color alist)) 0.9)
4766 (ps-float-format (or (cdr (assq 'border-width alist)) 0.4))
4767 (ps-format-color (cdr (assq 'border-color alist)) 0.0)
4768 (ps-format-color (cdr (assq 'shadow-color alist)) 0.0)
4772 (defun ps-background-pages (page-list func)
4776 (let ((start (if (consp pages) (car pages) pages))
4777 (end (if (consp pages) (cdr pages) pages)))
4778 (and (integerp start) (integerp end) (<= start end)
4779 (add-to-list 'ps-background-pages (vector start end func)))))
4781 (setq ps-background-all-pages (cons func ps-background-all-pages))))
4784 (defconst ps-boundingbox-re
4786 \\s-+\\([0-9.]+\\)\\s-+\\([0-9.]+\\)\\s-+\\([0-9.]+\\)\\s-+\\([0-9.]+\\)")
4789 (defun ps-get-boundingbox ()
4791 (set-buffer ps-spool-buffer)
4793 (if (re-search-forward ps-boundingbox-re nil t)
4794 (vector (string-to-number ; lower x
4795 (buffer-substring (match-beginning 1) (match-end 1)))
4796 (string-to-number ; lower y
4797 (buffer-substring (match-beginning 2) (match-end 2)))
4798 (string-to-number ; upper x
4799 (buffer-substring (match-beginning 3) (match-end 3)))
4800 (string-to-number ; upper y
4801 (buffer-substring (match-beginning 4) (match-end 4))))
4802 (vector 0 0 0 0)))))
4805 (defun ps-float-format (value &optional default)
4806 (let ((literal (or value default)))
4807 (cond ((null literal)
4810 (format ps-float-format (* literal 1.0))) ; force float number
4812 (format "%s " literal))
4816 (defun ps-background-text ()
4819 (setq ps-background-text-count (1+ ps-background-text-count))
4820 (ps-output (format "/ShowBackText-%d{\n" ps-background-text-count))
4821 (ps-output-string (nth 0 text)) ; text
4824 (ps-float-format (nth 4 text) 200.0) ; font size
4825 (format "/%s " (or (nth 3 text) "Times-Roman")) ; font name
4826 (ps-float-format (nth 6 text)
4827 "PrintHeight PrintPageWidth atan") ; rotation
4828 (ps-float-format (nth 5 text) 0.85) ; gray
4829 (ps-float-format (nth 1 text) "0") ; x position
4830 (ps-float-format (nth 2 text) "0") ; y position
4831 "\nShowBackText}def\n")
4832 (ps-background-pages (nthcdr 7 text) ; page list
4833 (format "ShowBackText-%d\n"
4834 ps-background-text-count)))
4835 ps-print-background-text))
4838 (defun ps-background-image ()
4841 (let ((image-file (expand-file-name (nth 0 image))))
4842 (when (file-readable-p image-file)
4843 (setq ps-background-image-count (1+ ps-background-image-count))
4845 (format "/ShowBackImage-%d{\n--back-- "
4846 ps-background-image-count)
4847 (ps-float-format (nth 5 image) 0.0) ; rotation
4848 (ps-float-format (nth 3 image) 1.0) ; x scale
4849 (ps-float-format (nth 4 image) 1.0) ; y scale
4850 (ps-float-format (nth 1 image) ; x position
4851 "PrintPageWidth 2 div")
4852 (ps-float-format (nth 2 image) ; y position
4853 "PrintHeight 2 div BottomMargin add")
4854 "\nBeginBackImage\n")
4855 (ps-insert-file image-file)
4856 ;; coordinate adjustment to center image
4857 ;; around x and y position
4858 (let ((box (ps-get-boundingbox)))
4860 (set-buffer ps-spool-buffer)
4862 (if (re-search-backward "^--back--" nil t)
4866 (- (+ (/ (- (aref box 2) (aref box 0)) 2.0)
4869 (- (+ (/ (- (aref box 3) (aref box 1)) 2.0)
4872 (ps-output "\nEndBackImage}def\n")
4873 (ps-background-pages (nthcdr 6 image) ; page list
4874 (format "ShowBackImage-%d\n"
4875 ps-background-image-count)))))
4876 ps-print-background-image))
4879 (defun ps-background (page-number)
4880 (let (has-local-background)
4881 (mapc #'(lambda (range)
4882 (and (<= (aref range 0) page-number)
4883 (<= page-number (aref range 1))
4884 (if has-local-background
4885 (ps-output (aref range 2))
4886 (setq has-local-background t)
4887 (ps-output "/printLocalBackground{\n"
4889 ps-background-pages)
4890 (and has-local-background (ps-output "}def\n"))))
4893 ;; Return a list of the distinct elements of LIST.
4894 ;; Elements are compared with `equal'.
4895 (defun ps-remove-duplicates (list)
4896 (let (new (tail list))
4898 (or (member (car tail) new)
4899 (setq new (cons (car tail) new)))
4900 (setq tail (cdr tail)))
4904 ;; Find the first occurrence of ITEM in LIST.
4905 ;; Return the index of the matching item, or nil if not found.
4906 ;; Elements are compared with `eq'.
4907 (defun ps-alist-position (item list)
4908 (let ((tail list) (index 0) found)
4910 (if (setq found (eq (car (car tail)) item))
4912 (setq index (1+ index)
4917 (defconst ps-n-up-database
4968 (2 t 1 2 0) ; adjusted by PostScript code
5011 (2 t 1 2 0) ; adjusted by PostScript code
5056 ;; Ledger paper size is a special case, it is the only paper size where the
5057 ;; normal size is landscaped, that is, the height is smaller than width.
5058 ;; So, we use the special value `pag' in the `landscape' field.
5107 (2 t 1 2 0) ; adjusted by PostScript code
5203 "Alist which is the page matrix database used for N-up printing.
5205 Each element has the following form:
5208 (MAX LANDSCAPE LINES COLUMNS COL-MISSING)
5212 PAGE is the page size used (see `ps-paper-type').
5213 MAX is the maximum elements of this page matrix.
5214 LANDSCAPE specifies if page matrix is landscaped, has the following valid
5216 nil the sheet is in portrait mode.
5217 t the sheet is in landscape mode.
5218 pag the sheet is in portrait mode and page is in landscape mode.
5219 LINES is the number of lines of page matrix.
5220 COLUMNS is the number of columns of page matrix.
5221 COL-MISSING is the number of columns missing to fill the sheet.")
5224 (defmacro ps-n-up-landscape (mat) `(nth 1 ,mat))
5225 (defmacro ps-n-up-lines (mat) `(nth 2 ,mat))
5226 (defmacro ps-n-up-columns (mat) `(nth 3 ,mat))
5227 (defmacro ps-n-up-missing (mat) `(nth 4 ,mat))
5230 (defun ps-n-up-printing ()
5231 ;; force `ps-n-up-printing' be in range 1 to 100.
5232 (setq ps-n-up-printing (max (min ps-n-up-printing 100) 1))
5233 ;; find suitable page matrix for a given `ps-paper-type'.
5234 (let ((the-list (cdr (assq ps-paper-type ps-n-up-database))))
5236 (while (> ps-n-up-printing (caar the-list))
5237 (setq the-list (cdr the-list))))
5241 (defconst ps-n-up-filling-database
5243 "PageWidth" ; N-Up-XColumn
5245 "N-Up-End 1 sub PageWidth mul neg" ; N-Up-XLine
5246 "LandscapePageHeight neg" ; N-Up-YLine
5247 "N-Up-Lines" ; N-Up-Repeat
5248 "N-Up-Columns" ; N-Up-End
5252 "PageWidth" ; N-Up-XColumn
5254 "N-Up-End 1 sub PageWidth mul neg" ; N-Up-XLine
5255 "LandscapePageHeight" ; N-Up-YLine
5256 "N-Up-Lines" ; N-Up-Repeat
5257 "N-Up-Columns" ; N-Up-End
5259 "N-Up-Repeat 1 sub LandscapePageHeight mul neg") ; N-Up-YStart
5261 "PageWidth neg" ; N-Up-XColumn
5263 "N-Up-End 1 sub PageWidth mul" ; N-Up-XLine
5264 "LandscapePageHeight neg" ; N-Up-YLine
5265 "N-Up-Lines" ; N-Up-Repeat
5266 "N-Up-Columns" ; N-Up-End
5267 "N-Up-End 1 sub PageWidth mul" ; N-Up-XStart
5270 "PageWidth neg" ; N-Up-XColumn
5272 "N-Up-End 1 sub PageWidth mul" ; N-Up-XLine
5273 "LandscapePageHeight" ; N-Up-YLine
5274 "N-Up-Lines" ; N-Up-Repeat
5275 "N-Up-Columns" ; N-Up-End
5276 "N-Up-End 1 sub PageWidth mul" ; N-Up-XStart
5277 "N-Up-Repeat 1 sub LandscapePageHeight mul neg") ; N-Up-YStart
5280 "LandscapePageHeight neg" ; N-Up-YColumn
5281 "PageWidth" ; N-Up-XLine
5282 "N-Up-End 1 sub LandscapePageHeight mul" ; N-Up-YLine
5283 "N-Up-Columns" ; N-Up-Repeat
5284 "N-Up-Lines" ; N-Up-End
5289 "LandscapePageHeight" ; N-Up-YColumn
5290 "PageWidth" ; N-Up-XLine
5291 "N-Up-End 1 sub LandscapePageHeight mul neg" ; N-Up-YLine
5292 "N-Up-Columns" ; N-Up-Repeat
5293 "N-Up-Lines" ; N-Up-End
5295 "N-Up-End 1 sub LandscapePageHeight mul neg") ; N-Up-YStart
5298 "LandscapePageHeight neg" ; N-Up-YColumn
5299 "PageWidth neg" ; N-Up-XLine
5300 "N-Up-End 1 sub LandscapePageHeight mul" ; N-Up-YLine
5301 "N-Up-Columns" ; N-Up-Repeat
5302 "N-Up-Lines" ; N-Up-End
5303 "N-Up-Repeat 1 sub PageWidth mul" ; N-Up-XStart
5307 "LandscapePageHeight" ; N-Up-YColumn
5308 "PageWidth neg" ; N-Up-XLine
5309 "N-Up-End 1 sub LandscapePageHeight mul neg" ; N-Up-YLine
5310 "N-Up-Columns" ; N-Up-Repeat
5311 "N-Up-Lines" ; N-Up-End
5312 "N-Up-Repeat 1 sub PageWidth mul" ; N-Up-XStart
5313 "N-Up-End 1 sub LandscapePageHeight mul neg")) ; N-Up-YStart
5314 "Alist for n-up printing initializations.
5316 Each element has the following form:
5318 (KIND XCOL YCOL XLIN YLIN REPEAT END XSTART YSTART)
5321 KIND is a valid value of `ps-n-up-filling'.
5322 XCOL YCOL are the relative position for the next column.
5323 XLIN YLIN are the relative position for the beginning of next line.
5324 REPEAT is the number of repetions for external loop.
5325 END is the number of repetions for internal loop and also the number of pages in
5327 XSTART YSTART are the relative position for the first page in a sheet.")
5330 (defun ps-n-up-filling ()
5331 (cdr (or (assq ps-n-up-filling ps-n-up-filling-database)
5332 (assq 'left-top ps-n-up-filling-database))))
5335 (defmacro ps-n-up-xcolumn (init) `(nth 0 ,init))
5336 (defmacro ps-n-up-ycolumn (init) `(nth 1 ,init))
5337 (defmacro ps-n-up-xline (init) `(nth 2 ,init))
5338 (defmacro ps-n-up-yline (init) `(nth 3 ,init))
5339 (defmacro ps-n-up-repeat (init) `(nth 4 ,init))
5340 (defmacro ps-n-up-end (init) `(nth 5 ,init))
5341 (defmacro ps-n-up-xstart (init) `(nth 6 ,init))
5342 (defmacro ps-n-up-ystart (init) `(nth 7 ,init))
5345 (defconst ps-error-handler-alist
5349 (paper-and-system . 3))
5350 "Alist for error handler message.")
5353 (defconst ps-zebra-stripe-alist
5357 "Alist for zebra stripe continuation.")
5360 (defun ps-begin-file ()
5361 (setq ps-page-order 0
5363 ps-background-text-count 0
5364 ps-background-image-count 0
5365 ps-background-pages nil
5366 ps-background-all-pages nil)
5368 (let ((dimensions (cdr (assq ps-paper-type ps-page-dimensions-database)))
5369 (tumble (if ps-landscape-mode (not ps-spool-tumble) ps-spool-tumble))
5370 (n-up (ps-n-up-printing))
5371 (n-up-filling (ps-n-up-filling)))
5372 (and ps-n-up-on (setq tumble (not tumble)))
5375 "%%Title: " (buffer-name) ; Take job name from name of
5376 ; first buffer printed
5377 "\n%%Creator: ps-print v" ps-print-version
5378 "\n%%For: " (user-full-name)
5379 "\n%%CreationDate: " (format-time-string "%T %b %d %Y")
5381 (if ps-landscape-mode "Landscape" "Portrait")
5382 "\n%%DocumentNeededResources: font Times-Roman Times-Italic\n%%+ font "
5383 (mapconcat 'identity
5384 (ps-remove-duplicates
5385 (append (ps-fonts 'ps-font-for-text)
5386 (list (ps-font 'ps-font-for-header 'normal)
5387 (ps-font 'ps-font-for-header 'bold)
5388 (ps-font 'ps-font-for-footer 'normal)
5389 (ps-font 'ps-font-for-footer 'bold))))
5391 "\n%%DocumentSuppliedResources: procset PSPrintUserDefinedPrologue-" (user-login-name) " 0 0"
5392 "\n%%DocumentMedia: " (ps-page-dimensions-get-media dimensions)
5393 (format " %d" (round (ps-page-dimensions-get-width dimensions)))
5394 (format " %d" (round (ps-page-dimensions-get-height dimensions)))
5395 " 0 () ()\n%%PageOrder: Ascend\n%%Pages: (atend)\n%%Requirements:"
5397 (if tumble " duplex(tumble)\n" " duplex\n")
5400 (ps-insert-string ps-print-prologue-header)
5402 (ps-output "%%EndComments\n%%BeginDefaults\n%%PageMedia: "
5403 (ps-page-dimensions-get-media dimensions)
5404 "\n%%EndDefaults\n\n%%BeginProlog\n\n"
5405 "/languagelevel where{pop}{/languagelevel 1 def}ifelse\n"
5406 (format "/ErrorMessage %s def\n\n"
5407 (or (cdr (assoc ps-error-handler-message
5408 ps-error-handler-alist))
5411 "\n%%BeginResource: procset PSPrintUserDefinedPrologue-" (user-login-name) " 0 0\n\n")
5413 (ps-insert-string ps-user-defined-prologue)
5415 (ps-output "\n%%EndResource\n\n")
5417 (ps-output-boolean "LandscapeMode "
5418 (or ps-landscape-mode
5419 (eq (ps-n-up-landscape n-up) 'pag)))
5420 (ps-output-boolean "UpsideDown " ps-print-upside-down)
5421 (ps-output (format "/NumberOfColumns %d def\n" ps-number-of-columns)
5423 (format "/LandscapePageHeight %s def\n" ps-landscape-page-height)
5424 (format "/PrintPageWidth %s def\n"
5425 (- (* (+ ps-print-width ps-inter-column)
5426 ps-number-of-columns)
5428 (format "/PrintWidth %s def\n" ps-print-width)
5429 (format "/PrintHeight %s def\n" ps-print-height)
5431 (format "/LeftMargin %s def\n" ps-left-margin)
5432 (format "/RightMargin %s def\n" ps-right-margin)
5433 (format "/InterColumn %s def\n" ps-inter-column)
5435 (format "/BottomMargin %s def\n" ps-bottom-margin)
5436 (format "/TopMargin %s def\n" ps-top-margin) ; not used
5437 (format "/HeaderOffset %s def\n" ps-header-offset)
5438 (format "/HeaderPad %s def\n" ps-header-pad)
5439 (format "/FooterOffset %s def\n" ps-footer-offset)
5440 (format "/FooterPad %s def\n" ps-footer-pad)
5441 (format "/FooterLines %s def\n" ps-footer-lines))
5443 (ps-output-boolean "ShowNofN " ps-show-n-of-n)
5444 (ps-output-boolean "SwitchHeader " (if (eq ps-switch-header 'duplex)
5447 (ps-output-boolean "PrintOnlyOneHeader" ps-print-only-one-header)
5448 (ps-output-boolean "PrintHeader " ps-print-header)
5449 (ps-output-boolean "PrintHeaderFrame " ps-print-header-frame)
5450 (ps-output-frame-properties "HeaderFrameProperties" ps-header-frame-alist)
5451 (ps-output-boolean "PrintFooter " ps-print-footer)
5452 (ps-output-boolean "PrintFooterFrame " ps-print-footer-frame)
5453 (ps-output-frame-properties "FooterFrameProperties" ps-footer-frame-alist)
5455 (let ((line-height (ps-line-height 'ps-font-for-text)))
5456 (ps-output (format "/LineSpacing %s def\n" ps-line-spacing-internal)
5457 (format "/ParagraphSpacing %s def\n"
5458 ps-paragraph-spacing-internal)
5459 (format "/LineHeight %s def\n" line-height)
5460 (format "/LinesPerColumn %d def\n"
5461 (let ((height (+ line-height
5462 ps-line-spacing-internal)))
5463 (round (/ (+ ps-print-height
5467 (ps-output-boolean "WarnPaperSize " ps-warn-paper-type)
5468 (ps-output-boolean "Zebra " ps-zebra-stripes)
5469 (ps-output-boolean "PrintLineNumber " ps-line-number)
5470 (ps-output-boolean "SyncLineZebra " (not (integerp ps-line-number-step)))
5471 (ps-output (format "/ZebraFollow %d def\n"
5472 (or (cdr (assq ps-zebra-stripe-follow
5473 ps-zebra-stripe-alist))
5475 (format "/PrintLineStep %d def\n"
5476 (if (integerp ps-line-number-step)
5478 ps-zebra-stripe-height))
5479 (format "/PrintLineStart %d def\n" ps-line-number-start)
5481 (ps-format-color ps-line-number-color 0.0)
5482 (format "def\n/ZebraHeight %d def\n"
5483 ps-zebra-stripe-height)
5485 (ps-format-color ps-zebra-color 0.95)
5487 (ps-output "/BackgroundColor "
5488 (ps-format-color ps-default-background 1.0)
5490 (ps-output "/UseSetpagedevice "
5491 (if (eq ps-spool-config 'setpagedevice)
5492 "/setpagedevice where{pop languagelevel 2 eq}{false}ifelse"
5494 " def\n\n/PageWidth "
5495 "PrintPageWidth LeftMargin add RightMargin add def\n\n"
5496 (format "/N-Up %d def\n" ps-n-up-printing))
5497 (ps-output-boolean "N-Up-Landscape" (eq (ps-n-up-landscape n-up) t))
5498 (ps-output-boolean "N-Up-Border " ps-n-up-border-p)
5499 (ps-output (format "/N-Up-Lines %d def\n" (ps-n-up-lines n-up))
5500 (format "/N-Up-Columns %d def\n" (ps-n-up-columns n-up))
5501 (format "/N-Up-Missing %d def\n" (ps-n-up-missing n-up))
5502 (format "/N-Up-Margin %s def\n" ps-n-up-margin)
5504 (if ps-landscape-mode
5505 (ps-n-up-end n-up-filling)
5506 (ps-n-up-repeat n-up-filling))
5508 (if ps-landscape-mode
5509 (ps-n-up-repeat n-up-filling)
5510 (ps-n-up-end n-up-filling))
5511 " def\n/N-Up-XColumn " (ps-n-up-xcolumn n-up-filling)
5512 " def\n/N-Up-YColumn " (ps-n-up-ycolumn n-up-filling)
5513 " def\n/N-Up-XLine " (ps-n-up-xline n-up-filling)
5514 " def\n/N-Up-YLine " (ps-n-up-yline n-up-filling)
5515 " def\n/N-Up-XStart " (ps-n-up-xstart n-up-filling)
5516 " def\n/N-Up-YStart " (ps-n-up-ystart n-up-filling) " def\n")
5518 (ps-background-text)
5519 (ps-background-image)
5520 (setq ps-background-all-pages (nreverse ps-background-all-pages)
5521 ps-background-pages (nreverse ps-background-pages))
5523 (ps-output "\n" ps-print-prologue-1
5524 "\n/printGlobalBackground{\n")
5525 (mapc 'ps-output ps-background-all-pages)
5527 "}def\n/printLocalBackground{\n}def\n"
5528 "\n%%EndProlog\n\n%%BeginSetup\n"
5529 "\n%%IncludeResource: font Times-Roman"
5530 "\n%%IncludeResource: font Times-Italic"
5531 "\n%%IncludeResource: font "
5532 (mapconcat 'identity
5533 (ps-remove-duplicates
5534 (append (ps-fonts 'ps-font-for-text)
5535 (list (ps-font 'ps-font-for-header 'normal)
5536 (ps-font 'ps-font-for-header 'bold)
5537 (ps-font 'ps-font-for-footer 'normal)
5538 (ps-font 'ps-font-for-footer 'bold))))
5539 "\n%%IncludeResource: font ")
5540 ;; Header/line number fonts
5541 (format "\n/h0 %s(%s)cvn DefFont\n" ; /h0 14/Helvetica-Bold DefFont
5542 ps-header-title-font-size-internal
5543 (ps-font 'ps-font-for-header 'bold))
5544 (format "/h1 %s(%s)cvn DefFont\n" ; /h1 12/Helvetica DefFont
5545 ps-header-font-size-internal
5546 (ps-font 'ps-font-for-header 'normal))
5547 (format "/L0 %s(%s)cvn DefFont\n" ; /L0 6/Times-Italic DefFont
5548 (ps-get-font-size 'ps-line-number-font-size)
5549 ps-line-number-font)
5550 (format "/H0 %s(%s)cvn DefFont\n" ; /H0 12/Helvetica DefFont
5551 ps-footer-font-size-internal
5552 (ps-font 'ps-font-for-footer 'normal))
5553 "\n\n% ---- These lines must be kept together because...
5556 /HeaderTitleLineHeight FontHeight def
5559 /HeaderLineHeight FontHeight def
5560 /HeaderDescent Descent def
5563 /FooterLineHeight FontHeight def
5564 /FooterDescent Descent def
5566 % ---- ...because `F' has a side-effect on `FontHeight' and `Descent'\n\n")
5569 (let ((font (ps-font-alist 'ps-font-for-text))
5572 (ps-output (format "/f%d %s(%s)cvn DefFont\n"
5574 ps-font-size-internal
5575 (ps-font 'ps-font-for-text (car (car font)))))
5576 (setq font (cdr font)
5579 (let ((font-entry (cdr (assq ps-font-family ps-font-info-database))))
5580 (ps-output (format "/SpaceWidthRatio %f def\n"
5581 (/ (ps-lookup 'space-width) (ps-lookup 'size)))))
5583 (unless (eq ps-spool-config 'lpr-switches)
5584 (ps-output "\n%%BeginFeature: *Duplex "
5585 (ps-boolean-capitalized ps-spool-duplex)
5587 (ps-boolean-capitalized tumble)
5588 "\nUseSetpagedevice\n{BMark/Duplex "
5589 (ps-boolean-constant ps-spool-duplex)
5591 (ps-boolean-constant tumble)
5592 " EMark setpagedevice}\n{statusdict begin "
5593 (ps-boolean-constant ps-spool-duplex)
5595 (ps-boolean-constant tumble)
5596 " settumble end}ifelse\n%%EndFeature\n")))
5597 (ps-output "\n%%BeginFeature: *ManualFeed "
5598 (ps-boolean-capitalized ps-manual-feed)
5599 "\nBMark /ManualFeed "
5600 (ps-boolean-constant ps-manual-feed)
5601 " EMark setpagedevice\n%%EndFeature\n\nBeginDoc\n%%EndSetup\n")
5602 (and ps-banner-page-when-duplexing
5603 (ps-output "\n%%Page: banner 0\nsave showpage restore\n")))
5606 (defun ps-format-color (color &optional default)
5607 (let ((the-color (if (stringp color)
5608 (ps-color-scale color)
5610 (if (and the-color (listp the-color))
5612 (format ps-color-format
5613 (* (nth 0 the-color) 1.0) ; force float number
5614 (* (nth 1 the-color) 1.0) ; force float number
5615 (* (nth 2 the-color) 1.0)) ; force float number
5617 (ps-float-format (if (numberp the-color) the-color default)))))
5620 (defun ps-insert-string (prologue)
5621 (let ((str (if (functionp prologue)
5628 (defun ps-boolean-capitalized (bool)
5629 (if bool "True" "False"))
5632 (defun ps-boolean-constant (bool)
5633 (if bool "true" "false"))
5636 (defun ps-header-dirpart ()
5637 (let ((fname (buffer-file-name)))
5639 (if (string-equal (buffer-name) (file-name-nondirectory fname))
5640 (abbreviate-file-name (file-name-directory fname))
5645 (defun ps-get-buffer-name ()
5647 ;; Indulge Jim this little easter egg:
5648 ((string= (buffer-name) "ps-print.el")
5649 "Hey, Cool! It's ps-print.el!!!")
5650 ;; Indulge Jack this other little easter egg:
5651 ((string= (buffer-name) "sokoban.el")
5652 "Super! C'est sokoban.el!")
5654 (and ps-printing-region-p "Subset of: ")
5656 (and (buffer-modified-p) " (unsaved)")))))
5659 (defun ps-get-size (size mess &optional arg)
5660 (let ((siz (cond ((numberp size)
5663 (numberp (car size))
5664 (numberp (cdr size)))
5665 (if ps-landscape-mode
5671 (error "Invalid %s `%S'%s"
5674 (format " for `%S'" arg)
5679 (defun ps-get-font-size (font-sym)
5680 (ps-get-size (symbol-value font-sym) "font size" font-sym))
5683 (defun ps-rgb-color (color unspecified default)
5685 ;; (float float float) ==> (R G B)
5686 ((and color (listp color) (= (length color) 3)
5692 ok (and (floatp e) (<= 0.0 e) (<= e 1.0))))
5695 ;; float ==> 0.0 = black .. 1.0 = white
5696 ((and (floatp color) (<= 0.0 color) (<= color 1.0))
5697 (list color color color))
5698 ;; "colorName" but different from "unspecified-[bf]g"
5699 ((and (stringp color) (not (string= color unspecified)))
5700 (ps-color-scale color))
5701 ;; ok, use the default
5703 (list default default default))))
5705 (defvar ps-basic-plot-string-function 'ps-basic-plot-string)
5707 (defun ps-begin-job (genfunc)
5709 (or (equal ps-mark-code-directory ps-postscript-code-directory)
5710 (setq ps-print-prologue-0 (ps-prologue-file 0)
5711 ps-print-prologue-1 (ps-prologue-file 1)
5712 ps-mark-code-directory ps-postscript-code-directory))
5715 (while ps-selected-pages
5716 (setq page (car ps-selected-pages)
5717 ps-selected-pages (cdr ps-selected-pages))
5718 (cond ((integerp page)
5720 (setq new (cons (cons page page) new))))
5722 (and (integerp (car page)) (integerp (cdr page))
5724 (<= (car page) (cdr page))
5725 (setq new (cons page new))))))
5726 (setq ps-selected-pages (sort new #'(lambda (one other)
5727 (< (car one) (car other))))
5728 ps-last-selected-pages ps-selected-pages
5732 (or (listp ps-use-face-background)
5733 (setq ps-use-face-background t))
5735 (and (integerp ps-line-number-step)
5736 (<= ps-line-number-step 0)
5737 (setq ps-line-number-step 1))
5738 (setq ps-n-up-on (> ps-n-up-printing 1)
5739 ps-line-number-start (max 1 (min ps-line-number-start
5740 (if (integerp ps-line-number-step)
5742 ps-zebra-stripe-height))))
5745 (set-buffer ps-spool-buffer)
5746 (goto-char (point-max))
5747 (and (re-search-backward "^%%Trailer$" nil t)
5748 (delete-region (match-beginning 0) (point-max))))
5750 (setq ps-zebra-stripe-full-p (memq ps-zebra-stripe-follow
5751 '(full full-follow))
5752 ps-page-postscript 0
5758 ps-showline-count (car ps-printing-region)
5759 ps-line-spacing-internal (ps-get-size ps-line-spacing
5761 ps-paragraph-spacing-internal (ps-get-size ps-paragraph-spacing
5762 "paragraph spacing")
5763 ps-font-size-internal (ps-get-font-size 'ps-font-size)
5764 ps-header-font-size-internal (ps-get-font-size 'ps-header-font-size)
5765 ps-header-title-font-size-internal
5766 (ps-get-font-size 'ps-header-title-font-size)
5767 ps-footer-font-size-internal (ps-get-font-size 'ps-footer-font-size)
5768 ps-control-or-escape-regexp
5769 (cond ((eq ps-print-control-characters '8-bit)
5770 (string-as-unibyte "[\000-\037\177-\377]"))
5771 ((eq ps-print-control-characters 'control-8-bit)
5772 (string-as-unibyte "[\000-\037\177-\237]"))
5773 ((eq ps-print-control-characters 'control)
5776 ;; Set the color scale. We do it here instead of in the defvar so
5777 ;; that ps-print can be dumped into emacs. This expression can't be
5778 ;; evaluated at dump-time because X isn't initialized.
5779 ps-color-p (and ps-print-color-p (ps-color-device))
5780 ps-print-color-scale (if ps-color-p
5781 (float (car (ps-color-values "white")))
5783 ps-default-background (ps-rgb-color
5785 ((or (member ps-print-color-p
5787 (eq genfunc 'ps-generate-postscript))
5789 ((eq ps-default-bg 'frame-parameter)
5790 (ps-frame-parameter nil 'background-color))
5791 ((eq ps-default-bg t)
5792 (ps-face-background-name 'default))
5797 ps-default-foreground (ps-rgb-color
5799 ((or (member ps-print-color-p
5801 (eq genfunc 'ps-generate-postscript))
5803 ((eq ps-default-fg 'frame-parameter)
5804 (ps-frame-parameter nil 'foreground-color))
5805 ((eq ps-default-fg t)
5806 (ps-face-foreground-name 'default))
5811 ps-foreground-list (mapcar
5813 (ps-rgb-color arg "unspecified-fg" 0.0))
5814 (append (and (not (member ps-print-color-p
5817 (list ps-default-foreground
5819 ps-default-color (and (not (member ps-print-color-p
5821 ps-default-foreground)
5822 ps-current-color ps-default-color
5823 ;; Set up default functions.
5824 ;; They may be overridden by ps-mule-begin-job.
5825 ps-basic-plot-string-function 'ps-basic-plot-string
5826 ps-encode-header-string-function nil)
5827 ;; initialize page dimensions
5828 (ps-get-page-dimensions)
5831 (equal ps-default-background ps-default-foreground)
5834 "`ps-default-fg' and `ps-default-bg' have the same color.\n"
5835 "Text won't appear on page. Please, check these variables."))))
5838 (defun ps-page-number ()
5839 (if ps-print-only-one-header
5840 (1+ (/ (1- ps-page-column) ps-number-of-columns))
5844 (defsubst ps-end-page ()
5845 (ps-output "EndPage\nEndDSCPage\n"))
5848 (defsubst ps-next-page ()
5854 (defun ps-end-sheet ()
5855 (and ps-print-page-p (> ps-page-sheet 0)
5856 (ps-output "EndSheet\n")))
5859 (defun ps-header-sheet ()
5860 ;; Print only when a new sheet begins.
5862 (setq ps-page-sheet (1+ ps-page-sheet))
5863 (when (ps-print-sheet-p)
5864 (setq ps-page-order (1+ ps-page-order))
5865 (ps-output (if ps-n-up-on
5866 (format "\n%%%%Page: (%d \\(%d\\)) %d\n"
5867 ps-page-order ps-page-postscript ps-page-order)
5868 (format "\n%%%%Page: %d %d\n"
5869 ps-page-postscript ps-page-order))
5870 ;; spooling needs to redefine Lines and PageCount on each page
5871 "/Lines 0 def\n/PageCount 0 def\n"
5872 (format "%d BeginSheet\nBeginDSCPage\n"
5873 ps-n-up-printing))))
5876 (defun ps-header-page ()
5877 ;; set total line and page number when printing has finished
5878 ;; (see `ps-generate')
5879 (if (zerop (mod ps-page-column ps-number-of-columns))
5881 (setq ps-page-postscript (1+ ps-page-postscript))
5882 (when (ps-print-page-p)
5884 (if (zerop (mod ps-page-n-up ps-n-up-printing))
5885 ;; Print only when a new sheet begins.
5888 (run-hooks 'ps-print-begin-sheet-hook))
5889 ;; Print only when a new page begins.
5890 (ps-output "BeginDSCPage\n")
5891 (run-hooks 'ps-print-begin-page-hook))
5892 (ps-background ps-page-postscript)
5893 (setq ps-page-n-up (1+ ps-page-n-up))
5894 (and ps-print-page-p
5895 (setq ps-page-printed (1+ ps-page-printed)))))
5896 ;; Print only when a new column begins.
5897 (ps-output "BeginDSCPage\n")
5898 (run-hooks 'ps-print-begin-column-hook))
5899 (setq ps-page-column (1+ ps-page-column)))
5901 (defun ps-begin-page ()
5902 (setq ps-width-remaining ps-print-width
5903 ps-height-remaining ps-print-height)
5907 (ps-output (format "/LineNumber %d def\n" ps-showline-count)
5908 (format "/PageNumber %d def\n" (ps-page-number)))
5910 (when ps-print-header
5911 (ps-generate-header "HeaderLinesLeft" "/h0" "/h1" ps-left-header)
5912 (ps-generate-header "HeaderLinesRight" "/h0" "/h1" ps-right-header)
5913 (ps-output (format "%d SetHeaderLines\n" ps-header-lines)))
5915 (when ps-print-footer
5916 (ps-generate-header "FooterLinesLeft" "/H0" "/H0" ps-left-footer)
5917 (ps-generate-header "FooterLinesRight" "/H0" "/H0" ps-right-footer)
5918 (ps-output (format "%d SetFooterLines\n" ps-footer-lines)))
5920 (ps-output (number-to-string ps-lines-printed) " BeginPage\n")
5921 (ps-set-font ps-current-font)
5922 (ps-set-bg ps-current-bg)
5923 (ps-set-color ps-current-color))
5925 (defsubst ps-skip-newline (limit)
5926 (setq ps-showline-count (1+ ps-showline-count)
5927 ps-lines-printed (1+ ps-lines-printed))
5928 (and (< (point) limit)
5931 (defsubst ps-next-line ()
5932 (setq ps-showline-count (1+ ps-showline-count)
5933 ps-lines-printed (1+ ps-lines-printed))
5934 (let* ((paragraph-p (and ps-paragraph-regexp
5935 (looking-at ps-paragraph-regexp)))
5936 (lh (+ (ps-line-height 'ps-font-for-text)
5938 ps-paragraph-spacing-internal
5939 ps-line-spacing-internal))))
5940 (if (< ps-height-remaining lh)
5942 (setq ps-width-remaining ps-print-width
5943 ps-height-remaining (- ps-height-remaining lh))
5944 (ps-output (if paragraph-p "PHL\n" "LHL\n")))))
5946 (defun ps-continue-line ()
5947 (setq ps-lines-printed (1+ ps-lines-printed))
5948 (let ((lh (+ (ps-line-height 'ps-font-for-text) ps-line-spacing-internal)))
5949 (if (< ps-height-remaining lh)
5951 (setq ps-width-remaining ps-print-width
5952 ps-height-remaining (- ps-height-remaining lh))
5953 (ps-output "SL\n"))))
5955 (defun ps-find-wrappoint (from to char-width)
5956 (let ((avail (truncate (/ ps-width-remaining char-width)))
5959 (cons to (* todo char-width))
5960 (cons (+ from avail) ps-width-remaining))))
5962 (defun ps-basic-plot-str (from to string)
5963 (let* ((wrappoint (ps-find-wrappoint from to
5964 (ps-avg-char-width 'ps-font-for-text)))
5965 (to (car wrappoint))
5966 (str (substring string from to)))
5967 (ps-output-string str)
5971 (defun ps-basic-plot-string (from to &optional bg-color)
5972 (let* ((wrappoint (ps-find-wrappoint from to
5973 (ps-avg-char-width 'ps-font-for-text)))
5974 (to (car wrappoint))
5975 (string (buffer-substring-no-properties from to)))
5976 (ps-output-string string)
5980 (defun ps-basic-plot-whitespace (from to &optional bg-color)
5981 (let* ((wrappoint (ps-find-wrappoint from to
5982 (ps-space-width 'ps-font-for-text)))
5983 (to (car wrappoint)))
5984 (ps-output (format "%d W\n" (- to from)))
5987 (defun ps-plot (plotfunc from to &optional bg-color)
5989 (let* ((wrappoint (funcall plotfunc from to bg-color))
5990 (plotted-to (car wrappoint))
5991 (plotted-width (cdr wrappoint)))
5992 (setq from plotted-to
5993 ps-width-remaining (- ps-width-remaining plotted-width))
5995 (ps-continue-line))))
5996 (if ps-razzle-dazzle
5997 (let* ((q-todo (- (point-max) (point-min)))
5998 (q-done (- (point) (point-min)))
5999 (chunkfrac (/ q-todo 8))
6000 (chunksize (min chunkfrac 1000)))
6001 (if (> (- q-done ps-razchunk) chunksize)
6003 (setq ps-razchunk q-done)
6004 (message "Formatting...%3d%%"
6006 (/ (* 100 q-done) q-todo)
6007 (/ q-done (/ q-todo 100)))
6010 (defvar ps-last-font nil)
6012 (defun ps-set-font (font)
6013 (setq ps-last-font (format "f%d" (setq ps-current-font font)))
6014 (ps-output (format "/%s F\n" ps-last-font)))
6016 (defun ps-set-bg (color)
6017 (if (setq ps-current-bg color)
6018 (ps-output (format ps-color-format
6019 (nth 0 color) (nth 1 color) (nth 2 color))
6021 (ps-output "false BG\n")))
6023 (defun ps-set-color (color)
6024 (setq ps-current-color (or color ps-default-foreground))
6025 (ps-output (format ps-color-format
6026 (nth 0 ps-current-color)
6027 (nth 1 ps-current-color) (nth 2 ps-current-color))
6031 (defsubst ps-plot-string (string)
6032 (ps-plot 'ps-basic-plot-str 0 (length string) string))
6035 (defvar ps-current-effect 0)
6037 (defvar ps-print-translation-table
6038 (let ((tbl (make-char-table 'translation-table nil)))
6039 (if (and (boundp 'ucs-mule-8859-to-mule-unicode)
6040 (char-table-p ucs-mule-8859-to-mule-unicode))
6043 (if (and v (eq (char-charset v) 'latin-iso8859-1) (/= k v))
6045 ucs-mule-8859-to-mule-unicode))
6047 "Translation table for PostScript printing.
6048 The default value is a table that translates non-Latin-1 Latin characters
6049 to the equivalent Latin-1 characters.")
6051 (defun ps-plot-region (from to font &optional fg-color bg-color effects)
6052 (or (equal font ps-current-font)
6055 ;; Specify a foreground color only if:
6057 ;; it's different than the background (if `ps-fg-validate-p' is non-nil)
6058 ;; and it's different than the current.
6059 (let ((fg (or fg-color ps-default-foreground)))
6060 (if ps-fg-validate-p
6061 (let ((bg (or bg-color ps-default-background))
6062 (el ps-foreground-list))
6063 (while (and el (equal fg bg))
6066 (or (equal fg ps-current-color)
6069 (or (equal bg-color ps-current-bg)
6070 (ps-set-bg bg-color))
6072 ;; Specify effects (underline, overline, box, etc.)
6074 ((not (integerp effects))
6075 (ps-output "0 EF\n")
6076 (setq ps-current-effect 0))
6077 ((/= effects ps-current-effect)
6078 (ps-output (number-to-string effects) " EF\n")
6079 (setq ps-current-effect effects)))
6081 ;; Starting at the beginning of the specified region...
6085 ;; ...break the region up into chunks separated by tabs, linefeeds,
6086 ;; pagefeeds, control characters, and plot each chunk.
6088 ;; skip lines between cut markers
6089 (and ps-begin-cut-regexp ps-end-cut-regexp
6090 (looking-at ps-begin-cut-regexp)
6092 (goto-char (match-end 0))
6093 (and (re-search-forward ps-end-cut-regexp to 'noerror)
6094 (= (following-char) ?\n)
6096 (setq from (point))))
6097 (if (re-search-forward ps-control-or-escape-regexp to t)
6098 ;; region with some control characters or some multi-byte characters
6099 (let* ((match-point (match-beginning 0))
6100 (match (char-after match-point)))
6101 (when (< from match-point)
6102 (ps-plot ps-basic-plot-string-function
6103 from match-point bg-color))
6105 ((= match ?\t) ; tab
6106 (let ((linestart (line-beginning-position)))
6108 (setq from (+ linestart (current-column)))
6109 (when (re-search-forward "[ \t]+" to t)
6110 (ps-plot 'ps-basic-plot-whitespace
6111 from (+ linestart (current-column))
6114 ((= match ?\n) ; newline
6115 (if (looking-at "\f[^\n]")
6116 ;; \n\ftext\n ==>> next page, but keep line counting!!
6118 (ps-skip-newline to)
6120 ;; \n\f\n ==>> it'll be handled by form feed
6121 ;; \ntext\n ==>> next line
6124 ((= match ?\f) ; form feed
6125 ;; do not skip page if previous character is NEWLINE and
6126 ;; it is a beginning of page.
6127 (unless (and (equal (char-after (1- match-point)) ?\n)
6128 (= ps-height-remaining ps-print-height))
6129 ;; \f\n ==>> skip \n, but keep line counting!!
6130 (and (equal (following-char) ?\n)
6131 (ps-skip-newline to))
6134 (t ; characters from 127 to 255
6135 (ps-control-character match)))
6136 (setq from (point)))
6137 ;; region without control characters
6138 (ps-plot ps-basic-plot-string-function from to bg-color)
6141 (defvar ps-string-control-codes
6142 (let ((table (make-vector 256 nil))
6144 ;; control character
6145 (while (<= char ?\037)
6146 (aset table char (format "^%c" (+ char ?@)))
6147 (setq char (1+ char)))
6148 ;; printable character
6149 (while (< char ?\177)
6150 (aset table char (format "%c" char))
6151 (setq char (1+ char)))
6153 (aset table char "^?")
6155 (while (<= (setq char (1+ char)) ?\377)
6156 (aset table char (format "\\%o" char)))
6158 "Vector used to map characters to a printable string.")
6160 (defun ps-control-character (char)
6161 (let* ((str (aref ps-string-control-codes char))
6165 (char-width (ps-avg-char-width 'ps-font-for-text))
6166 (wrappoint (ps-find-wrappoint from to char-width)))
6167 (if (< (car wrappoint) to)
6169 (setq ps-width-remaining (- ps-width-remaining (* len char-width)))
6170 (ps-output-string str)
6171 (ps-output " S\n")))
6174 (defsubst ps-face-foreground-color-p (attr)
6175 (memq attr '(foreground-color :foreground)))
6178 (defsubst ps-face-background-color-p (attr)
6179 (memq attr '(background-color :background)))
6182 (defsubst ps-face-color-p (attr)
6183 (memq attr '(foreground-color :foreground background-color :background)))
6186 (defun ps-face-attributes (face)
6187 "Return face attribute vector.
6189 If FACE is not in `ps-print-face-extension-alist' or in
6190 `ps-print-face-alist', insert it on `ps-print-face-alist' and
6191 return the attribute vector.
6193 If FACE is not a valid face name, use default face."
6195 (ps-black-white-faces-alist
6196 (or (and (symbolp face)
6197 (cdr (assq face ps-black-white-faces-alist)))
6198 (vector 0 nil nil)))
6200 (cdr (or (assq face ps-print-face-extension-alist)
6201 (assq face ps-print-face-alist)
6202 (let* ((the-face (if (facep face) face 'default))
6203 (new-face (ps-screen-to-bit-face the-face)))
6204 (or (and (eq the-face 'default)
6205 (assq the-face ps-print-face-alist))
6206 (setq ps-print-face-alist
6207 (cons new-face ps-print-face-alist)))
6209 ((ps-face-foreground-color-p (car face))
6210 (vector 0 (cdr face) nil))
6211 ((ps-face-background-color-p (car face))
6212 (vector 0 nil (cdr face)))
6214 (vector 0 nil nil))))
6217 (defun ps-face-background (face background)
6218 (and (cond ((eq ps-use-face-background t)) ; always
6219 ((null ps-use-face-background) nil) ; never
6220 ;; ps-user-face-background is a symbol face list
6222 (memq face ps-use-face-background))
6224 (or (ps-face-color-p (car face))
6227 (if (or (memq (car face) ps-use-face-background)
6228 (ps-face-color-p (car face)))
6231 (setq face (cdr face))))
6239 (defun ps-face-attribute-list (face-or-list)
6242 ((not (listp face-or-list))
6243 (ps-face-attributes face-or-list))
6244 ;; only foreground color, not a `real' face
6245 ((ps-face-foreground-color-p (car face-or-list))
6246 (vector 0 (cdr face-or-list) nil))
6247 ;; only background color, not a `real' face
6248 ((ps-face-background-color-p (car face-or-list))
6249 (vector 0 nil (cdr face-or-list)))
6253 foreground background face-attr face)
6255 (setq face (car face-or-list)
6256 face-or-list (cdr face-or-list)
6257 face-attr (ps-face-attributes face)
6258 effects (logior effects (aref face-attr 0)))
6259 (or foreground (setq foreground (aref face-attr 1)))
6261 (setq background (ps-face-background face (aref face-attr 2)))))
6262 (vector effects foreground background)))))
6265 (defconst ps-font-type (vector nil 'bold 'italic 'bold-italic))
6268 (defun ps-plot-with-face (from to face)
6270 ((null face) ; print text with null face
6271 (ps-plot-region from to 0))
6272 ((eq face 'emacs--invisible--face)) ; skip invisible text!!!
6273 (t ; otherwise, text has a valid face
6274 (let* ((face-bit (ps-face-attribute-list face))
6275 (effect (aref face-bit 0))
6276 (foreground (aref face-bit 1))
6277 (background (ps-face-background face (aref face-bit 2)))
6278 (fg-color (if (and ps-color-p foreground)
6279 (ps-color-scale foreground)
6281 (bg-color (and ps-color-p background
6282 (ps-color-scale background))))
6285 (ps-font-number 'ps-font-for-text
6286 (or (aref ps-font-type (logand effect 3))
6288 fg-color bg-color (lsh effect -2)))))
6292 ;; Ensure that face-list is fbound.
6293 (or (fboundp 'face-list) (defalias 'face-list 'list-faces))
6296 (defun ps-build-reference-face-lists ()
6297 ;; Ensure that face database is updated with faces on
6298 ;; `font-lock-face-attributes' (obsolete stuff)
6299 (ps-font-lock-face-attributes)
6300 ;; Now, rebuild reference face lists
6301 (setq ps-print-face-alist nil)
6302 (if ps-auto-font-detect
6303 (mapc 'ps-map-face (face-list))
6304 (mapc 'ps-set-face-bold ps-bold-faces)
6305 (mapc 'ps-set-face-italic ps-italic-faces)
6306 (mapc 'ps-set-face-underline ps-underlined-faces))
6307 (setq ps-build-face-reference nil))
6310 (defun ps-set-face-bold (face)
6311 (ps-set-face-attribute face 1))
6313 (defun ps-set-face-italic (face)
6314 (ps-set-face-attribute face 2))
6316 (defun ps-set-face-underline (face)
6317 (ps-set-face-attribute face 4))
6320 (defun ps-set-face-attribute (face effect)
6321 (let ((face-bit (cdr (ps-map-face face))))
6322 (aset face-bit 0 (logior (aref face-bit 0) effect))))
6325 (defun ps-map-face (face)
6326 (let* ((face-map (ps-screen-to-bit-face face))
6327 (ps-face-bit (cdr (assq (car face-map) ps-print-face-alist))))
6329 ;; if face exists, merge both
6330 (let ((face-bit (cdr face-map)))
6331 (aset ps-face-bit 0 (logior (aref ps-face-bit 0) (aref face-bit 0)))
6332 (or (aref ps-face-bit 1) (aset ps-face-bit 1 (aref face-bit 1)))
6333 (or (aref ps-face-bit 2) (aset ps-face-bit 2 (aref face-bit 2))))
6334 ;; if face does not exist, insert it
6335 (setq ps-print-face-alist (cons face-map ps-print-face-alist)))
6339 (defun ps-screen-to-bit-face (face)
6341 (vector (logior (if (ps-face-bold-p face) 1 0) ; bold
6342 (if (ps-face-italic-p face) 2 0) ; italic
6343 (if (ps-face-underlined-p face) 4 0)) ; underline
6344 (ps-face-foreground-name face)
6345 (ps-face-background-name face))))
6348 ;; to avoid compilation gripes
6349 (defalias 'ps-jitify 'jit-lock-fontify-now)
6350 (defalias 'ps-lazify 'lazy-lock-fontify-region)
6353 ;; to avoid compilation gripes
6354 (defun ps-print-ensure-fontified (start end)
6355 (cond ((and (boundp 'jit-lock-mode) (symbol-value 'jit-lock-mode))
6356 (ps-jitify start end))
6357 ((and (boundp 'lazy-lock-mode) (symbol-value 'lazy-lock-mode))
6358 (ps-lazify start end))))
6361 (defun ps-generate-postscript-with-faces (from to)
6362 ;; Some initialization...
6363 (setq ps-current-effect 0)
6365 ;; Build the reference lists of faces if necessary.
6366 (when (or ps-always-build-face-reference
6367 ps-build-face-reference)
6368 (message "Collecting face information...")
6369 (ps-build-reference-face-lists))
6371 ;; Black/white printer.
6372 (setq ps-black-white-faces-alist nil)
6373 (and (eq ps-print-color-p 'black-white)
6374 (ps-extend-face-list ps-black-white-faces nil
6375 'ps-black-white-faces-alist))
6377 ;; Generate some PostScript.
6379 (narrow-to-region from to)
6380 (ps-print-ensure-fontified from to)
6381 (ps-generate-postscript-with-faces1 from to)))
6383 (defun ps-generate-postscript (from to)
6384 (ps-plot-region from to 0))
6386 (defun ps-generate (buffer from to genfunc)
6388 (let ((from (min to from))
6390 ;; This avoids trouble if chars with read-only properties
6391 ;; are copied into ps-spool-buffer.
6392 (inhibit-read-only t))
6394 (narrow-to-region from to)
6395 (and ps-razzle-dazzle
6396 (message "Formatting...%3d%%" (setq ps-razchunk 0)))
6397 (setq ps-source-buffer buffer
6398 ps-spool-buffer (get-buffer-create ps-spool-buffer-name))
6399 (ps-init-output-queue)
6400 (let (safe-marker completed-safely needs-begin-file)
6403 (set-buffer ps-spool-buffer)
6404 (set-buffer-multibyte nil)
6406 ;; Get a marker and make it point to the current end of the
6407 ;; buffer, If an error occurs, we'll delete everything from
6408 ;; the end of this marker onwards.
6409 (setq safe-marker (make-marker))
6410 (set-marker safe-marker (point-max))
6412 (goto-char (point-min))
6413 (or (looking-at (regexp-quote ps-adobe-tag))
6414 (setq needs-begin-file t))
6416 (set-buffer ps-source-buffer)
6418 (let ((ps-print-page-p t)
6419 ps-even-or-odd-pages)
6420 (ps-begin-job genfunc)
6421 (when needs-begin-file
6423 (ps-mule-initialize))
6424 (ps-mule-begin-job from to)
6425 (ps-selected-pages)))
6427 (funcall genfunc from to)
6430 (ps-end-job needs-begin-file)
6432 ;; Setting this variable tells the unwind form that the
6433 ;; the PostScript was generated without error.
6434 (setq completed-safely t))
6436 ;; Unwind form: If some bad mojo occurred while generating
6437 ;; PostScript, delete all the PostScript that was generated.
6438 ;; This protects the previously spooled files from getting
6440 (and (markerp safe-marker) (not completed-safely)
6442 (set-buffer ps-spool-buffer)
6443 (delete-region (marker-position safe-marker) (point-max))))))
6445 (and ps-razzle-dazzle (message "Formatting...done"))))))
6448 (defun ps-end-job (needs-begin-file)
6449 (let ((ps-print-page-p t))
6452 (let ((pages-per-sheet (mod ps-page-printed ps-n-up-printing))
6453 (total-lines (cdr ps-printing-region))
6454 (total-pages (ps-page-number)))
6455 (set-buffer ps-spool-buffer)
6456 (let (case-fold-search)
6457 ;; Back to the PS output buffer to set the last page n-up printing
6458 (goto-char (point-max))
6459 (and (> pages-per-sheet 0)
6460 (re-search-backward "^[0-9]+ BeginSheet$" nil t)
6461 (replace-match (format "%d BeginSheet" pages-per-sheet) t))
6462 ;; Back to the PS output buffer to set the page count
6463 (goto-char (point-min))
6464 (while (re-search-forward "^/Lines 0 def\n/PageCount 0 def$" nil t)
6465 (replace-match (format "/Lines %d def\n/PageCount %d def"
6466 total-lines total-pages) t)))))
6468 (and ps-spool-duplex (= (mod ps-page-order 2) 1)
6469 (let ((ps-n-up-printing 0))
6471 (ps-output "/PrintHeader false def\n/ColumnIndex 0 def\n"
6472 "/PrintLineNumber false def\n"
6473 (number-to-string ps-lines-printed) " BeginPage\n")
6475 ;; Set end of PostScript file
6477 (ps-output "\n%%Trailer\n%%Pages: "
6479 (if (and needs-begin-file
6480 ps-banner-page-when-duplexing)
6483 "\n\nEndDoc\n\n%%EOF\n")
6484 (and ps-end-with-control-d
6487 ;; disable selected pages
6488 (setq ps-selected-pages nil))
6491 ;; Permit dynamic evaluation at print time of `ps-lpr-switches'.
6492 (defun ps-do-despool (filename)
6493 (if (or (not (boundp 'ps-spool-buffer))
6494 (not (symbol-value 'ps-spool-buffer)))
6495 (message "No spooled PostScript to print")
6498 (and ps-razzle-dazzle (message "Saving..."))
6499 (set-buffer ps-spool-buffer)
6500 (setq filename (expand-file-name filename))
6501 (let ((coding-system-for-write 'raw-text-unix))
6502 (write-region (point-min) (point-max) filename))
6503 (and ps-razzle-dazzle (message "Wrote %s" filename)))
6504 ;; Else, spool to the printer
6505 (and ps-razzle-dazzle (message "Printing..."))
6507 (set-buffer ps-spool-buffer)
6508 (let* ((coding-system-for-write 'raw-text-unix)
6509 (ps-printer-name (or ps-printer-name
6510 (and (boundp 'printer-name)
6511 (symbol-value 'printer-name))))
6513 (append (if (listp ps-lpr-switches)
6515 (list ps-lpr-switches))
6516 (and (stringp ps-printer-name)
6517 (string< "" ps-printer-name)
6519 (and (stringp ps-printer-name-option)
6520 ps-printer-name-option)
6521 ps-printer-name))))))
6522 (or (stringp ps-printer-name)
6523 (setq ps-printer-name nil))
6524 (apply (or ps-print-region-function 'call-process-region)
6525 (point-min) (point-max) ps-lpr-command nil
6526 (and (fboundp 'start-process) 0)
6528 (ps-flatten-list ; dynamic evaluation
6529 (mapcar 'ps-eval-switch ps-lpr-switches)))))
6530 (and ps-razzle-dazzle (message "Printing...done")))
6531 (kill-buffer ps-spool-buffer)))
6533 ;; Dynamic evaluation
6534 (defun ps-eval-switch (arg)
6535 (cond ((stringp arg) arg)
6536 ((functionp arg) (apply arg nil))
6537 ((symbolp arg) (symbol-value arg))
6538 ((consp arg) (apply (car arg) (cdr arg)))
6541 ;; `ps-flatten-list' is defined here (copied from "message.el" and
6542 ;; enhanced to handle dotted pairs as well) until we can get some
6543 ;; sensible autoloads, or `flatten-list' gets put somewhere decent.
6545 ;; (ps-flatten-list '((a . b) c (d . e) (f g h) i . j))
6546 ;; => (a b c d e f g h i j)
6548 (defun ps-flatten-list (&rest list)
6549 (ps-flatten-list-1 list))
6551 (defun ps-flatten-list-1 (list)
6552 (cond ((null list) nil)
6553 ((consp list) (append (ps-flatten-list-1 (car list))
6554 (ps-flatten-list-1 (cdr list))))
6557 (defun ps-kill-emacs-check ()
6559 (and (setq ps-buffer (get-buffer ps-spool-buffer-name))
6560 (buffer-name ps-buffer) ; check if it's not killed
6561 (buffer-modified-p ps-buffer)
6562 (y-or-n-p "Unprinted PostScript waiting; print now? ")
6564 (and (setq ps-buffer (get-buffer ps-spool-buffer-name))
6565 (buffer-name ps-buffer) ; check if it's not killed
6566 (buffer-modified-p ps-buffer)
6567 (not (yes-or-no-p "Unprinted PostScript waiting; exit anyway? "))
6568 (error "Unprinted PostScript"))))
6570 (cond ((fboundp 'add-hook)
6571 (funcall 'add-hook 'kill-emacs-hook 'ps-kill-emacs-check))
6573 (message "Won't override existing `kill-emacs-hook'"))
6575 (setq kill-emacs-hook 'ps-kill-emacs-check)))
6578 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
6579 ;; To make this file smaller, some commands go in a separate file.
6580 ;; But autoload them here to make the separation invisible.
6582 ;;;### (autoloads (ps-mule-end-job ps-mule-begin-job ps-mule-initialize
6583 ;;;;;; ps-multibyte-buffer) "ps-mule" "ps-mule.el" "ba0ba38bf1f9831ca12701290fd4b211")
6584 ;;; Generated autoloads from ps-mule.el
6586 (defvar ps-multibyte-buffer nil "\
6587 *Specifies the multi-byte buffer handling.
6591 nil This is the value to use the default settings;
6592 by default, this only works to print buffers with
6593 only ASCII and Latin characters. But this default
6594 setting can be changed by setting the variable
6595 `ps-mule-font-info-database-default' differently.
6596 The initial value of this variable is
6597 `ps-mule-font-info-database-latin' (see
6600 `non-latin-printer' This is the value to use when you have a Japanese
6601 or Korean PostScript printer and want to print
6602 buffer with ASCII, Latin-1, Japanese (JISX0208 and
6603 JISX0201-Kana) and Korean characters. At present,
6604 it was not tested with the Korean characters
6605 printing. If you have a korean PostScript printer,
6608 `bdf-font' This is the value to use when you want to print
6609 buffer with BDF fonts. BDF fonts include both latin
6610 and non-latin fonts. BDF (Bitmap Distribution
6611 Format) is a format used for distributing X's font
6612 source file. BDF fonts are included in
6613 `intlfonts-1.2' which is a collection of X11 fonts
6614 for all characters supported by Emacs. In order to
6615 use this value, be sure to have installed
6616 `intlfonts-1.2' and set the variable
6617 `bdf-directory-list' appropriately (see ps-bdf.el for
6618 documentation of this variable).
6620 `bdf-font-except-latin' This is like `bdf-font' except that it uses
6621 PostScript default fonts to print ASCII and Latin-1
6622 characters. This is convenient when you want or
6623 need to use both latin and non-latin characters on
6624 the same buffer. See `ps-font-family',
6625 `ps-header-font-family' and `ps-font-info-database'.
6627 Any other value is treated as nil.")
6629 (custom-autoload 'ps-multibyte-buffer "ps-mule" t)
6631 (autoload 'ps-mule-initialize "ps-mule" "\
6632 Initialize global data for printing multi-byte characters.
6636 (autoload 'ps-mule-begin-job "ps-mule" "\
6637 Start printing job for multi-byte chars between FROM and TO.
6638 It checks if all multi-byte characters in the region are printable or not.
6640 \(fn FROM TO)" nil nil)
6642 (autoload 'ps-mule-end-job "ps-mule" "\
6643 Finish printing job for multi-byte chars.
6649 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
6653 ;; arch-tag: fb06a585-1112-4206-885d-a57d95d50579
6654 ;;; ps-print.el ends here