imagecreatefrompng

&gd.image.new;

&reftitle.description; ``GdImage``false```imagecreatefrompng` `string` `filename`

`imagecreatefrompng` returns an image identifier representing the image obtained from the given filename.

&tip.fopen-wrapper;
&reftitle.parameters;

`filename`

- Path to the PNG image.

&reftitle.returnvalues;

&gd.return.identifier;

&reftitle.changelog;

&Version; | &Description;
8.0.0 | On success, this function returns a `GDImage` instance now; previously, a `resource` was returned.

&reftitle.examples;

### Example to handle an error during loading of a PNG

    <?php
    function LoadPNG($imgname)
    {
        /* Attempt to open */
        $im = @imagecreatefrompng($imgname);

        /* See if it failed */
        if(!$im)
        {
            /* Create a blank image */
            $im  = imagecreatetruecolor(150, 30);
            $bgc = imagecolorallocate($im, 255, 255, 255);
            $tc  = imagecolorallocate($im, 0, 0, 0);

            imagefilledrectangle($im, 0, 0, 150, 30, $bgc);

            /* Output an error message */
            imagestring($im, 1, 5, 5, 'Error loading ' . $imgname, $tc);
        }

        return $im;
    }

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

    $img = LoadPNG('bogus.image');

    imagepng($img);
    imagedestroy($img);
    ?>

&example.outputs.similar; imagecreatefrompng() example