PS_BEGIN_PAGE(3)

      uwe@steinmann.cx
UWE STEINMANN 2003Uwe SteinmannApril 28, 2003;

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.