FreeBSD Manual Pages
PS_BEGIN_PAGE(3) Library Functions Manual 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 im-
ply a different page size for each page, this is not
possible in PostScript. The first call of PS_be-
gin_page(3) will set the page size for the whole docu-
ment. 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)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=PS_begin_page&sektion=3&manpath=FreeBSD+Ports+15.0>