imagetruecolortopalette
imagettftext
GD および Image 関数
PHP Manual

# imagettfbbox

(PHP 4, PHP 5)

imagettfbbox — TypeType フォントを使用したテキストの bounding box を生成する

### 説明

array imagettfbbox ( float `$size` , float `$angle` , string `$fontfile` , string `$text` )

この関数は TrueType テキストの bounding box をピクセル単位で計算して 返します。

### パラメータ

`size`

  フォントの大きさ。GD のバージョンによって、これはピクセル単位 (GD1) あるいはポイント数 (GD2) のいずれかとなります。

`angle`

  測定する `text` の角度(度単位)。

`fontfile`

  TrueType フォントファイルのファイル名 (URL)。PHP が使用している GD ライブラリのバージョンによっては、'/' から始まり '.ttf' で終わるような ファイル名で探し、またライブラリによって定義されているフォントパスで 探そうと試みます。

`text`

  測定する文字列。

### 返り値

imagettfbbox() は、テキストの bounding box を 作成するための 4 点を表現する 8 個の要素からなる配列を返します。 エラー時には `FALSE` を返します。

キー | 内容
--- | ---
0 | 左下角の X 座標
1 | 左下角の Y 座標
2 | 右下角の X 座標
3 | 右下角の Y 座標
4 | 右上角の X 座標
5 | 右上角の Y 座標
6 | 左上角の X 座標
7 | 左上角の Y 座標

各点の位置は、 `angle` にかかわらず text からの相対位置で表されます。 つまり、"左上"はテキストを水平に見た場合の左上の角を意味します。

### 例

例1 imagettfbbox() の例

`<?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 = imagettfbbox(10, 45, $font, 'Powered by PHP ' . phpversion());
// X 座標と Y 座標
$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) - 25;
$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5;
// 書き込みます
imagettftext($im, 10, 45, $x, $y, $black, $font, 'Powered by PHP ' . phpversion());
// 次に 2 番目のテキスト用のバウンディングボックスを作成します
$bbox = imagettfbbox(10, 45, $font, 'and Zend Engine ' . zend_version());
// 最初のテキストに続ける座標を設定します
$x = $bbox[0] + (imagesx($im) / 2) - ($bbox[4] / 2) + 10;
$y = $bbox[1] + (imagesy($im) / 2) - ($bbox[5] / 2) - 5;
// 書き込みます
imagettftext($im, 10, 45, $x, $y, $black, $font, 'and Zend Engine ' . zend_version());
// ブラウザに出力します
header('Content-type: image/png');
imagepng($im);
imagedestroy($im);
?>`

### 注意

> 注意: 本関数は GD ライブラリと » FreeType ライブラリの両方が必要です。

### 参考

- imagettftext() - TrueType フォントを使用してテキストを画像に書き込む

imagetruecolortopalette
imagettftext
GD および Image 関数
PHP Manual