PHP 8.4.0 RC4 available for testing

    imagewbmp

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

    imagewbmp — 画像をブラウザあるいはファイルに出力する

    説明

    imagewbmp(GdImage $image, resource|string|null $file = null, ?int $foreground_color = null): bool

    imagewbmp() は、指定した image を WBMP にして出力あるいは保存します。

    パラメータ

    image

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

    file

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

    foreground_color

    このパラメータで、 前景の色を指定できます。imagecolorallocate() で 取得した ID を使用してください。デフォルトの前景色は黒です。

    戻り値

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

    警告

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

    変更履歴

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

    例

    例1 WBMP 画像の出力

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

    // content type ヘッダを設定します - ここでは image/vnd.wap.wbmp
    // ヒント: image_type_to_mime_type() で content-types を取得します
    header('Content-Type: image/vnd.wap.wbmp');

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

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

    例2 WBMP 画像の保存

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

    // 画像を保存します
    imagewbmp($im, 'simpletext.wbmp');

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

    例3 別の前景での画像の出力

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

    // content type ヘッダを設定します - ここでは image/vnd.wap.wbmp
    // ヒント: image_type_to_mime_type() で content-types を取得します
    header('Content-Type: image/vnd.wap.wbmp');

    // 別の前景色を設定します
    $foreground_color = imagecolorallocate($im, 255, 0, 0);

    imagewbmp($im, NULL, $foreground_color);

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

    参考

    • image2wbmp() - 画像をブラウザあるいはファイルに出力する
    • imagepng() - PNG イメージをブラウザまたはファイルに出力する
    • imagegif() - 画像をブラウザあるいはファイルに出力する
    • imagejpeg() - 画像をブラウザあるいはファイルに出力する
    • imagetypes() - この PHP がサポートしている画像形式を返す

    Improve This Page

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

    User Contributed Notes 2 notes

    up
    1
    andre at bynetworld dot com
    16 years ago
    In the previous note by -> lukeross at sys3175 dot co dot uk <- there is a coding error in the for() loops. After correcting the error, I found that this function did a great job of converting color images to 2 colors.
    The following is the corrected function code:

    function ImageColorFloydSteinberg($dst_img, $src_img) {
    ImageColorAllocate($dst_img, 0,0,0);
    ImageColorAllocate($dst_img, 255,255,255);
    $isx = ImageSX($src_img);
    $isy = ImageSY($src_img);
    $grey_img = ImageCreate($isx, $isy);
    for ($a = 0; $a <= 255; $a++) ImageColorAllocate($grey_img, $a,$a,$a);
    $isx -= 1; // To correct pixel count in source image width starting from 0
    $isy -= 1; // Correcting pixel count in source image height starting from 0
    for($x = 0; $x <= $isx; $x++) {
    for($y = 0; $y <= $isy; $y++) {
    $color = ImageColorsForIndex($src_img, ImageColorAt($src_img, $x, $y));
    $greyscale = .299 * $color["red"] + .587 * $color["green"] + .114 * $color["blue"];
    ImageSetPixel($grey_img, $x, $y, ImageColorClosest($grey_img, $greyscale, $greyscale, $greyscale));
    }
    }
    for($x = 0; $x <= $isx; $x++) {
    for($y = 0; $y <= $isy; $y++) {
    $color = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x, $y));
    if ($color["red"] > 128) {
    ImageSetPixel($dst_img, $x, $y, ImageColorClosest($dst_img,255,255,255));
    $err = $color["red"] - 255;
    } else {
    ImageSetPixel($dst_img, $x, $y, ImageColorClosest($dst_img,0,0,0));
    $err = $color["red"];
    }
    if ($x != $isx) {
    $color2 = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x+1, $y));
    $newgrey = $color2["red"] + $err * 7 / 16;
    ImageSetPixel($grey_img, $x+1, $y, ImageColorClosest($grey_img,$newgrey, $newgrey, $newgrey));
    }
    if ($x != 0) {
    $color2 = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x-1, $y));
    $newgrey = $color2["red"] + $err * 3 / 16;
    ImageSetPixel($grey_img, $x-1, $y, ImageColorClosest($grey_img,$newgrey, $newgrey, $newgrey));
    }
    if ($y != $isy) {
    $color2 = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x, $y+1));
    $newgrey = $color2["red"] + $err * 5 / 16;
    ImageSetPixel($grey_img, $x, $y+1, ImageColorClosest($grey_img,$newgrey, $newgrey, $newgrey));
    }
    if ($x != $isx && $y != $isy) {
    $color2 = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x+1, $y+1));
    $newgrey = $color2["red"] + $err / 16;
    ImageSetPixel($grey_img, $x+1, $y+1, ImageColorClosest($grey_img,$newgrey, $newgrey, $newgrey));
    }

    }
    }
    imagedestroy($grey_img);
    }
    up
    0
    lukeross at sys3175 dot co dot uk
    22 years ago
    As has been commented before, GD doesnt do a very good translation to 2-colours, especially for photos. The following routine converts to two colours, I believe using error diffusion (the algorithm's nicked off news). It's slow, but just about adequate for small images and low load. I suspect it can be made much more efficient :-)

    function ImageColorFloydSteinberg($dst_img, $src_img) {
    ImageColorAllocate($dst_img, 0,0,0);
    ImageColorAllocate($dst_img, 255,255,255);
    $grey_img = ImageCreate(ImageSX($src_img), ImageSY($src_img));
    for ($a = 0; $a <= 255; $a++) ImageColorAllocate($grey_img, $a,$a,$a);
    for($x = 0; $x <= ImageSX($src_img); $x++) {
    for($y = 0; $y <= ImageSY($src_img); $y++) {
    $color = ImageColorsForIndex($src_img, ImageColorAt($src_img, $x, $y));
    $greyscale = .299 * $color["red"] + .587 * $color["green"] + .114 * $color["blue"];
    ImageSetPixel($grey_img, $x, $y, ImageColorClosest($grey_img, $greyscale, $greyscale, $greyscale));
    }
    }
    for($x = 0; $x <= ImageSX($src_img); $x++) {
    for($y = 0; $y <= ImageSY($src_img); $y++) {
    $color = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x, $y));
    if ($color["red"] > 128) {
    ImageSetPixel($dst_img, $x, $y, ImageColorClosest($dst_img,255,255,255));
    $err = $color["red"] - 255;
    } else {
    ImageSetPixel($dst_img, $x, $y, ImageColorClosest($dst_img,0,0,0));
    $err = $color["red"];
    }
    if ($x != ImageSx($src_img)) {
    $color2 = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x+1, $y));
    $newgrey = $color2["red"] + $err * 7 / 16;
    ImageSetPixel($grey_img, $x+1, $y, ImageColorClosest($grey_img,$newgrey, $newgrey, $newgrey));
    }
    if ($x != 0) {
    $color2 = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x-1, $y));
    $newgrey = $color2["red"] + $err * 3 / 16;
    ImageSetPixel($grey_img, $x-1, $y, ImageColorClosest($grey_img,$newgrey, $newgrey, $newgrey));
    }
    if ($y != ImageSy($src_img)) {
    $color2 = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x, $y+1));
    $newgrey = $color2["red"] + $err * 5 / 16;
    ImageSetPixel($grey_img, $x, $y+1, ImageColorClosest($grey_img,$newgrey, $newgrey, $newgrey));
    }
    if ($x != ImageSx($src_img) && $y != ImageSy($src_img)) {
    $color2 = ImageColorsForIndex($grey_img, ImageColorAt($grey_img, $x+1, $y+1));
    $newgrey = $color2["red"] + $err / 16;
    ImageSetPixel($grey_img, $x+1, $y+1, ImageColorClosest($grey_img,$newgrey, $newgrey, $newgrey));
    }

    }
    }
    imagedestroy($grey_img);
    }

    To output your WBMP, use

    ImageWBMP($final_img, "", ImageColorClosest(255,255,255));
    ＋add a note
    To Top