Описание
output_format_image_width и
output_format_image_height
(обе по умолчанию равны 1024). Пиксели, не покрытые результатом, заполняются чёрным цветом
(в режимах RGB и градаций серого) или прозрачным чёрным (в режиме RGBA).
Цветовой режим автоматически определяется по именам столбцов и типам результата:
Имена столбцов сопоставляются регистронезависимо. Если цветовой режим нельзя определить однозначно
(например, из-за неизвестных имён столбцов, смешения
v с r/g/b/a или отсутствия одного из r/g/b),
запрос генерирует исключение.
Для пиксельных каналов целочисленные значения ограничиваются диапазоном [0, 255], а значения с плавающей точкой —
диапазоном [0, 1], после чего масштабируются до [0, 255].
Положение каждой записи в изображении определяется одним из двух режимов:
- Неявный (по умолчанию — когда нет ни
x, ниy). Каждая запись соответствует одному пикселю; пиксели заполняются в порядке сканирования: слева направо, сверху вниз. - Явный (когда присутствуют столбцы
xиy, оба целочисленного типа). Столбцыxиyзадают координаты пикселя. Записи с координатами за пределами изображения молча игнорируются. Если несколько записей имеют одинаковые координаты, используется последняя из них (алгоритм художника).
Пример использования
Неявные координаты (одна строка на пиксель), RGB
Явные координаты, градации серого
Отображение изображений в терминале
PNG выводит необработанные байты изображения. Параметр
output_format_image_terminal_mode
заставляет формат вместо этого отображать изображение прямо в терминале с помощью протокола встроенных изображений: