Skip to main content

설명

쿼리 결과를 PNG 이미지로 렌더링합니다. 기본 제공 시각화 도구로 유용합니다. 출력 이미지의 크기는 설정 output_format_image_widthoutput_format_image_height (둘 다 기본값은 1024)로 고정됩니다. 결과가 덮지 않는 픽셀은 검은색으로 채워지며 (RGB 및 그레이스케일 모드), RGBA 모드에서는 투명한 검은색으로 채워집니다. 색상 모드는 결과의 컬럼 이름과 타입에 따라 자동으로 결정됩니다: 컬럼 이름은 대소문자를 구분하지 않고 매칭됩니다. 색상 모드를 명확하게 판별할 수 없는 경우(예: 알 수 없는 컬럼 이름, vr/g/b/a가 혼합된 경우, 또는 r/g/b 중 하나가 없는 경우) 쿼리에서 예외가 발생합니다. 픽셀 채널의 경우, 정수 값은 [0, 255] 범위로 제한되며 부동소수점 값은 [0, 1] 범위로 제한된 다음 [0, 255]로 스케일됩니다. 이미지에서 각 레코드의 위치는 다음 두 가지 모드 중 하나로 결정됩니다:
  • 암시적(기본값 — xy가 모두 없을 때). 각 레코드는 단일 픽셀에 대응하며, 픽셀은 스캔라인 순서대로, 즉 왼쪽에서 오른쪽으로, 위에서 아래로 채워집니다.
  • 명시적(xy 컬럼이 모두 존재하고 둘 다 정수 타입일 때). xy 컬럼은 픽셀 좌표를 나타냅니다. 이미지 범위를 벗어나는 좌표를 가진 레코드는 별도 알림 없이 무시됩니다. 동일한 좌표를 가진 레코드가 여러 개 있으면 마지막 레코드가 적용됩니다(painter’s algorithm).

사용 예시

암시적 좌표 (픽셀당 1행), RGB

명시적 좌표, 그레이스케일

터미널에서 이미지 표시하기

기본적으로 PNG 포맷은 원시 이미지 바이트를 출력합니다. 설정 output_format_image_terminal_mode를 사용하면, 대신 인라인 이미지 프로토콜을 통해 이미지를 터미널에 직접 렌더링합니다:

포맷 설정

Last modified on July 23, 2026