Cria uma nova imagem a partir de um arquivo ou URL

# imagecreatefrompng

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecreatefrompng — Cria uma nova imagem a partir de um arquivo ou URL

### Descrição

function imagecreatefrompng(string `$filename`): GdImage|false

imagecreatefrompng() retorna um identificador de imagem que representa a imagem obtida a partir do nome de arquivo fornecido.

Dica

Uma URL pode ser usada como um nome de arquivo com esta função se os empacotadores fopen estiverem habilitados. Consulte a função fopen() para mais detalhes sobre como especificar o nome do arquivo. Consulte os Protocolos e empacotadores suportados para obter links para informações sobre as capacidades de cada empacotador, notas de uso e informações sobre quaisquer variáveis predefinidas que eles possam fornecer.

### Parâmetros

`filename`

  Caminho para a imagem PNG

### Valor Retornado

Retorna um objeto de imagem em caso de sucesso, `false` em caso de erros.

### Registro de Alterações

Versão | Descrição
--- | ---
8.0.0 | Caso for sucesso, esta função agora retorna uma instância de GDImage; anteriormente, era retornado um resource.

### Exemplos

Exemplo #1 Exemplo de como lidar com um erro durante o carregamento de uma imagem PNG

    <?php
    function LoadPNG($imgname)
    {
        /* Tentativa de abrir */
        $im = @imagecreatefrompng($imgname);

        /* Verificar se falhou */
        if(!$im)
        {
            /* Crie uma imagem em branco */
            $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, 'Erro ao carregar ' . $imgname, $tc);
        }

        return $im;
    }

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

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

    imagepng($img);
    ?>

O exemplo acima produzirá algo semelhante a:

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open