PHPerKaigi 2024

imagecharup

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

imagecharupDesenha 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:

Saída do exemplo: imagecharup()

Veja Também

add a note

User Contributed Notes 1 note

up
-7
php at corzoogle dot com
18 years ago
<?php
// incredibly, no one has added this.
// write a string of text vertically on an image..
// ;o)

$string = '(c) corz.org';
$font_size = 2;
$img = imagecreate(20,90);
$bg = imagecolorallocate($img,225,225,225);
$black = imagecolorallocate($img,0,0,0);

$len = strlen($string);
for (
$i=1; $i<=$len; $i++) {
imagecharup($img, $font_size, 5, imagesy($img)-($i*imagefontwidth($font_size)), $string, $black);
$string = substr($string,1);
}
header('Content-type: image/png');
imagepng($img);
imagedestroy($img); // dudes! don't forget this!
?>
To Top