imagestringup

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

imagestringupDesenha uma string na vertical

Descrição

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

Desenha uma string na vertical 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 inferior esquerdo.

y

Coordenada y do canto inferior esquerdo.

string

O texto 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

Example #1 Exemplo de imagestringup()

<?php
// cria uma imagem 100*100
$im = imagecreatetruecolor(100, 100);

// Desenha o texto
$textcolor = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
imagestringup($im, 3, 40, 80, 'gd library', $textcolor);

// Grava a imagem
imagepng($im, './stringup.png');
imagedestroy($im);
?>

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: imagestringup()

Veja Também