Skip to main content

Описание

Отображает результат запроса в виде PNG-изображения. Это удобно как встроенный инструмент визуализации. Размер выходного изображения задаётся настройками 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 заставляет формат вместо этого отображать изображение прямо в терминале с помощью протокола встроенных изображений:

Настройки формата

Last modified on July 23, 2026