imagecreatefromjpeg

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

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

Descrição

imagecreatefromjpeg(string $filename): GdImage|false

imagecreatefromjpeg() 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 JPEG.

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 JPEG.

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

    /* Verificar se falhou */
    if(!$im)
    {
        /* Crie uma imagem preta */
        $im  = imagecreatetruecolor(150, 30);
        $bgc = imagecolorallocate($im, 255, 255, 255);
        $tc  = imagecolorallocate($im, 0, 0, 0);

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

        /* Exibir uma mensagem de erro */
        imagestring($im, 1, 5, 5, 'Erro ao carregar ' . $imgname, $tc);
    }

    return $im;
}

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

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

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

O exemplo acima produzirá algo semelhante a:

OSaída do exemplo: Exemplo de como lidar com um erro durante o carregamento de um JPEG.