(PHP 5, PHP 7, PHP 8)
imagexbm — Выводит XBM-изображение в браузер или в файл
Функция выводит или сохраняет XBM-версию изображения
image.
Замечание: Функция imagexbm() не применяет отступов, поэтому ширина изображения должна быть кратна 8. Начиная с PHP 7.0.9 функция больше не применяет это ограничение.
imagefilename
Путь в виде значения с типом string , по которому требуется сохранить файл.
Со значением null функция выведет поток необработанного изображения напрямую.
По названию файла в аргументе filename без расширения .xbm функция
также строит C-идентификаторы XBM-файла, при этом небуквенно-цифровые символы
текущей локали заменяются подчеркиваниями.
При передаче в аргументе filename значения null
функция построит C-идентификаторы на основе значения image.
foreground_colorПараметр устанавливает цвет верхнего слоя путём установки идентификатора, который вернула функция imagecolorallocate() . Верхний слой получает чёрный цвет по умолчанию. Остальные цвета интерпретируются как цвет фона.
Функция возвращает true , если выполнилась успешно, или false , если возникла ошибка.
Функция вернёт значение true , если вывести изображение средствами библиотеки libgd невозможно.
| Версия | Описание |
|---|---|
| 8.0.0 |
Параметр image теперь принимает объект GdImage ;
раньше параметр принимал корректный gd-ресурс (resource ).
|
| 8.0.0 |
Параметр foreground_color теперь принимает значение null .
|
| 8.0.0 | Удалили четвёртый параметр, который функция не учитывала. |
Пример #1 Пример сохранения XBM-файла
<?php
// Создание пустого изображения и добавление текста
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'Простая текстовая строка', $text_color);
// Сохранение изображения
imagexbm($im, 'simpletext.xbm');
?>
Пример #2 Пример сохранение XBM-файла с другим цветом верхнего слоя
<?php
// Создание пустого изображения и добавление текста
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'Простая текстовая строка', $text_color);
// Изменение цвета
$foreground_color = imagecolorallocate($im, 255, 0, 0);
// Сохранение изображения
imagexbm($im, NULL, $foreground_color);
?>