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.

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