PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    imagegd

    (PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

    imagegd — GD イメージをブラウザまたはファイルに出力する

    説明

    imagegd(GdImage $image, ?string $file = null): bool

    GD イメージを、指定した file に出力します。

    パラメータ

    image

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

    file

    ファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり null を設定したりした場合は、画像ストリームを直接出力します。

    戻り値

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

    警告

    しかしながら、libgd がイメージの出力に失敗した場合、この関数は true を返します。

    変更履歴

    バージョン 説明
    8.0.3 file は、nullable になりました。
    8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な gd resource が期待されていました。
    7.2.0 imagegd() が truecolor 画像を出力できるようになりました。 これまでのバージョンでは、暗黙のうちにパレット画像に変換されていました。

    例

    例1 GD 画像の出力

    <?php
    // 空の画像を作成し、テキストを追加します
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5, "A Simple Text String", $text_color);

    // 画像を出力します
    imagegd($im);

    // メモリを開放します
    imagedestroy($im);
    ?>

    例2 GD 画像の保存

    <?php
    // 空の画像を作成し、テキストを追加します
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5, "A Simple Text String", $text_color);

    // GD 画像を保存します
    // GD 画像のファイル形式は .gd です。 http://www.libgd.org/GdFileFormats を参照ください
    imagegd($im, 'simple.gd');

    // メモリを開放します
    imagedestroy($im);
    ?>

    注意

    注意:

    通常 GD フォーマットはイメージの一部を高速にロードするために 使用されます。GD フォーマットは GD 互換アプリケーションでのみ使用可能であることに注意してください。

    警告

    GD と GD2 画像フォーマットは libgd が作った独自仕様の画像フォーマットです。これらは obsolete と見なされているため、開発とテストの用途にだけ使うべきです。

    参考

    • imagegd2() - GD2 イメージをブラウザまたはファイルに出力する

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.