NAME

       PS_begin_template — Starts a new template

SYNOPSIS

       #include <pslib.h>

       int PS_begin_template(PSDoc *psdoc, float width, float height)

DESCRIPTION

       Starts  a  new  template which must be ended by PS_end_template(3). 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  PS_end_template(3)  it  can be placed on a page by PS_place_image(3). Templates are
       commonly used for repeating objects like page headers in order to minimize the document size.

       If image reuse is not turned off (since version 0.4.5 of pslib it is always turned on), PS_place_image(3)
                   may also be called within a template in order to include eps or raster images.

RETURN VALUE

       Returns an id for referencing the template.

SEE ALSO

       PS_end_template(3), PS_place_image(3)

AUTHOR

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

                                                                                            PS_BEGIN_TEMPLATE(3)