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

Объект 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 сборкой