imagegd

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

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

説明

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

指定された image を GDフォーマットで出力するか、保存します。

パラメータ

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 画像を出力できるようになりました。これまでのバージョンでは、暗黙のうちにパレット画像に変換されていました。

バージョン	説明
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);
?>

例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');
?>

注意

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

警告

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

参考

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