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

add a note

User Contributed Notes 1 note

down

-4

php at corzoogle dot com ¶

19 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!
?>

add a note