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 pdfmarks 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   `Orientation'   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)