imagecolormatch(3) [php man page]

IMAGECOLORMATCH(3)							 1							IMAGECOLORMATCH(3)

imagecolormatch - Makes the colors of the palette version of an image more closely match the true color version

SYNOPSIS

       bool imagecolormatch (resource  $image1, resource  $image2)

DESCRIPTION

	Makes the colors of the palette version of an image more closely match the true color version.

PARAMETERS

	      o $image1
		- A truecolor image link resource.

	      o $image2
		- A palette image link resource pointing to an image that has the same size as $image1.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      imagecolormatch(3) example

	      <?php
	      // Setup the true color and palette images
	      $im1 = imagecreatefrompng('./gdlogo.png');
	      $im2 = imagecreate(imagesx($im1), imagesy($im1));

	      // Add some colors to $im2
	      $colors	= Array();
	      $colors[] = imagecolorallocate($im2, 255, 36, 74);
	      $colors[] = imagecolorallocate($im2, 40, 0, 240);
	      $colors[] = imagecolorallocate($im2, 82, 100, 255);
	      $colors[] = imagecolorallocate($im2, 84, 63, 44);

	      // Match these colors with the true color image
	      imagecolormatch($im1, $im2);

	      // Free from memory
	      imagedestroy($im1);
	      imagedestroy($im2);
	      ?>

NOTES

       Note

	      This function requires GD 2.0.1 or later (2.0.28 or later is recommended).

SEE ALSO

       imagecreatetruecolor(3).

PHP Documentation Group 													IMAGECOLORMATCH(3)

IMAGECOLORALLOCATE(3)							 1						     IMAGECOLORALLOCATE(3)

imagecolorallocate - Allocate a color for an image

SYNOPSIS

       int imagecolorallocate (resource  $image, int  $red, int  $green, int  $blue)

DESCRIPTION

	Returns a color identifier representing the color composed of the given RGB components.

       imagecolorallocate(3) must be called to create each color that is to be used in the image represented by $image.

       Note

	       The first call to imagecolorallocate(3) fills the background color in palette-based images - images created using imagecreate(3).

PARAMETERS

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

	      o $red
		-Value of red component.

	      o $green
		-Value of green component.

	      o $blue
		-Value of blue component.

	These parameters are integers between 0 and 255 or hexadecimals between 0x00 and 0xFF.

RETURN VALUES

	A color identifier or FALSE if the allocation failed.

       Warning

	      This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on
	      Booleans for more information. Use the === operator for testing the return value of this function.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.1.3	|						    |
       |	|						    |
       |	|  Returns FALSE if the allocation  failed.  Previ- |
       |	| ously -1 was returned.			    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      imagecolorallocate(3) example

	      <?php

	      $im = imagecreate(100, 100);

	      // sets background to red
	      $background = imagecolorallocate($im, 255, 0, 0);

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

	      // hexadecimal way
	      $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
	      $black = imagecolorallocate($im, 0x00, 0x00, 0x00);

	      ?>

SEE ALSO

       imagecolorallocatealpha(3), imagecolordeallocate(3).

PHP Documentation Group 												     IMAGECOLORALLOCATE(3)