PS_BEGIN_TEMPLATE(3)							 1						      PS_BEGIN_TEMPLATE(3)

ps_begin_template - Start a new template

SYNOPSIS

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

DESCRIPTION

	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  func-
       tions may be used within a template. The template will not be drawn until it is placed by ps_place_image(3).

PARAMETERS

	      o $psdoc
		- Resource identifier of the postscript file as returned by ps_new(3).

	      o $width
		- The width of the template in pixel.

	      o $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
";
		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($ps, 30.0, 30.0);
	      ps_moveto($ps, 0, 0);
	      ps_lineto($ps, 30, 30);
	      ps_moveto($ps, 0, 30);
	      ps_lineto($ps, 30, 0);
	      ps_stroke($ps);
	      ps_end_template($ps);

	      ps_begin_page($ps, 596, 842);
	      ps_place_image($ps, $pstemplate, 20.0, 20.0, 1.0);
	      ps_place_image($ps, $pstemplate, 50.0, 30.0, 0.5);
	      ps_place_image($ps, $pstemplate, 70.0, 70.0, 0.6);
	      ps_place_image($ps, $pstemplate, 30.0, 50.0, 1.3);
	      ps_end_page($ps);

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

SEE ALSO

       ps_end_template(3).

PHP Documentation Group 												      PS_BEGIN_TEMPLATE(3)