casa-mp-base
Public
Commits
Christopher Chavez authored and Chris Jones committed fe200f744f3
| 1 - | --- psbind.orig 2017-01-05 00:05:19.000000000 -0600 |
| 2 - | +++ psbind 2017-01-05 00:14:10.000000000 -0600 |
| 3 - | |
| 4 - | |
| 5 - | psbind |
| 6 - | |
| 7 - | -=back 4 |
| 8 - | +=back |
| 9 - | |
| 10 - | By default, C<psbind> reads a PostScript document from |
| 11 - | standard input and reformats it 2-up (i.e., placing two input pages on |
| 12 - | |
| 13 - | |
| 14 - | Fine-tune output formatting (e.g., C<psbind --margin=2cm>), margin detection (e.g., C<psbind --sample=2-10>), and other options. |
| 15 - | |
| 16 - | -=back 4 |
| 17 - | +=back |
| 18 - | |
| 19 - | The rest of this document describes how. |
| 20 - | |
| 21 - | |
| 22 - | |
| 23 - | psbind |
| 24 - | |
| 25 - | -=back 4 |
| 26 - | +=back |
| 27 - | |
| 28 - | =item * |
| 29 - | |
| 30 - | |
| 31 - | |
| 32 - | psbind I<input-file-name> |
| 33 - | |
| 34 - | -=back 4 |
| 35 - | +=back |
| 36 - | |
| 37 - | =item * |
| 38 - | |
| 39 - | |
| 40 - | |
| 41 - | psbind I<input-file-name output-file-name> |
| 42 - | |
| 43 - | -=back 4 |
| 44 - | +=back |
| 45 - | |
| 46 - | -=back 4 |
| 47 - | +=back |
| 48 - | |
| 49 - | You can also send the output directly to a printer. |
| 50 - | |
| 51 - | |
| 52 - | |
| 53 - | Send the transformed PostScript document to the specified printer by invoking C<lpr>. This option cannot be specified in conjunction with an output file name. |
| 54 - | |
| 55 - | -=back 4 |
| 56 - | +=back |
| 57 - | |
| 58 - | =head2 Output formatting options |
| 59 - | |
| 60 - | |
| 61 - | |
| 62 - | Shift each page by an offset, and change the paper size information in the document, so that there is no margin whatsoever in the output document. This option is useful only if the output of C<psbind> is fed into another program for post-processing. |
| 63 - | |
| 64 - | -=back 4 |
| 65 - | +=back |
| 66 - | |
| 67 - | The following option is relevant only when combining pages (C<-N/--nup>) or recentering pages (C<-C/--center>): |
| 68 - | |
| 69 - | |
| 70 - | |
| 71 - | By default, C<psbind> produces output for the default paper size returned by C<paperconf> (if C<libpaperg> is installed), or Letter paper (otherwise). You can use this option to switch to a different paper size: any size known to C<libpaperg> (if it is installed), or A4 or Letter (otherwise). |
| 72 - | |
| 73 - | -=back 4 |
| 74 - | +=back |
| 75 - | |
| 76 - | The following options are relevant only when combining pages (C<-N/--nup>). |
| 77 - | |
| 78 - | |
| 79 - | |
| 80 - | Documents generally look worse when rescaled. This is especially true of documents that contain bitmaps, be them bitmap fonts or bitmap images. The C<--magic> option suppresses the default rescaling behavior of C<psbind> whenever possible. By "whenever possible" we mean whenever the unscaled originals will fit in the output, without taking C<--margin> or C<--border> into account. This option is particularly useful for documents that C<psbind> would normally decide to I<expand> after trimming off margins. |
| 81 - | |
| 82 - | -=back 4 |
| 83 - | +=back |
| 84 - | |
| 85 - | The following options are effective at all times, but probably useful only when combining pages (C<-N/--nup>). |
| 86 - | |
| 87 - | |
| 88 - | |
| 89 - | Some people like to flip through their duplex documents along the short edge of the paper rather than the long edge. This option rotates every other page in the output document by 180 degrees to achieve the effect. |
| 90 - | |
| 91 - | -=back 4 |
| 92 - | +=back |
| 93 - | |
| 94 - | =head2 Margin detection options |
| 95 - | |
| 96 - | |
| 97 - | |
| 98 - | Check if the computed margins seem strange. ("Strange" is defined as: The computed extent of odd-numbered pages, even-numbered pages, or both exceed 1200 PostScript points or fall under 100 PostScript points in either or both dimension.) If they seem strange, run Ghostscript to rewrite the input document, then try detecting the margins again. |
| 99 - | |
| 100 - | -=back 4 |
| 101 - | +=back |
| 102 - | |
| 103 - | The following options allow you to fine-tune this margin detection process. |
| 104 - | |
| 105 - | |
| 106 - | |
| 107 - | By default, C<psbind> first tries to determine margins using the original input document; if this first attempt fails, it then invokes C<fixps --force> to rewrite the document for a second try. To disable C<fixps> invocation altogether, say C<--fix=no>. To invoke C<fixps --force> right away, say C<--fix=force>. To invoke C<fixps> right away (without C<--force>), say C<--fix=yes>. |
| 108 - | |
| 109 - | -=back 4 |
| 110 - | +=back |
| 111 - | |
| 112 - | =head2 Miscellaneous options |
| 113 - | |
| 114 - | |
| 115 - | |
| 116 - | This option makes C<psbind> display complete documentation and do nothing else. |
| 117 - | |
| 118 - | -=back 4 |
| 119 - | +=back |
| 120 - | |
| 121 - | =head1 PREREQUISITES |
| 122 - |