debian man page for ps_begin_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)