新しいフォントを読み込む

# imageloadfont

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

imageloadfont — 新しいフォントを読み込む

### 説明

function imageloadfont(string `$filename`): GdFont|false

imageloadfont() はユーザーが定義したビットマップを読み込み、 その ID を返します。

### パラメータ

`filename`

  フォントファイル形式は現在はバイナリで、アーキクチャに依存します。 このため、PHP を実行するマシーンと同一の型の CPU 上でフォントファイルを 生成する必要があります。

  フォントファイルのフォーマット
  バイト位置 | C 言語のデータ型 | 説明
  --- | --- | ---
  0-3 バイト目 | int | フォント中の文字の数
  4-7 バイト目 | int | フォント中の最初の文字の値(しばしば 空白を表す 32 となります)
  8-11 バイト目 | int | 各文字のピクセル幅
  12-15 バイト目 | int | 各文字のピクセル高さ
  16 バイト目から | char | 文字データの配列、各文字のピクセルにつき1バイトで、 総数は(文字数*幅*高さ)バイトです。

### 戻り値

GdFont クラスのインスタンスを返します。 失敗した場合に `false` を返します

### 変更履歴

バージョン | 説明
--- | ---
8.1.0 | GdFont クラスのインスタンスを返すようになりました。 これより前のバージョンでは、数値を返していました。

### 例

例1 imageloadfont() の使用例

    <?php
    // 新しい画像インスタンスを作成します
    $im = imagecreatetruecolor(50, 20);
    $black = imagecolorallocate($im, 0, 0, 0);
    $white = imagecolorallocate($im, 255, 255, 255);

    // 背景を白に設定します
    imagefilledrectangle($im, 0, 0, 49, 19, $white);

    // gd フォントを読み込み 'Hello' を書き込みます
    $font = imageloadfont('./04b.gdf');
    imagestring($im, $font, 0, 0, 'Hello', $black);

    // ブラウザに出力します
    header('Content-type: image/png');

    imagepng($im);
    ?>

### 参考

- imagefontwidth() - フォントの幅を取得する
- imagefontheight() - フォントの高さを取得する
- imagestring() - 文字列を水平に描画する

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