imagepalettetotruecolor

Converts a palette based image to true color

&reftitle.description; `bool` `imagepalettetotruecolor` `GdImage` `image`

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

&reftitle.parameters;

&gd.image.description;
&reftitle.returnvalues;

Returns &true; if the convertion was complete, or if the source image already is a true color image, otherwise &false; is returned.

&reftitle.changelog;

&Version; | &Description;
&gd.changelog.image-param;

&reftitle.examples;

### Converts any image object 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);
    ?>

&example.outputs;

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

&reftitle.seealso;

- `imagecreatetruecolor`
- `imageistruecolor`