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 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 situa-
tion 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.1.quarterly>