imagechar

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

imagechar水平に文字を描画する

説明

imagechar(
    GdImage$image,
    int$font,
    int$x,
    int$y,
    string$char,
    int$color
): bool

imagechar() は、画像 im 上の座標 x,y(左上が 0, 0) に color 色で char の最初の文字を描画します。

パラメータ

image

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

font

latin2 エンコーディングの組み込みのフォントの場合は 1, 2, 3, 4, 5 のいずれか (数字が大きなほうが、より大きいフォントに対応します)、 あるいは imageloadfont()で登録したフォントの識別子のいずれか。

x

始点の x 座標。

y

始点の y 座標。

char

描画する文字。

color

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

返り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン説明
8.0.0image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource が期待されていました。

例1 imagechar() の例

<?php

$im 
imagecreate(100100);

$string 'PHP';

$bg imagecolorallocate($im255255255);
$black imagecolorallocate($im000);

// 左上の角に黒で "P" を表示します
imagechar($im100$string$black);

header('Content-type: image/png');
imagepng($im);

?>

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

出力例 : imagechar()

参考