imageftbbox

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

imageftbbox通过 freetype2 使用字体给出文本的边界框

说明

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

此函数计算并返回 FreeType 文本的边界框(以像素为单位)。

注意:

在 PHP 8.0.0 之前,imageftbbox()imagettfbbox() 的扩展变体,它还支持 options。 自 PHP 8.0.0 起,imagettfbbox()imageftbbox() 的别名。

参数

size

字体的尺寸,单位:点(磅)。

angle

测量的 string 的角度(以度为单位)。

font_filename

TrueType 字体文件的名称(可以是 URL)。根据 PHP 使用的 GD 库的版本,可能会尝试搜索没有以“/”开头并会在末尾追加“.ttf”的文件名,并沿着库定义的字体路径搜索。

string

要测量的字符串。

options

options 可能的数组索引
类型 含义
linespacing float 定义绘制行距

返回值

imageftbbox() 返回包含 8 个元素的数组,代表构成文本边界框的四个点:

0 左下角,X 坐标
1 左下角,Y 坐标
2 右下角,X 坐标
3 右下角,Y 坐标
4 右上角,X 坐标
5 右上角, Y 坐标
6 左上角,X 坐标
7 左上角,Y 坐标

无论 angle 如何,这些点都是相对于 text,因此“左上角”意味着在左上角水平地看到文本。

失败时,返回 false

示例

示例 #1 imageftbbox() 示例

<?php
// Create a 300x150 image
$im = imagecreatetruecolor(300, 150);
$black = imagecolorallocate($im, 0, 0, 0);
$white = imagecolorallocate($im, 255, 255, 255);

// Set the background to be white
imagefilledrectangle($im, 0, 0, 299, 299, $white);

// Path to our font file
$font = './arial.ttf';

// First we create our bounding box
$bbox = imageftbbox(10, 0, $font, 'The PHP Documentation Group');

// This is our cordinates for X and 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');

// Output to browser
header('Content-Type: image/png');

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

注释

注意: 此函数仅在 PHP 编译时加入 freetype 支持时有效(--with-freetype-dir=DIR)。

参见

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top