Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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://www.freebsd.org/cgi/man.cgi?query=PS_begin_page&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help