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.