imagewbmp

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

imagewbmp — Выводит изображение в браузер или записывает в файл

Описание

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

Функция imagewbmp() выводит или сохраняет изображение image в формате WBMP.

Список параметров

image: Объект GdImage , который вернула функция imagecreatetruecolor() или другая функция генерации изображений.
file: Путь или ресурс открытого потока, который функция автоматически закрывает после возврата значения, для сохранения файла. Функция выведет поток необработанного изображения напрямую, если параметр не установили или передали в аргументе значение null .
foreground_color: Параметр устанавливает цвет переднего плана путём установки идентификатора, который возвращает функция imagecolorallocate() . Цвет переднего плана по умолчанию — чёрный.

Возвращаемые значения

Функция возвращает true , если выполнилась успешно, или false , если возникла ошибка.

Предостережение

Функция вернёт значение true , если вывести изображение средствами библиотеки libgd невозможно.

Список изменений

Версия	Описание
8.0.0	Параметр `image` теперь принимает объект GdImage ; раньше параметр принимал корректный `gd`-ресурс (resource ).
8.0.0	Параметр `foreground_color` теперь принимает значение `null` .

Примеры

Пример #1 Пример вывода WBMP-изображения

<?php
// Создание пустого изображения и добавление текста
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'Простая текстовая строка', $text_color);
// Установка заголовка для типа содержимого image/vnd.wap.wbmp
// Подсказка: смотрите описание типов содержимого на странице функции image_type_to_mime_type()
header('Content-Type: image/vnd.wap.wbmp');
// Вывод изображения
imagewbmp($im);
?>

Пример #2 Пример сохранения WBMP-изображения

<?php
// Создание пустого изображения и добавление текста
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'Простая текстовая строка', $text_color);
// Сохранение изображения
imagewbmp($im, 'simpletext.wbmp');
?>

Пример #3 Пример вывода изображения с изменённым верхним слоем

<?php
// Создание пустого изображения и добавление текста
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'Простая текстовая строка', $text_color);
// Установка заголовка для типа содержимого image/vnd.wap.wbmp
// Подсказка: смотрите описание типов содержимого на странице функции image_type_to_mime_type()
header('Content-Type: image/vnd.wap.wbmp');
// Замена цвета
$foreground_color = imagecolorallocate($im, 255, 0, 0);
imagewbmp($im, NULL, $foreground_color);
?>

Смотрите также

image2wbmp() - Выводит изображение в браузер или записывает в файл
imagepng() - Выводит PNG-изображение в браузер или файл
imagegif() - Выводит изображение в браузер или записывает в файл
imagejpeg() - Выводит изображение в браузер или записывает в файл
imagetypes() - Возвращает список типов изображений, поддерживаемых PHP сборкой

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

+Добавить

Примечания пользователей 2 notes

down

andre at bynetworld dot com ¶

18 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);
}

down

lukeross at sys3175 dot co dot uk ¶

24 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));

+Добавить