bionic (3) PS_begin_page.3.gz

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)