imagepalettetotruecolor(3) [php man page]

IMAGEPALETTETOTRUECOLOR(3)						 1						IMAGEPALETTETOTRUECOLOR(3)

imagepalettetotruecolor - Converts a palette based image to true color

SYNOPSIS

       bool imagepalettetotruecolor (resource  $src)

DESCRIPTION

	Converts a palette based image, created by functions like imagecreate(3) to a true color image, like imagecreatetruecolor(3).

PARAMETERS

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

RETURN VALUES

	Returns TRUE if the convertion was complete, or if the source image already is a true color image, otherwise FALSE is returned.

EXAMPLES

       Example #1

	       Converts any image resource to true color

	      <?php
	      // Backwards compatiblity
	      if(!function_exists('imagepalettetotruecolor'))
	      {
		  function imagepalettetotruecolor(&$src)
		  {
		      if(imageistruecolor($src))
		      {
			  return(true);
		      }

		      $dst = imagecreatetruecolor(imagesx($src), imagesy($src));

		      imagecopy($dst, $src, 0, 0, 0, 0, imagesx($src), imagesy($src));
		      imagedestroy($src);

		      $src = $dst;

		      return(true);
		  }
	      }

	      // Helper closure
	      $typeof = function() use($im)
	      {
		  echo 'typeof($im) = ' . (imageistruecolor($im) ? 'true color' : 'palette'), PHP_EOL;
	      };

	      // Create a palette based image
	      $im = imagecreate(100, 100);
	      $typeof();

	      // Convert it to true color
	      imagepalettetotruecolor($im);
	      $typeof();

	      // Free the memory
	      imagedestroy($im);
	      ?>

	      The above example will output:

	      typeof($im) = palette
	      typeof($im) = true color

SEE ALSO

       imagecreatetruecolor(3), imageistruecolor(3).

PHP Documentation Group 												IMAGEPALETTETOTRUECOLOR(3)