PHPのGDライブラリを用いて文字列を描画するその２

Posted at 2024-11-07

はじめに

本稿は、PHPのGDライブラリを用いて文字列を描画するの続きとなっています。
前回書ききれなかった、文字列を斜めに描画する方法について説明します。

描画領域の座標系について

このサンプルコードは前回説明したものと同じになりますが、imagettfbbox()にテキストを回転させる角度を度数法で指定します。

$bounding_box = imagettfbbox(
    $font_size,
    $text_angle, //第２引数で角度を指定する
    $font_file_name,
    $text
    //PHP8.0では引数にarray $options = []が追加されている
);

開始位置を指定して文字列を描画する

ここからが曲者になります。

まず、文字列を描画するコードは前回のものを踏襲します。

imagettftext(
    $image, //あらかじめ生成した空のイメージ
    $font_size,
    $text_angle, //0°(水平)を基準として任意の角度に回転させることができる
    $min_x * -1, //テキストの開始位置のX座標
    $min_y * -1, //テキストの開始位置のY座標
    $foreground_color, //文字色
    $font_file_name, //.ttfファイルのパス
    $text //描画する文字列
);

テキストの開始位置のX座標、Y座標が不思議な値になっているのが分かると思いますが、この理由を以下で説明します。

まず上記のコードで、角度0°、フォントサイズ32、フォントにNoto Serif JapaneseのNotoSerifJP-Regular.ttfを指定して描画し、各バウンディングボックスの座標を取得してみます。

青い文字列の４隅に書かれた黒い座標がバウンディングボックスの座標です。
X座標は左から右に大きくなり、Y座標は上から下に大きくなる、すなわち座標系で言うところの第４象限です。
これ自体はプログラミングでは珍しいことではないと思いますが、上端のY座標が負の値になっていて、第１象限にはみ出しています。
つまり、このケースでは正しく描画するためにはY座標を36ピクセルずらしてやる必要があるということです。

文字列を回転させた場合はさらにややこしくなります。
フォントの条件をそのままに文字列の角度を100°とした場合のバウンディングボックスの座標を取得してみます。