Manual do PHP
Anterior |  | Próxima

# imagettftext

(PHP 3, PHP 4, PHP 5)

imagettftext -- Escreve texto na imagem usando fontes TrueType

## Descrição

array imagettftext ( resource image, float size, float angle, int x, int y, int color, string fontfile, string text )

imagettftext() desenha a string `text` na imagem identificada por `image`, começando nas coordenadas `x`, `y` (o canto superior esquerdo é 0, 0), em um ângulo de `angle` na cor `color`, usando o arquivo de fonte TrueType identificado por `fontfile`. Dependendo de qual versão da biblioteca GD o PHP estiver usando o `fontfile` não começa com '/', '.ttf' será adicionado ao nome do arquivo e a biblioteca tentará encontrar o nome do arquivo entre o caminho de fonte definido na biblioteca.

As coordenadas dadas por `x`, `y` irão definir o ponto base para o primeiro caractere (o canto inferior esquerdo do caractere). Isto é diferente de imagestring(), aonde x, y definem o canto superior direito do primeiro caractere.

`angle` é em graus, sendo 0 graus da esqueda para a direita (direção de 3 horas no relógio), e valores maiores representando um rotação anti-horária. (ex. um valor de 90 irá resultar em um exto de baixo para cima).

`fontfile` é o caminho para a TrueType que você quer usar.

`text` é a string com o texto que pode incluir caracteres UTF-8 (na forma de: &#123;) para acessar caracteres na fonte alem do 255.

`color` é o índice da cor. Usando um índice de cor negativo tem o efeito de desativar o antialiasing.

imagettftext() retorna uma matriz com 8 elementos representando quatro pontos fazendo uma caixa em torno do texto. A ordem dos pontos é inferior esquerdo, inferior direito, superior direito, superior esquerdo. Os pontos são relativos ao texto, sem se importar com o ângulo, assim "superior esquerdo" indica o canto superior esquerdo quando você vê o texto horizontalmente.

Este script de exemplo irá produzir um JPEG predo de 400x30 pixels, com as palavras "Testing..." em branco na fonte Arial.

Exemplo 1. Exemplo imagettftext()
`<?php header("Content-type: image/jpeg"); $im = imagecreate(400, 30); $white = imagecolorallocate($im, 255, 255, 255); $black = imagecolorallocate($im, 0, 0, 0); // Replace path by your own font path imagettftext($im, 20, 0, 10, 20, $black, "/path/arial.ttf", "Testing... Omega: &amp;#937;"); imagejpeg($im); imagedestroy($im); ?>`

Esta função requer a biblioteca GD e a biblioteca FreeType.

Veja também imagettfbbox().

Anterior | Principal | Próxima
imagettfbbox | Acima | imagetypes