DragonFly On-Line Manual Pages

PS_BEGIN_PAGE(3)					      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 situation is
       different		if you indent to convert the PostScript	 docu-
       ment  into  PDF.	 This function		      places pdfmarks into the
       document	which can set the size for  each  page		       indivi-
       ually.  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)