imageftbbox

    (PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

    imageftbbox — Fornece a caixa limite de um texto usando fontes via freetype2

    Descrição

    imageftbbox(
        float$size,
        float$angle,
        string$font_filename,
        string$string,
        array$options = []
    ): array|false

    Esta função calcula e retorna a caixa limite em pixels para um texto em FreeType.

    Nota:

    Antes do PHP 8.0.0, imageftbbox() era uma variante estendida de imagettfbbox() que suportava adicionalmente o parâmetro options. A partir do PHP 8.0.0, imagettfbbox() é um apelido de imageftbbox().

    Parâmetros

    size

    O tamanho da fonte em pontos.

    angle

    Ângulo em graus no qual a string será medida.

    font_filename

    O nome do arquivo da fonte TrueType (pode ser uma URL). Dependendo de qual versão da biblioteca GD que o PHP estiver usando, pode ser que ele tente pesquisar por arquivos que não iniciem com uma barra '/', anexando a extensão '.ttf' ao nome do arquivo e pesquisando ao longo de um caminho de fonte definido pela biblioteca.

    string

    A string a ser medida.

    options

    Índices de array possíveis para options
    ChaveTipoSignificado
    linespacingfloatDefine o espaçamento entre linhas

    Valor Retornado

    imageftbbox() retorna um array com 8 elementos representando os quatro pontos que definem os limites do texto:

    0canto inferior esquerdo, posição X
    1canto inferior esquerdo, posição Y
    2canto inferior direito, posição X
    3canto inferior direito, posição Y
    4canto superior direito, posição X
    5canto superior direito, posição Y
    6canto superior esquerdo, posição X
    7canto superior esquerdo, posição Y

    Os pontos são relativos ao texto independente do parâmetro angle, portanto "superior esquerdo" significa no canto da parte superior esquerda vendo o texto horizontalmente.

    Em caso de falha, false é retornado.

    Exemplos

    Exemplo #1 Exemplo de imageftbbox()

    <?php
    // Cria uma imagem 300x150
    $im = imagecreatetruecolor(300, 150);
    $black = imagecolorallocate($im, 0, 0, 0);
    $white = imagecolorallocate($im, 255, 255, 255);

    // Define o fundo para branco
    imagefilledrectangle($im, 0, 0, 299, 299, $white);

    // Caminho para o arquivo da fonte
    $font = './arial.ttf';

    // Primeiramente cria-se a caixa limite
    $bbox = imageftbbox(10, 0, $font, 'The PHP Documentation Group');

    // Estas são as coordenadas para X e Y
    $x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) - 5;
    $y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5;

    imagefttext($im, 10, 0, $x, $y, $black, $font, 'The PHP Documentation Group');

    // Mostra no navegador
    header('Content-Type: image/png');

    imagepng($im);
    imagedestroy($im);
    ?>

    Notas

    Nota: Esta função só estará disponível se o PHP for compilado com suporte ao freetype (--with-freetype-dir=DIR).

    Veja Também

    • imagefttext() - Escreve texto em uma imagem usando fontes FreeType 2
    • imagettfbbox() - Fornece a os limites retangulares de um texto usando fontes TrueType
    To Top