PSTOPS(1) User Commands PSTOPS(1) NAME pstops - shuffle pages in a PostScript file SYNOPSIS pstops [ -q ] [ -b ] [ -w_w_i_d_t_h ] [ -h_h_e_i_g_h_t ] [ -p_p_a_p_e_r ] [ -d_l_w_i_d_t_h ] _p_a_g_e_s_p_e_c_s [ _i_n_f_i_l_e [ _o_u_t_f_i_l_e ] ] DESCRIPTION _P_s_t_o_p_s rearranges pages from a PostScript document, creating a new PostScript file. The input PostScript file should follow the Adobe Document Structuring Conventions. _P_s_t_o_p_s 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. _p_a_g_e_s_p_e_c_s follow the syntax: _p_a_g_e_s_p_e_c_s = [_m_o_d_u_l_o:]_s_p_e_c_s _s_p_e_c_s = _s_p_e_c[+_s_p_e_c_s][,_s_p_e_c_s] _s_p_e_c = [-]_p_a_g_e_n_o[_L][_R][_U][@_s_c_a_l_e][(_x_o_f_f,_y_o_f_f)] _m_o_d_u_l_o is the number of pages in each block. The value of _m_o_d_u_l_o should be greater than 0; the default value is 1. _s_p_e_c_s are the page specifications for the pages in each block. The value of the _p_a_g_e_n_o in each _s_p_e_c should be between 0 (for the first page in the block) and _m_o_d_u_l_o-1 (for the last page in each block) inclusive. The optional dimensions _x_o_f_f and _y_o_f_f shift the page by the specified amount. _x_o_f_f and _y_o_f_f are in PostScript's points, but may be followed by the units cm or in to convert to centimetres or inches, or the flag w or h to specify as a multiple of the width or height. The optional parameters _L, _R, and _U rotate the page left, right, or upside-down. The optional _s_c_a_l_e parameter scales the page by the fraction specified. If the optional minus sign is specified, the page is rela- tive to the end of the document, instead of the start. If page _s_p_e_cs are separated by + the pages will be merged into one page; if they are separated by , they will be on separate pages. If there is only one page specification, with _p_a_g_e_n_o zero, the _p_a_g_e_n_o may be omitted. The shift, rotation, and scaling are performed in that order regardless of which order they appear on the command line. The -_w option gives the width which is used by the w dimen- sion specifier, and the -_h option gives the height which is used by the h dimension specifier. These dimensions are also used (after scaling) to set the clipping path for each page. SunOS 5.5 Last change: PSUtils Release 1 Patchlevel 16 1 PSTOPS(1) User Commands PSTOPS(1) 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. The -_b option prevents any bind operators in the PostScript prolog from binding. This may be needed in cases where com- plex multi-page re-arrangements are being done. The -_d option draws a line around the border of each page, of the specified width. If the _l_w_i_d_t_h 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 up or down with the rest of the page. Pstops normally prints the page numbers of the pages re- arranged; the -_q option suppresses this. EXAMPLES This section contains some sample re-arrangements. To put two pages on one sheet (of A4 paper), the pagespec to use is: 2:0L@.7(21cm,0)+1L@.7(21cm,14.85cm) To select all of the odd pages in reverse order, use: 2:-0 To re-arrange pages for printing 2-up booklets, use 4:-3L@.7(21cm,0)+0L@.7(21cm,14.85cm) for the front sides, and 4:1L@.7(21cm,0)+-2L@.7(21cm,14.85cm) for the reverse sides (or join them with a comma for duplex printing). AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 SEE ALSO psbook(1), psselect(1), pstops(1), epsffit(1), psnup(1), psresize(1), psmerge(1), fixscribeps(1), getafm(1), fixdlsrps(1), fixfmps(1), fixmacps(1), fixpsditps(1), fixpspps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), extractres(1), includeres(1) TRADEMARKS PostScript is a trademark of Adobe Systems Incorporated. SunOS 5.5 Last change: PSUtils Release 1 Patchlevel 16 2 PSTOPS(1) User Commands PSTOPS(1) BUGS _P_s_t_o_p_s does not accept all DSC comments. SunOS 5.5 Last change: PSUtils Release 1 Patchlevel 16 3