imagecharup

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

imagecharup — Desenha um caractere verticalmente

Descrição

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

Desenha o caractere char verticalmente na coordenada especificada na imagem informada em image.

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 imagecharup()

<?php

$im = imagecreate(100, 100);

$string = 'Note que a primeira letra é um N';

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

// mostra um "Z" na cor preta em um fundo branco
imagecharup($im, 3, 10, 10, $string, $black);

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

?>

O exemplo acima produzirá algo semelhante a:

Veja Também

imagechar() - Desenha um caractere horizontalmente
imageloadfont() - Carrega uma nova fonte