ps_begin_page(3) [debian man page]

PS_BEGIN_PAGE(3)					     Library Functions Manual						  PS_BEGIN_PAGE(3)

NAME

       PS_begin_page -- Start a new page

SYNOPSIS

       #include <pslib.h>

       void PS_begin_page(PSDoc *psdoc, float width, float height)

DESCRIPTION

       Starts  a  new  page.  Though  the parameters width	     and height imply a different page size for each page, this is not possible in
       PostScript. The first call of PS_begin_page(3) will set the page size for the whole document. Consecutive calls will have no effect, except
       for  creating  a  new page. The situation is different if you indent to convert the PostScript document into PDF. This function places pdf-
       marks into the document which can set the size for each page indiviually. The resulting PDF document will have different page sizes.

       Each page is encapsulated into save/restore. This means, that most of the settings made on one page will not be retained on the next page.

       If there is up to the first call of PS_begin_page(3) no call of PS_findfont(3), then the header of the PostScript document will	be  output
       and  the  bounding  box will be set to the size of the first page.  If PS_findfont(3) was called before the header has been output already,
       the document will not have a valid bounding box. In order to prevent this, one should set the info field 'BoundingBox' and possibly `Orien-
       tation' before any PS_findfont(3) or PS_begin_page(3) calls.

SEE ALSO

       PS_end_page(3), PS_findfont(3), PS_set_info(3)

AUTHOR

       This manual page was written by Uwe Steinmann uwe@steinmann.cx.

																  PS_BEGIN_PAGE(3)

PSRESIZE(1)                                                   General Commands Manual                                                  PSRESIZE(1)

NAME

       psresize - rescales and centers a document for new output paper size

SYNOPSIS

       psresize [ -wwidth ] [ -hheight ] [ -ppaper ] [ -Wwidth ] [ -Hheight ] [ -Ppaper ] [ -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 Struc-
       turing 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 a0, a1, a2, a3, a4, a5, b5, letter, legal, tabloid, statement, executive, folio, quarto 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, to
       set the input paper size.  The default input paper size is a4.

       Psresize normally prints the page numbers of the pages output; the -q option suppresses this.

EXAMPLES

       The following command can be used to convert a document on A4 size paper to letter size paper:

       psresize -PA4 -pletter in.ps out.ps

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), fix-
       psditps(1), fixpspps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), extractres(1), includeres(1), showchar(1)

TRADEMARKS

       PostScript is a trademark of Adobe Systems Incorporated.

BUGS

       Psresize does not accept all DSC comments.

                                                          PSUtils Release 1 Patchlevel 17                                              PSRESIZE(1)