Forum und email

imagettftext

(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: {) 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.

Example#1 Exemplo imagettftext()

<?php
  header
("Content-type: image/jpeg");
  
$im imagecreate(40030);
  
$white imagecolorallocate($im255255255);
  
$black imagecolorallocate($im000);
  
  
// Replace path by your own font path
  
imagettftext($im2001020$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().