php man page for imageloadfont

IMAGELOADFONT(3)							 1							  IMAGELOADFONT(3)

imageloadfont - Load a new font

SYNOPSIS
       int imageloadfont (string  $file)

DESCRIPTION
       imageloadfont(3) loads a user-defined bitmap and returns its identifier.

PARAMETERS
	      o $file
		-  The	font file format is currently binary and architecture dependent. This means you should generate the font files on the same
		type of CPU as the machine you are running PHP on.

	      Font file format

	      +--------------+--------------------------------------+---+
	      |byte position |					    |	|
	      | 	     |					    |	|
	      | 	     |		   C data type		    |	|
	      | 	     |					    |	|
	      | 	     |		   description		    |	|
	      | 	     |					    |	|
	      +--------------+--------------------------------------+---+
	      |  byte 0-3    |					    |	|
	      | 	     |					    |	|
	      | 	     |		       int		    |	|
	      | 	     |					    |	|
	      | 	     |	 number of characters in the font   |	|
	      | 	     |					    |	|
	      |  byte 4-7    |					    |	|
	      | 	     |					    |	|
	      | 	     |		       int		    |	|
	      | 	     |					    |	|
	      | 	     |	value of  first  character  in	the |	|
	      | 	     | font (often 32 for space)	    |	|
	      | 	     |					    |	|
	      |  byte 8-11   |					    |	|
	      | 	     |					    |	|
	      | 	     |		       int		    |	|
	      | 	     |					    |	|
	      | 	     |	  pixel width of each character     |	|
	      | 	     |					    |	|
	      | byte 12-15   |					    |	|
	      | 	     |					    |	|
	      | 	     |		       int		    |	|
	      | 	     |					    |	|
	      | 	     |	  pixel height of each character    |	|
	      | 	     |					    |	|
	      |  byte 16-    |					    |	|
	      | 	     |					    |	|
	      | 	     |		       char		    |	|
	      | 	     |					    |	|
	      | 	     |	array with character data, one byte |	|
	      | 	     | per pixel in each character,  for  a |	|
	      | 	     | total	of    (nchars*width*height) |	|
	      | 	     | bytes.				    |	|
	      | 	     |					    |	|
	      +--------------+--------------------------------------+---+
RETURN VALUES
	The font identifier which is always bigger than 5 to avoid conflicts with built-in fonts or FALSE on errors.

EXAMPLES
       Example #1

	      imageloadfont(3) usage example

	      <?php
	      // Create a new image instance
	      $im = imagecreatetruecolor(50, 20);
	      $black = imagecolorallocate($im, 0, 0, 0);
	      $white = imagecolorallocate($im, 255, 255, 255);

	      // Make the background white
	      imagefilledrectangle($im, 0, 0, 49, 19, $white);

	      // Load the gd font and write 'Hello'
	      $font = imageloadfont('./04b.gdf');
	      imagestring($im, $font, 0, 0, 'Hello', $black);

	      // Output to browser
	      header('Content-type: image/png');

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

SEE ALSO
       imagefontwidth(3), imagefontheight(3).

PHP Documentation Group 													  IMAGELOADFONT(3)