imagecreatefrompng

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

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

Descrição

imagecreatefrompng(string $filename): GdImage|false

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

Tip

Uma URL pode ser usada como um nome de arquivo com esta função se os wrappers 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 wrapper, 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

Example #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);
imagedestroy($img);
?>

O exemplo acima produzirá algo semelhante a:

imagecreatefrompng() exemplo