文字列を垂直に描画する

# imagestringup

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

imagestringup — 文字列を垂直に描画する

### 説明

function imagestringup(
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 imagestringup() の例

    <?php
    // 100*100 の画像を作成します
    $im = imagecreatetruecolor(100, 100);

    // テキストを書き込みます
    $textcolor = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
    imagestringup($im, 3, 40, 80, 'gd library', $textcolor);

    // 画像を保存します
    imagepng($im, './stringup.png');
    ?>

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

### 参考

- imagestring() - 文字列を水平に描画する
- imageloadfont() - 新しいフォントを読み込む

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