FORSCHUNGSZENTRUM JÜLICH GmbH Zentralinstitut für Angewandte Mathematik D-52425 Jülich, Tel. (02461) 61–6402 Beratung und Betrieb, Tel. (02461) 61–6400 Technical Information FZJ-ZAM-TKI-0286 Wolfgang Frings 03.02.98 PStools - working with PostScript files 1 Introduction Working with PostScript files is sometimes difficult. The following tools should facilitate this task. Most of them have been written by Angus Duggan and are freeware. Some others have been written at KFA. 2 PSUtils The utilities in this section are able to manipulate PostScript files containing multiple pages. Page selection and rearrangement are supported, including arrangement into signatures for booklet print- ing, and page merging for n-up printing. A known bug of these tools is that they accept most of the DSC comments of the PostScript file but not all. These comments are introducted by ’%%’ e.g. ’%%Page:’. You can use the program ghostview to test whether the tools will work correctly on your PostScript file. If ghostview shows the file with the correct page numbering you can use the tools without problems. In the other case you will have to use one of the filters described in chapter 3 on page 5. The following programs exist: psbook rearranges pages in PostScript file into signatures psresize alters document paper size psselect selects pages and page ranges from a PostScript file psnup puts multiple pages onto each physical sheet of paper pstops performs general page rearrangement and selection in a PostScript file Contents 1 Introduction 1 4 Programs for working with EPS files 6 4.1 epsffit .................... 6 2 PSUtils 1 4.2 epsscale ................... 6 2.1 psbook.................... 2 4.3 epsrot .................... 7 2.2 psresize ................... 2 4.4 makebb ................... 7 2.3 psselect ................... 2 2.4 psnup .................... 3 5 Converters between file formats 7 2.5 pstops .................... 4 5.1 a2ps ..................... 8 5.2 ps2epsi.................... 15 3 Filters 5 5.3 ps2ascii ................... 15 2.1 psbook Syntax psbook [-q ] [-ssignature] [ infile [outfile ] ] Description psbook rearranges pages from a PostScript document into ”‘signatures”’ for printing books or book- lets, creating a new PostScript file. The input PostScript file should follow the Adobe Document Structuring Conventions. The - s option selects the size of signature which will be used. The signa- ture size is the number of sides which will be folded and bound together; the number given should be a multiple of four. The default is to use one signature for the whole file. Extra blank sides will be added if the file does not contain a multiple of four pages. Psbook normally prints the page numbers of the pages rearranged; the - q option suppresses this. Example The following command can be used to rearrange the pages of a document: psbook - 4 in.ps out.ps Then the page ordering is as follows if the document contained 7 pages: *1276345 2.2 psresize Syntax psresize [-w width] [ -hheight ] [ -p paper] [ -W Width] [ -HHeight ] [ -P Paper] [ -q ] [ infile [ outfile ] ] Description psresize rescales and centres a document on a different size of paper. The input PostScript file should follow the Adobe Document Structuring Conventions. The -w option gives the output paper width, and the -h option gives the output paper height, normally specified in cm or in to convert PostScript’s points (1/72 of an inch) to centimeters or inches. The -p option can be used as an alternative, to set the output paper size to a3, a4, a5, b5, letter, legal, or 10x14. The default output paper size is a4. The -W option gives the input paper width, and the -H option gives the input paper height. The -P option can be used as an alternative, so set the input paper size. The default input paper size is a4. Psresize normally prints the page numbers of the pages rearranged; the -q option suppresses this. Examples: The following command can be used to convert a document from size A4 to letter size: psresize -Pa4 -pletter in.ps out.ps If you have a DIN A4-sized document and want to increase the size to 40 cm x 50 cm you have to use the following command: psresize -w40cm -h50cm -Pa4 in.ps out.ps 2.3 psselect Syntax psselect [ -q ] [ -e ] [ -o ] [ -r ] [-ppages] [ pages] [ infile [outfile ] ] Description psselect selects pages from a PostScript document, creating a new PostScript file. The input PostScript file should follow the Adobe Document Structuring Conventions. The -e option selects all of the even pages; it may be used in conjunction with the other page selection options to select the even pages from a range of pages. The -o option selects all of the odd pages; it may be used 2 in conjunction with the other page selection options. The -ppages option specifies the pages which are to be selected. Pages is a comma separated list of page ranges, each of which may be a page number, or a page range of the form first-last. If first is omitted, the first page is assumed, and if last is omitted, the last page is assumed. The prefix character ’ ’ indicates that the page number is relative to the end of the document, counting backwards. The -r option causes psselect to output the selected pages in reverse order. Psselect normally prints the page numbers of the pages rearranged; the -q option suppresses this. If any of the -r, -e, or -o options are specified, the page range must be given with the -p option. This is for backwards compatibility with previous versions. Example To select the pages 3-7 from a document containing 12 pages use: psselect -p3-7 in.ps out.ps Note: The page number given to psselect refers to a numbering starting with one at the beginning or end of the file. The actual page number in the document may be different. 2.4 psnup Syntax psnup [ -w width ] [ -hheight ] [ -p paper ] [ -l ] [ -r ] [ -f ] [ -c ] [-mmargin ] [-bborder ] [-dlwidth ] [ -sscale ] [ nup ] [ -q ] [ pages] [ infile [outfile ] ] Description psnup puts multiple logical pages onto each physical sheet of paper. The input PostScript file should follow the Adobe Document Structuring Conventions. The -w option gives the paper width, an the -h option gives the paper height, normally specified in cm or in to convert PostScript’s points (1/72 of an inch) to centimeters or inches. The -p option can be used as an alternative, to set the paper size to a3, a4, a5, b5, letter, legal, or 10x14. The default paper size is a4. psnup normally uses ’row-major’ layout, where adjacent pages are placed in rows across the paper. The -c option changes the order to ’column-major’, where successive pages are placed in columns down the paper. A margin to leave around the whole page can be specified with the -m option. This is useful for sheets of ’thumbnail’ pages, because the normal page margins are reduced by putting multiple pages on a single sheet. The -b option is used to specify an additional margin around each page on a sheet. The -d option draws a line around the border of each page, of the specified width. If the lwidth parameter is omitted, a default linewidth of 1 point is assumed. The linewidth is relative to the original page dimensions, i.e. it is scaled down with the rest of the page. The scale chosen by psnup can be overridden with the -s option. This is useful to merge pages which are already reduced. The -nup option selects the number of logical pages to put on each sheet of pater. This can be any whole number; psnup tries to optimise the layout so that the minimum amount of space is wasted. If psnup cannot find a layout within its tolerance limit, it will abort with an error message. The alternative form -inup can also be used, for compatibility with other n-up programs, where i is the number of pages. Psselect normally prints the page numbers of the pages rearranged; the -q option suppresses this. Example The use of this utility may vary but two particular applications can be seen in conjunction with psbook(1). For example, using lpr as the UNIX print spooler a typical command line might look like this: psbook file | psnup -2 | lpr Printername If file is a 4 page document this command will result in a two page document printing two pages 3 of file per page and it will rearrange the page order to match the input pages 4 and 1 on the first output page and pages 2 and 3 of the input document on the second output page. Another frequent use of this tool is arranging 4 pages of a document on one sheet of paper, e.g. for course foils. This can be done with the following command: psnup -4 in.ps out.ps 2.5 pstops Syntax pstops [ -q ] [ -b ] [ -w width ] [ -h heigth ] [-dlwidth] pagespecs] [ infile [outfile ] ] Description pstops rearranges pages from a PostScript document, creating a new PostScript file. The input PostScript file should follow the Adobe Document Structuring Conventions. pstops can be used to perform a large number of arbitrary re-arrangements of Documents, including arranging for printing 2-up, 4-up, booklets, reversing, selecting front or back sides of documents, scaling, etc. pagespecs follow the syntax: pagespecs = [modulo:] specs specs = spec [ +specs ] [ ,specs ] spec = [-] pageno [ L ] [ R ] [ U ] [ @scale ] [ (xoff,yoff) ] modulo is the number of pages in each block. The value of modulo should be greater than 0; the default value is 1. specs are the page specifications for the pages in each block. The value of the pageno in each spec should be between 0 (for the first page in the block) and modulo-1 (for the last page in each block) inclusive.