imageftbbox
(PHP 4 >= 4.0.7, PHP 5)
imageftbbox — freetype2 によるフォントを用いたテキストを囲む箱を取得する
説明
array imageftbbox
( float $size
, float $angle
, string $fontfile
, string $text
[, array $extrainfo
] )
パラメータ
- size
-
ピクセル単位のフォントサイズ。
- angle
-
text を取得する角度。
- fontfile
-
TrueType フォントのファイル名 (URL も可)。 PHP が使用している GD ライブラリのバージョンにも依存しますが、 先頭に '/' がついていないファイル名を渡した場合は ファイル名の末尾に '.ttf' を追加して GD のフォントパスからファイルを探そうとすることもあります。
- text
-
取得したい文字列。
- extrainfo
-
extrainfo の配列のインデックス キー 型 意味 linespacing float 描画時の行間を定義します
返り値
imageftbbox() は 8 つの要素からなる配列を返します。 これが、テキストを囲む箱の 4 つの角の座標を表します。
| 0 | 左下角の X 座標 |
| 1 | 左下角の Y 座標 |
| 2 | 右下角の X 座標 |
| 3 | 右下角の Y 座標 |
| 4 | 右上角の X 座標 |
| 5 | 右上角の Y 座標 |
| 6 | 左上角の X 座標 |
| 7 | 左上角の Y 座標 |
これらの点は、angle の値にかかわらず text からの相対位置になります。 つまり「左上」とは、そのテキストが水平になるように見たときの左上ということです。
注意
注意: この関数は、GD 2.0.1 以降を必要とします (2.0.28 以降を推奨します)。
注意: この関数は、PHP が FreeType サポート (--with-freetype-dir=DIR) を有効にしてコンパイルされている場合のみ使用可能です。
変更履歴
| バージョン | 説明 |
|---|---|
| 4.3.5 | extrainfo がオプションになりました。 |