imagexbm

(PHP 5, PHP 7, PHP 8)

imagexbm — Виведення XBM зображення до браузера або файлу

Опис

imagexbm(GdImage $image, ?string $filename, ?int $foreground_color = null): bool

Виведення або збереження у форматі 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; раніше очікувався коректний `gd` ресурс (Resource).
8.0.0	`foreground_color` тепер допускає значення null.
8.0.0	Четвертий параметр, який не використовувався, було видалено.

Приклади

Приклад #1 Збереження файлу XBM

Loading...

Приклад #2 Збереження файлу XBM з відмінним кольором верхнього шару