ps_new2(3) [debian man page]

PS_NEW2(3)						     Library Functions Manual							PS_NEW2(3)

NAME

       PS_new2 -- Creates a new PostScript document object

SYNOPSIS

       #include <pslib.h>

       PSDoc * PS_new2((void  (*errorhandler)(PSDoc *p, int type, const char *msg), void* (*allocproc)(PSDoc *p, size_t size, const char *caller),
       void* (*reallocproc)(PSDoc *p, void *mem, size_t size, const char *caller), void  (*freeproc)(PSDoc *p, void *mem), void   *opaque)

DESCRIPTION

       Creates a new document instance. It does not create the file on disk or in memory. It just sets up everything. You may pass your own  error
       handler	and memory management functions. If you pass NULL values the internal default handler and functions will be used. In such case you
       may as well call PS_new(3).

RETURN VALUE

       Pointer to new instance of PostScript document or NULL on failure.

SEE ALSO

       PS_new(3), PS_get_opaque(3), PS_delete(3)

AUTHOR

       This manual page was written by Uwe Steinmann uwe@steinmann.cx.

																	PS_NEW2(3)

PS_BEGIN_PAGE(3)					     Library Functions Manual						  PS_BEGIN_PAGE(3)

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 pdf-
       marks 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 `Orien-
       tation' 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)