imagebmp

(PHP 7 >= 7.2.0, PHP 8)

imagebmp — Вывести BMP-изображение в браузер или файл

Описание

imagebmp(GdImage $image, resource|string|null $file = null, bool $compressed = true): bool

Выводит или сохраняет BMP-версию заданного изображения (image).

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

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

Замечание:
null недействителен, если аргумент compressed не используется.
compressed: Должен ли BMP быть сжат с кодировкой длин серий (RLE), или нет.

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

Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.

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

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

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

Версия	Описание
8.0.0	`image` теперь ожидает экземпляр GdImage; ранее ожидался корректный `gd` ресурс (resource).
8.0.0	Тип параметра `compressed` теперь логическое значение (bool); ранее был целым числом (int).

Примеры

Пример #1 Сохранение BMP-файла

<?php
// Создайте пустое изображение и добавьте текст
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);

imagestring($im, 1, 5, 5,  'BMP with PHP', $text_color);

// Сохранить изображение
imagebmp($im, 'php.bmp');

// Освободить память
imagedestroy($im);
?>