ST_AsPNG
Prev  11.11. 래스터 출력  Next

Name

ST_AsPNG — 래스터 타일에서 선택한 밴드들을 단일 PNG(Portable Network Graphics) 이미지(바이트 배열)로 반환합니다. 래스터의 밴드가 1개, 3개, 또는 4개이거나 따로 설정하지 않을 경우 모든 밴드를 씁니다. 밴드가 2개 또는 4개를 초과하며 따로 설정하지 않을 경우, 밴드 1만 씁니다. 밴드를 RGB 또는 RGBA 스페이스에 매핑합니다.

Synopsis

bytea ST_AsPNG(raster rast, text[] options=NULL);

bytea ST_AsPNG(raster rast, integer nband, integer compression);

bytea ST_AsPNG(raster rast, integer nband, text[] options=NULL);

bytea ST_AsPNG(raster rast, integer[] nbands, integer compression);

bytea ST_AsPNG(raster rast, integer[] nbands, text[] options=NULL);

설명

래스터에서 선택한 밴드들을 단일 PNG(Portable Network Graphics) 이미지로 반환합니다. 덜 흔한 래스터 유형으로 내보내야 할 경우 ST_AsGDALRaster 함수를 이용하십시오. 밴드를 따로 설정하지 않을 경우, 처음 3개의 밴드를 내보냅니다. srid 를 따로 설정하지 않으면 래스터의 SRID를 사용합니다. 이 함수에는 다음과 같은 많은 옵션을 가진 많은 변종이 있습니다:

  • nband - 단일 밴드 내보내기를 위한 옵션입니다.

  • nbands - 내보낼 밴드들의 배열입니다(PNG의 경우 4가 최대값입니다). 밴드의 순서는 RGBA입니다. 예를 들어 ARRAY[3,2,1]은 밴드 3을 빨간색, 밴드 2를 초록색, 밴드 1을 파란색에 매핑한다는 뜻입니다.

  • compression - 1부터 9까지의 숫자입니다. 숫자가 높을수록 압축률도 높아집니다.

  • options - PNG에 대해 정의된 GDAL 옵션들의 텍스트 배열입니다(ST_GDALDrivers에서 PNG에 대한 create_options를 살펴보십시오). PNG의 경우, 유효한 옵션은 ZLEVEL(압축에 소비할 시간 - 기본값은 6)뿐으로, 예를 들어 ARRAY['ZLEVEL=9']처럼 쓰입니다. 이 함수는 출력물 2개를 출력해야 하기 때문에 월드 파일을 사용할 수는 없습니다. 자세한 내용은 GDAL 래스터 형식 옵션 을 참조하십시오.

2.0.0 버전부터 사용할 수 있습니다. GDAL 1.6.0 이상 버전이 필요합니다.

예시

SELECT ST_AsPNG(rast) As rastpng
FROM dummy_rast WHERE rid=2;

-- export the first 3 bands and map band 3 to Red, band 1 to Green, band 2 to blue
SELECT ST_AsPNG(rast, ARRAY[3,1,2]) As rastpng
FROM dummy_rast WHERE rid=2;