imagecreate

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

imagecreate — Crie uma nova imagem baseada em paleta

Descrição

imagecreate(int $width, int $height): GdImage|false

imagecreate() retorna um identificador de imagem que representa uma imagem em branco do tamanho especificado.

Em geral, recomendamos o uso de imagecreatetruecolor() em vez de imagecreate() para que o processamento da imagem ocorra na mais alta qualidade possível. Se você deseja gerar uma imagem paletizada, então imagetruecolortopalette() deve ser chamada imediatamente antes de salvar a imagem com imagepng() ou imagegif().

Parâmetros

width

A largura da imagem.

height

A altura da imagem.

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 Em caso de sucesso, esta função agora retorna uma instância de GDImage; anteriormente, era retornado um resource.

Exemplos

Example #1 Criando um novo stream de imagem GD e exibindo uma imagem. 

<?php
header("Content-Type: image/png");
$im = @imagecreate(110, 20)
    or die("Não é possível inicializar um novo stream de imagem GD.");
$background_color = imagecolorallocate($im, 0, 0, 0);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);
imagepng($im);
imagedestroy($im);
?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: criando um novo stream de imagem GD e exibindo uma imagem.

Veja Também