Name

ST_AsGDALRaster — Return the raster tile in the designated GDAL Raster format. Raster formats are one of those supported by your compiled library. Use ST_GDALDrivers() to get a list of formats supported by your library.

Synopsis

bytea ST_AsGDALRaster(raster rast, text format, text[] options=NULL, integer srid=sameassource);

설명

래스터 타일을 지정한 형식으로 반환합니다. 인수들은 다음과 같습니다:

  • format - 출력할 형식입니다. 사용자의 LibGDAL 라이브러리에 컴파일된 드라이버에 따라 달라질 수 있습니다. 일반적으로 사용할 수 있는 형식은 'JPEG', 'GTiff', 'PNG'입니다. 사용자 라이브러리가 지원하는 형식들의 목록을 보려면 ST_GDALDrivers 함수를 이용하십시오.

  • options - GDAL 옵션들의 텍스트 배열입니다. 형식에 따라 유효한 옵션들이 달라집니다. 자세한 내용은 GDAL 래스터 형식 옵션 을 참조하십시오.

  • srs - 이미지 파일에 임베딩할 proj4text 또는 (spatial_ref_sys에서 가져온) srtext입니다.

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

JPEG Output Example, multiple tiles as single raster

SELECT ST_AsGDALRaster(ST_Union(rast), 'JPEG', ARRAY['QUALITY=50']) As rastjpg
FROM dummy_rast
WHERE rast && ST_MakeEnvelope(10, 10, 11, 11);

Using PostgreSQL Large Object Support to export raster

One way to export raster into another format is using PostgreSQL large object export functions. We'lll repeat the prior example but also exporting. Note for this you'll need to have super user access to db since it uses server side lo functions. It will also export to path on server network. If you need export locally, use the psql equivalent lo_ functions which export to the local file system instead of the server file system.

DROP TABLE IF EXISTS tmp_out ;

CREATE TABLE tmp_out AS
SELECT lo_from_bytea(0,
       ST_AsGDALRaster(ST_Union(rast), 'JPEG', ARRAY['QUALITY=50'])
        ) AS loid
  FROM dummy_rast
WHERE rast && ST_MakeEnvelope(10, 10, 11, 11);

SELECT lo_export(loid, '/tmp/dummy.jpg')
   FROM tmp_out;

SELECT lo_unlink(loid)
  FROM tmp_out;

GeoTiff 출력 예시

SELECT ST_AsGDALRaster(rast, 'GTiff') As rastjpg
FROM dummy_rast WHERE rid=2;

-- Out GeoTiff with jpeg compression, 90% quality
SELECT ST_AsGDALRaster(rast, 'GTiff',
  ARRAY['COMPRESS=JPEG', 'JPEG_QUALITY=90'],
  4269) As rasttiff
FROM dummy_rast WHERE rid=2;
                

참고

Section 9.3, “PostGIS 래스터를 이용하는 사용자 지정 응용 프로그램 빌드하기”, ST_GDALDrivers, ST_SRID