imagexbm
(PHP 5, PHP 7, PHP 8)
imagexbm — Вывод XBM изображения в браузер или файл
Описание
Вывод или сохранение в формате XBM изображения
image.
Замечание: imagexbm() не использует дополнение, так что ширина изображения должна быть кратна 8. Это ограничение не накладывается с версий PHP 7.0.9.
Список параметров
-
image -
Объект GdImage, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().
-
filename -
Путь, по которому сохранять файл, заданный как строка (string) Если не установлено, или равно
null, будет произведён прямой вывод необработанного потока изображения.filename(без расширения .xbm) также используется как идентификатор C XBM, при этом символы, не являющиеся в текущей локали цифрами или буквами, заменяются на подчёркивание. Еслиfilenameзадан какnull,imageбудет использован для создания идентификатора C. -
foreground_color -
Можно задать цвет верхнего слоя. Цвет задаётся идентификатором созданным функцией imagecolorallocate(). По умолчанию цвет чёрный. Все остальные цвета интерпретируются как цвета подложки (background).
Возвращаемые значения
Возвращает true в случае успешного завершения или false в случае возникновения ошибки.
Однако, если libgd не может вывести изображения, эта функция вернёт true.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
image теперь ожидает экземпляр GdImage;
ранее ожидался ресурс (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');
// Освобождение памяти
imagedestroy($im);
?>
Пример #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);
// Освобождение памяти
imagedestroy($im);
?>
Примечания
add a note
