php man page for imagepsbbox

IMAGEPSBBOX(3)								 1							    IMAGEPSBBOX(3)

imagepsbbox - Give the bounding box of a text rectangle using PostScript Type1 fonts

SYNOPSIS
       array imagepsbbox (string  $text, resource  $font, int  $size)

DESCRIPTION
       array imagepsbbox (string  $text, resource  $font, int  $size, int  $space, int	$tightness, float  $angle)

	Gives the bounding box of a text rectangle using PostScript Type1 fonts.

	The  bounding  box  is	calculated using information available from character metrics, and unfortunately tends to differ slightly from the
       results achieved by actually rasterizing the text. If the angle is 0 degrees, you can expect the text to need 1 pixel more to every  direc-
       tion.

PARAMETERS
	      o $text
		- The text to be written.

	      o $font_index
		- A font resource, returned by imagepsloadfont(3).

	      o $size
		-$size is expressed in pixels.

	      o $space
		-  Allows you to change the default value of a space in a font. This amount is added to the normal value and can also be negative.
		Expressed in character space units, where 1 unit is 1/1000th of an em-square.

	      o $tightness
		-$tightness allows you to control the amount of white space between characters. This amount is added to the normal character width
		and can also be negative. Expressed in character space units, where 1 unit is 1/1000th of an em-square.

	      o $angle
		-$angle is in degrees.

RETURN VALUES
	Returns an array containing the following elements:

       +--+--------------------+
       |0 |		       |
       |  |		       |
       |  | left x-coordinate  |
       |  |		       |
       |1 |		       |
       |  |		       |
       |  | upper y-coordinate |
       |  |		       |
       |2 |		       |
       |  |		       |
       |  | right x-coordinate |
       |  |		       |
       |3 |		       |
       |  |		       |
       |  | lower y-coordinate |
       |  |		       |
       +--+--------------------+
EXAMPLES
       Example #1

	      imagepsbbox(3) usage

	      <?php
	      // Create image handle
	      $im = imagecreatetruecolor(200, 200);

	      // Allocate colors
	      $black = imagecolorallocate($im, 0, 0, 0);
	      $white = imagecolorallocate($im, 255, 255, 255);

	      // Load the PostScript Font
	      $font = imagepsloadfont('font.pfm');

	      // Make a bounding box for the font
	      $bbox = imagepsbbox('Sample text is simple', $font, 12);

	      // Define our X and Y cordinates
	      $x = ($bbox[2] / 2) - 10;
	      $y = ($bbox[3] / 2) - 10;

	      // Write the font to the image
	      imagepstext($im, 'Sample text is simple', $font, 12, $black, $white, $x, $y);

	      // Output and free memory
	      header('Content-type: image/png');

	      imagepng($im);
	      imagedestroy($im);
	      ?>

CHANGELOG
       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 7.0.0	|						    |
       |	|						    |
       |	|  T1Lib support was removed from PHP, thrus remov- |
       |	| ing this function.				    |
       |	|						    |
       +--------+---------------------------------------------------+
NOTES
       Note

	      This function is only available if PHP is compiled using --with-t1lib[=DIR].

SEE ALSO
       imagepstext(3).

PHP Documentation Group 													    IMAGEPSBBOX(3)