Desenha uma string na horizontal

# imagestring

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

imagestring — Desenha uma string na horizontal

### Descrição

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

Desenha uma `string` 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 superior esquerdo.

`y`

  Coordenada y do canto superior esquerdo.

`string`

  A string a ser desenhada.

`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 imagestring()

    <?php
    // Cria uma imagem 100*30
    $im = imagecreate(100, 30);

    // Fundo branco e texto azul
    $bg = imagecolorallocate($im, 255, 255, 255);
    $textcolor = imagecolorallocate($im, 0, 0, 255);

    // Desenha o texto no canto superior esquerdo
    imagestring($im, 5, 0, 0, 'Hello world!', $textcolor);

    // Mostra a imagem
    header('Content-type: image/png');

    imagepng($im);
    ?>

O exemplo acima produzirá algo semelhante a:

### Veja Também

- imagestringup() - Desenha uma string na vertical
- imageloadfont() - Carrega uma nova fonte
- imagettftext() - Escreve texto na imagem usando fontes TrueType

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