imagestring

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

imagestring — Desenha uma string na horizontal

Descrição

imagestring(
    GdImage$image,
    GdFont|int$font,
    int$x,
    int$y,
    string$string,
    int$color
): bool

Desenha uma string nas coordenadas informadas.

Parâmetros

image: Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
font: Pode ser 1, 2, 3, 4, 5 para as fontes nativas na codificação latin2 (onde números maiores correspondem a fontes maiores) ou uma instância de GdFont, retornada por imageloadfont().
x: Coordenada x do canto superior esquerdo.
y: Coordenada y do canto superior esquerdo.
string: A string a ser desenhada.
color: Um identificador de cor criado com imagecolorallocate().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão	Descrição
8.1.0	O parâmetro `font` agora aceita uma instância de GdFont ou um int; anteriormente, apenas int era aceito.
8.0.0	O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource`gd` válido era esperado.

Exemplos

Exemplo #1 Exemplo de imagestring()

<?php
// Cria uma imagem 100*30
$im = imagecreate(100, 30);

// Fundo branco e texto azul
$bg = imagecolorallocate($im, 255, 255, 255);
$textcolor = imagecolorallocate($im, 0, 0, 255);

// Desenha o texto no canto superior esquerdo
imagestring($im, 5, 0, 0, 'Hello world!', $textcolor);

// Mostra a imagem
header('Content-type: image/png');

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

O exemplo acima produzirá algo semelhante a:

Veja Também

imagestringup() - Desenha uma string na vertical
imageloadfont() - Carrega uma nova fonte
imagettftext() - Escreve texto na imagem usando fontes TrueType