imageconvolution(3) [php man page]

IMAGECONVOLUTION(3)							 1						       IMAGECONVOLUTION(3)

imageconvolution - Apply a 3x3 convolution matrix, using coefficient and offset

SYNOPSIS

       bool imageconvolution (resource	$image, array  $matrix, float  $div, float  $offset)

DESCRIPTION

	Applies a convolution matrix on the image, using the given coefficient and offset.

PARAMETERS

	      o $
		image -An image resource, returned by one of the image creation functions, such as imagecreatetruecolor(3).

	      o $matrix
		- A 3x3 matrix: an array of three arrays of three floats.

	      o $div
		- The divisor of the result of the convolution, used for normalization.

	      o $offset
		- Color offset.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Embossing the PHP.net logo

	      <?php
	      $image = imagecreatefromgif('http://www.php.net/images/php.gif');

	      $emboss = array(array(2, 0, 0), array(0, -1, 0), array(0, 0, -1));
	      imageconvolution($image, $emboss, 1, 127);

	      header('Content-Type: image/png');
	      imagepng($image, null, 9);
	      ?>

	      The above example will output:[NOT DISPLAYABLE MEDIA]Output of example : Embossing the PHP.net logo

       Example #2

	      Gaussian blur

	      <?php
	      $image = imagecreatetruecolor(180,40);

	      // Writes the text and apply a gaussian blur on the image
	      imagestring($image, 5, 10, 8, 'Gaussian Blur Text', 0x00ff00);
	      $gaussian = array(array(1.0, 2.0, 1.0), array(2.0, 4.0, 2.0), array(1.0, 2.0, 1.0));
	      imageconvolution($image, $gaussian, 16, 0);

	      // Rewrites the text for comparison
	      imagestring($image, 5, 10, 18, 'Gaussian Blur Text', 0x00ff00);

	      header('Content-Type: image/png');
	      imagepng($image, null, 9);
	      ?>

	      The above example will output:[NOT DISPLAYABLE MEDIA]Output of example : Gaussian blur

NOTES

       Note

	      This function is only available if PHP is compiled with the bundled version of the GD library.

SEE ALSO

       imagefilter(3).

PHP Documentation Group 												       IMAGECONVOLUTION(3)

IMAGEFLIP(3)								 1							      IMAGEFLIP(3)

imageflip - Flips an image using a given mode

SYNOPSIS

       bool imageflip (resource  $image, int  $mode)

DESCRIPTION

	Flips the $image image using the given $mode.

PARAMETERS

	      o $
		image -An image resource, returned by one of the image creation functions, such as imagecreatetruecolor(3).

	      o $mode
		- Flip mode, this can be one of the IMG_FLIP_* constants:

	      +--------------------+---------------------------------------------------+
	      |     Constant	   |						       |
	      | 		   |						       |
	      | 		   |			  Meaning		       |
	      | 		   |						       |
	      +--------------------+---------------------------------------------------+
	      | 		   |						       |
	      |IMG_FLIP_HORIZONTAL |						       |
	      | 		   |						       |
	      | 		   |	       Flips the image horizontally.	       |
	      | 		   |						       |
	      | 		   |						       |
	      | IMG_FLIP_VERTICAL  |						       |
	      | 		   |						       |
	      | 		   |		Flips the image vertically.	       |
	      | 		   |						       |
	      | 		   |						       |
	      |   IMG_FLIP_BOTH    |						       |
	      | 		   |						       |
	      | 		   |  Flips  the  image  both  horizontally and verti- |
	      | 		   | cally.					       |
	      | 		   |						       |
	      +--------------------+---------------------------------------------------+
RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Flips an image vertically

	       This example uses the IMG_FLIP_VERTICAL constant.

	      <?php
	      // File
	      $filename = 'phplogo.png';

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

	      // Load
	      $im = imagecreatefrompng($filename);

	      // Flip it vertically
	      imageflip($im, IMG_FLIP_VERTICAL);

	      // Output
	      imagejpeg($im);
	      imagedestroy($im);
	      ?>

	      The above example will output something similar to:[NOT DISPLAYABLE MEDIA]Output of example: Vertically flipped image

       Example #2

	      Flips the image horizontally

	       This example uses the IMG_FLIP_HORIZONTAL constant.

	      <?php
	      // File
	      $filename = 'phplogo.png';

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

	      // Load
	      $im = imagecreatefrompng($filename);

	      // Flip it horizontally
	      imageflip($im, IMG_FLIP_HORIZONTAL);

	      // Output
	      imagejpeg($im);
	      imagedestroy($im);
	      ?>

	      The above example will output something similar to:[NOT DISPLAYABLE MEDIA]Output of example: Horizontally flipped image

NOTES

       Note

	      This function is only available if PHP is compiled with the bundled version of the GD library.

PHP Documentation Group 													      IMAGEFLIP(3)