FITPS(local) UNIX Programmer's Manual FITPS(local) NAME fitps - Change dimensions and location of PostScript picture SYNOPSIS fitps [ -l_l_l_x,_l_l_y -u_u_r_x,_u_r_y -m_c|_i -F -D -o <_f_i_l_e_n_a_m_e> ] [ file ] DESCRIPTION _F_i_t_p_s facilitates the alteration of size and positioning of a given PostScript program. The general procedure is to transform the _b_o_u_n_d_i_n_g _b_o_x which is a natural property of a plain PostScript program into another bounding box. The parameters of the intended bounding box must be supplied to _f_i_t_p_s. Information about the original bounding box of the PostScript program must be contained in the %%BoundingBox: llx lly urx ury header comment field of the PostScript pro- gram. Bounding boxes are defined by the coordinates of the lower-left and the upper-right corner. Coordinates of the original bounding box are dimensioned in _n_a_t_u_r_a_l _P_o_s_t_S_c_r_i_p_t _u_n_i_t_s, i.e. 1/72 inches. Metrics for the intended bounding box may be specified in _c_e_n_t_i_m_e_t_e_r_s or _i_n_c_h_e_s. Values may be given in integral or real format. _F_i_t_p_s can be supplied with the necessary parameters in two ways: either in _b_a_t_c_h _m_o_d_e or in _i_n_t_e_r_a_c_t_i_v_e _m_o_d_e. In batch mode, all parameters must be supplied from the command line. In interactive mode, the user is asked for each parameter one by one. This is convenient, because _f_i_t_p_s requires a lot of parameters at the same time. If _f_i_t_p_s detects an error in command line usage, it automatically enters interactive mode. The PostScript program resulting from the transformation of the original program is sent to standard output unless the name of an output file is specified. As the proportions of the original and the intended bounding box are generally different, _f_i_t_p_s operates on a _c_l_o_s_e_s_t _f_i_t basis, i.e. the scale factor for the entire picture is selectet such that the picture will not extend the intended bounding box. There is, however, a special option that allows to completely fit the picture in the intended bound- ing box, which results in a distortion of the picture. The following _o_p_t_i_o_n_s may be used with fitps: -l_l_l_x,_l_l_y X- and Y-coordinates of the lower-left corner of the intended bounding box. Values for X and Y are separated by a comma (no white space). Real numbers have a decimal point, e.g 12.4, 10. or .22. Printed 10/16/87 fitps 1 FITPS(local) UNIX Programmer's Manual FITPS(local) -u_u_r_x,_u_r_y X- and Y-coordinates of the upper-right corner of the intended bounding box. -m_c|_i Metric system for the coordinates. _c indicates centime- ters, _i indicates inches. If this option is omitted, the default metric system (in Europe: centimeters) is assumed. -o The output shall be directed into the file with the given name. If the filename is '-', or the option is omitted, the output is sent to standard output. -D If this option is set, _f_i_t_p_s projects the picture into the entire area of the intended bounding box. This will in almost any case rersult in a distortion of the ori- ginal picture. -F Operate in filter mode. If this option is set, the PostScript program is read from standard input. This works only on UNIX machines. DIAGNOSTICS _F_i_t_p_s complains if the input file does not look like PostScript or if no bounding box information can be located. SEE ALSO mfps(1) BUGS _F_i_t_p_s makes the assumption, that the PostScript program describes just one page. The result for multiple-page docu- ments is undefined. AUTHOR Axel Mahler Technical University Berlin _U_U_C_P: axel@coma.uucp (unido!coma!axel) _B_I_T_N_E_T: axel@db0tui62 Printed 10/16/87 fitps 2