ps_begin_pattern(3) [debian man page]

PS_BEGIN_PATTERN(3)					     Library Functions Manual					       PS_BEGIN_PATTERN(3)

NAME

       PS_begin_pattern -- Starts a new pattern

SYNOPSIS

       #include <pslib.h>

       int PS_begin_pattern(PSDoc *psdoc, float width, float height, float xstep, float ystep, int painttype)

DESCRIPTION

       A  pattern  can	be thought of like a color for drawing and filling.  Actually, PS_setcolor is used to apply a pattern.	The pattern itself
       has given dimension an a stepping in horizontal and vertical direction. The stepping comes into effect when the area to be fill	is  larger
       than  the  pattern  itself. In such a case the pattern will be repeated with a distance of xstep in horizontal and ystep in vertical direc-
       tion.

       Each call of PS_begin_pattern must be accompanied by a call to PS_end_pattern(3).

RETURN VALUE

       Returns identifier of the pattern or zero in case of an error.  The identifier is a positiv number greater 0.

SEE ALSO

       PS_end_pattern(3), PS_set_color(3)

AUTHOR

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

															       PS_BEGIN_PATTERN(3)

PS_BEGIN_PATTERN(3)							 1						       PS_BEGIN_PATTERN(3)

ps_begin_pattern - Start a new pattern

SYNOPSIS

       int ps_begin_pattern (resource  $psdoc, float  $width, float  $height, float  $xstep, float  $ystep, int  $painttype)

DESCRIPTION

	Starts	a  new pattern. A pattern is like a page containing e.g. a drawing which can be used for filling areas. It is used like a color by
       calling ps_setcolor(3) and setting the color space to pattern.

PARAMETERS

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

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

	      o $height
		- The height of the pattern in pixel.

	      o $x-step
		- The distance in pixel of placements of the pattern in horizontal direction.

	      o $y-step
		- The distance in pixel of placements of the pattern in vertical direction.

	      o $painttype
		- Must be 1 or 2.

RETURN VALUES

	The identifier of the pattern or FALSE on failure.

EXAMPLES

       Example #1

	      Creating and using a pattern

	      <?php
	      $ps = ps_new();

	      if (!ps_open_file($ps, "pattern.ps")) {
		print "Cannot open PostScript file
";
		exit;
	      }

	      ps_set_parameter($ps, "warning", "true");
	      ps_set_info($ps, "Creator", "pattern.php");
	      ps_set_info($ps, "Author", "Uwe Steinmann");
	      ps_set_info($ps, "Title", "Pattern example");

	      $pspattern = ps_begin_pattern($ps, 10.0, 10.0, 10.0, 10.0, 1);
	      ps_setlinewidth($ps, 0.2);
	      ps_setcolor($ps, "stroke", "rgb", 0.0, 0.0, 1.0, 0.0);
	      ps_moveto($ps, 0, 0);
	      ps_lineto($ps, 7, 7);
	      ps_stroke($ps);
	      ps_moveto($ps, 0, 7);
	      ps_lineto($ps, 7, 0);
	      ps_stroke($ps);
	      ps_end_pattern($ps);

	      ps_begin_page($ps, 596, 842);
	      ps_setcolor($ps, "both", "pattern", $pspattern, 0.0, 0.0, 0.0);
	      ps_rect($ps, 50, 400, 200, 200);
	      ps_fill($ps);
	      ps_end_page($ps);

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

SEE ALSO

       ps_end_pattern(3), ps_setcolor(3), ps_shading_pattern(3).

PHP Documentation Group 												       PS_BEGIN_PATTERN(3)