imagestring
(PHP 4, PHP 5, PHP 7, PHP 8)
imagestring — 文字列を水平に描画する
説明
指定した座標に文字列 string を描画します。
パラメータ
-
image -
imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。
-
font -
latin2 エンコーディングの組み込みのフォントの場合は 1, 2, 3, 4, 5 のいずれか (数字が大きなほうが、より大きいフォントに対応します)、あるいは imageloadfont() が返した、GdFont クラスのインスタンスのいずれか。
-
x -
左上隅の x 座標。
-
y -
左上隅の y 座標。
-
string -
書き出す文字列。
-
color -
imagecolorallocate() で作成された色識別子。
戻り値
成功した場合に true を、失敗した場合に false を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 8.1.0 |
引数 font は、GdFont クラスのインスタンスと数値を両方受け入れるようになりました。これより前のバージョンでは、数値のみを受け入れていました。
|
| 8.0.0 |
image は、
GdImage
クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、resource が期待されていました。
|
例
例1 imagestring() の例
<?php
// 100*30 の画像を生成します
$im = imagecreate(100, 30);
// 白色の背景と青色のテキスト
$bg = imagecolorallocate($im, 255, 255, 255);
$textcolor = imagecolorallocate($im, 0, 0, 255);
// 左上に文字列を描画します
imagestring($im, 5, 0, 0, "Hello world!", $textcolor);
// 画像を出力します
header("Content-type: image/png");
imagepng($im);
imagedestroy($im);
?>
上の例の出力は、 たとえば以下のようになります。
参考
- imagestringup() - 文字列を垂直に描画する
- imageloadfont() - 新しいフォントを読み込む
- imagettftext() - TrueType フォントを使用してテキストを画像に書き込む