imagepalettecopy
imagepng
GD and Image Functions
PHP Manual

# imagepalettetotruecolor

Converts a palette based image to true color

### Description

bool imagepalettetotruecolor ( resource `$src` )

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

### Parameters

`image`

  An image resource, returned by one of the image creation functions, such as imagecreatetruecolor.

### 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
- imageistruecolor