imagechar

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

imagechar — Desenha um caractere horizontalmente

Descrição

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

imagechar() desenha o primeiro caractere de char na imagem identificada por image com seu canto superior esquerdo em x,y (superior esquerdo é 0, 0) com a cor color.

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 início.
y: Coordenada y do início.
char: O caractere a ser desenhado.
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 imagechar()

<?php

$im = imagecreate(100, 100);

$string = 'PHP';

$bg = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);

// mostra um "P" na cor preta no canto superior esquerdo
imagechar($im, 1, 0, 0, $string, $black);

header('Content-type: image/png');
imagepng($im);

?>

O exemplo acima produzirá algo semelhante a:

Veja Também

imagecharup() - Desenha um caractere verticalmente
imageloadfont() - Carrega uma nova fonte