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 无关，因此“左上角”表示从水平方向看文本时位于左上角。

失败时，返回 **false**。

示例

示例 #1 imageftbbox() 示例

<?php
// 创建一个 300x150 的图像
$im = imagecreatetruecolor(300, 150);
$black = imagecolorallocate($im, 0, 0, 0);
$white = imagecolorallocate($im, 255, 255, 255);

// 将背景设置为白色
imagefilledrectangle($im, 0, 0, 299, 299, $white);

// 我们字体文件的路径
$font = './arial.ttf';

// 首先我们创建边界框
$bbox = imageftbbox(10, 0, $font, 'The PHP Documentation Group');

// 这是我们的 X 和 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');

// 输出到浏览器
header('Content-Type: image/png');

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

注释

注意: 此函数仅在 PHP 编译时包含 FreeType 支持才可用（--with-freetype-dir=DIR）。

参见

imagefttext() - 使用 FreeType 2 字体将文本写入图像
imagettfbbox() - 使用 TrueType 字体获取文本的边界框

改善此页面

了解如何改善此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 8 个注释

上

下

fernando ¶

19 年前

imagettfbbox() 返回一个包含 8 个元素的数组，表示构成文本边界框的四个点

0 左下角，X 位置
1 左下角，Y 位置
2 右下角，X 位置
3 右下角，Y 位置
4 右上角，X 位置
5 右上角，Y 位置
6 左上角，X 位置
7 左上角，Y 位置

这些点是相对于文本的，与角度无关，因此“左上角”表示从水平方向看文本时位于左上角。

上

下

phpimageftbbox at juggernaut dot com dot au ¶

22 年前

此函数可用于生成右对齐文本。只需计算出文本图像的宽度并相应地定位它。示例

$i_width = 200;
$i_height = 40;

$string = "Hello World!";
$pointsize = 10;
$fontfile = "/usr/local/lib/ttf/Helve.ttf";

$im = imagecreate($i_width, $i_height);
$black = imagecolorallocate($im, 0, 0, 0);
$white = imagecolorallocate($im, 255, 255, 255);

$string_size = ImageFtBbox($pointsize, 0, $fontfile, $string, array("linespacing" => 1));
$s_width = $string_size[4];
$s_height = $string_size[5];

ImageFtText($im, $pointsize, 0, $i_width - $s_width - 1, 0 - $s_height, $white, $fontfile, $string, array("linespacing" => 1));

Header ("Content-type: image/png");
ImagePNG ($im);
ImageDestroy ($im);

上

下

sectionthirty1 at yahoo dot com ¶

20 年前

这里有一个我用来将“动态文本”居中到图像上的实用示例。

例如，假设您想将客户的 IP 地址居中到图片上。

$ip=$_SERVER['REMOTE_ADDR'];

$details = imageftbbox($fontsize, 0, $font, $ip, array("linespacing" => 1));

$xcoord = ($imgwidth - $details[4]) / 2; // 这将返回居中于特定图像的 x 坐标。确保将 $imgwidth 设置为所用图像的宽度。

imagettftext($image, $fontsize, 0, $xcoord, $ycoord, $fontcolor, $font, $ip);

上

下

theo v e -2 ¶

18 年前

啊... imageftbbox() 和 imagefttext() 之间的问题在于 y 轴的镜像。
下面您可以看到，对于字体大小为 16，"b"、"p" 和 "bp" 的边界框。
< b: w=9 h=15
b(0,-1)
b(9,-1)
b(9,-16)
b(0,-16)
< p: w=9 h=16
p(0,4)
p(9,4)
p(9,-12)
p(0,-12)
< bp: w=20 h=20
bp(0,4)
bp(20,4)
bp(20,-16)
bp(0,-16)
如果使用 imagefttext() 在 y=0 处绘制 "bp"，则 "bp" 的顶部确实位于 y=-16 处，"bp" 的底部位于 y=4 处。（此处或那里可能会有一个像素的偏差，因为在 y=0 处实际上存在一个可见像素。）

上

下

-1

pablocorezzola at gmail dot com ¶

7 年前

// 示例 - 居中文本

function newText($im, $size, $angle= 0, $x, $y, $color, $font, $text,$align = "left",$border=false,$width=0,$height=0){
    
if($align == "center")
    {
if ($border == true ){
imagerectangle($im, $x, $y, $x +$width, $y + $height, $color);
        }
$bbox = imageftbbox($size, 0, $font, $text);

// 标记宽度和高度
$s_width = $bbox[4];
$s_height = $bbox[5];
        
$y = $y + ($height-$s_height)/2;
$x = $x + ($width-$s_width)/2;

    }
     
imagettftext($im, $size, $angle, $x, $y, $color, $font, $text);
}

上

下

-1

Johan ¶

16 年前

对于对齐，我使用这种方法

if($align == "center" || $align == "right")
    {
$verticaltxtspace = $backwidth - (2 * $posx);
$spacepositions = imagettfbbox($size, $angle, "fonts/verdanaz.ttf", " ");
$spacepx = $spacepositions[4] - $spacepositions[0];
        
// 将文本拆分为行
$lines = split("[\r][\n]", $text);
for($count = 0; $count < count($lines); $count++)
        {
$textpositions = imagettfbbox($size, $angle, "fonts/verdanaz.ttf", $lines[$count]);
$textpx = $textpositions[2] - $textpositions[0];
            
if($align == "right")
            {
$spaces = ($verticaltxtspace - $textpx) / $spacepx;
            }
else if($align == "center")
            {
$spaces = (($verticaltxtspace - $textpx)/2) / $spacepx;
            }
            
// 添加空格
$line = $lines[$count];
for($i = 0; $i < $spaces; $i++)
            {
$line = " " . $line;
            }
$lines[$count] = $line;
        }
        
// 创建新文本行
$text = "";
for($count = 0; $count < count($lines); $count++)
        {
$text .= $lines[$count] . "\r\n";
        }        
    }
    
        
// 在阴影上绘制阴影文本
imagettftext($background, $size, $angle, $posx, $posy, $textcolor, "fonts/verdanaz.ttf", $text);

上

下

-2

ta at NOSPAM dot magicsquare dot info ¶

21 年前

我找到了解决这个问题的方法

看起来高度与行间距成正比，因此您只需将相同的系数应用于图像高度即可

例如

$spacing = 0.7;
$params = array("linespacing" => $spacing);

$box = imageftbbox ($size, 0, $font, $text, $params);
$tw=$box[4]-$box[0]; // 图像宽度
$th=($box[1]-$box[5])*$spacing; // 图像高度

上

下

-3

groomed at users dot sf dot net ¶

20 年前

ImageFTBBox 返回一个边界框，而不是度量，正如上面一些（大多数？）笔记假设的那样。它返回的 8 个值指定了这个边界框的 4 个角。因此，要正确确定字符串的宽度和高度，您需要执行以下操作

$bbox = ImageFTBBox(...);
$width = abs($bbox[0]) + abs($bbox[2]); // 从左到右的距离
$height = abs($bbox[1]) + abs($bbox[5]); // 从上到下的距离

＋添加注释