文字列を水平に描画する

# imagestring

(PHP 4, PHP 5, PHP 7, PHP 8)

imagestring — 文字列を水平に描画する

### 説明

function imagestring(
GdImage `$image`,
GdFont|int `$font`,
int `$x`,
int `$y`,
string `$string`,
int `$color`
): true

指定した座標に文字列 `string` を描画します。

### パラメータ

`image`
  imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。
`font`
  latin2 エンコーディングの組み込みのフォントの場合は 1, 2, 3, 4, 5 のいずれか (数字が大きなほうが、より大きいフォントに対応します)、あるいは imageloadfont() が返した、GdFont クラスのインスタンスのいずれか。
`x`

  左上隅の x 座標。

`y`

  左上隅の y 座標。

`string`

  書き出す文字列。

`color`

  imagecolorallocate() で作成された色識別子。

### 戻り値

常に `true` を返します。

### 変更履歴

バージョン | 説明
--- | ---
8.1.0 | 引数 `font` は、GdFont クラスのインスタンスと数値を両方受け入れるようになりました。これより前のバージョンでは、数値のみを受け入れていました。
8.0.0 | `image` は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な `gd` 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);
    ?>

上の例の出力は、 たとえば以下のようになります。

### 参考

- imagestringup() - 文字列を垂直に描画する
- imageloadfont() - 新しいフォントを読み込む
- imagettftext() - TrueType フォントを使用してテキストを画像に書き込む

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open