Desenha uma string na vertical

# imagestringup

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

imagestringup — Desenha uma string na vertical

### Descrição

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

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

Sempre retorna `true`.

### 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 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');
    ?>

O exemplo acima produzirá algo semelhante a:

### Veja Também

- imagestring() - Desenha uma string na horizontal
- imageloadfont() - Carrega uma nova fonte

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open