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.