.TH "PS_BEGIN_TEMPLATE" "3" 
.SH "NAME" 
PS_begin_template \(em Starts a new template 
.SH "SYNOPSIS" 
.PP 
#include <pslib.h> 
.PP 
int PS_begin_template(PSDoc *psdoc, float width, float height) 
.SH "DESCRIPTION" 
.PP 
Starts a new template which must be ended by 
\fBPS_end_template(3)\fP. Templates are similar to 
macros which can be placed on a page like images. Within a template one 
can call any drawing function. Once a template has been ended by 
\fBPS_end_template(3)\fP it can be placed on a page 
by \fBPS_place_image(3)\fP. Templates are commonly 
used for repeating objects like page headers in order to minimize 
the document size. 
.PP 
If image reuse is not turned off (since version 0.4.5 of pslib 
it is always turned on), \fBPS_place_image(3)\fP 			may also be called within a template in order to include eps or 
raster images. 
.SH "RETURN VALUE" 
.PP 
Returns an id for referencing the template. 
.SH "SEE ALSO" 
.PP 
PS_end_template(3), PS_place_image(3) 
.SH "AUTHOR" 
.PP 
This manual page was written by Uwe Steinmann uwe@steinmann.cx. 
.\" created by instant / docbook-to-man