ps_begin_template

(PECL ps >= 1.2.0)

ps_begin_templateStart a new template

Description

int ps_begin_template ( resource $psdoc , float $width , float $height )

Starts a new template. A template is called a form in the postscript language. It is created similar to a pattern but used like an image. Templates are often used for drawings which are placed several times through out the document, e.g. like a company logo. All drawing functions may be used within a template. The template will not be drawn until it is placed by ps_place_image().

Parameters

psdoc

Resource identifier of the postscript file as returned by ps_new().

width

The width of the template in pixel.

height

The height of the template in pixel.

Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example #1 Creating and using a template

<?php
$ps 
ps_new();

if (!
ps_open_file($ps"template.ps")) {
  print 
"Cannot open PostScript file\n";
  exit;
}

ps_set_parameter($ps"warning""true");
ps_set_info($ps"Creator""template.php");
ps_set_info($ps"Author""Uwe Steinmann");
ps_set_info($ps"Title""Template example");

$pstemplate ps_begin_template($ps30.030.0);
ps_moveto($ps00);
ps_lineto($ps3030);
ps_moveto($ps030);
ps_lineto($ps300);
ps_stroke($ps);
ps_end_template($ps);

ps_begin_page($ps596842);
ps_place_image($ps$pstemplate20.020.01.0);
ps_place_image($ps$pstemplate50.030.00.5);
ps_place_image($ps$pstemplate70.070.00.6);
ps_place_image($ps$pstemplate30.050.01.3);
ps_end_page($ps);

ps_close($ps);
ps_delete($ps);
?>

See Also