Name

ST_AsRaster — PostGIS 도형을 PostGIS 래스터로 변환합니다.

Synopsis

raster ST_AsRaster(geometry geom, raster ref, text pixeltype, double precision value=1, double precision nodataval=0, boolean touched=false);

raster ST_AsRaster(geometry geom, raster ref, text[] pixeltype=ARRAY['8BUI'], double precision[] value=ARRAY[1], double precision[] nodataval=ARRAY[0], boolean touched=false);

raster ST_AsRaster(geometry geom, double precision scalex, double precision scaley, double precision gridx, double precision gridy, text pixeltype, double precision value=1, double precision nodataval=0, double precision skewx=0, double precision skewy=0, boolean touched=false);

raster ST_AsRaster(geometry geom, double precision scalex, double precision scaley, double precision gridx=NULL, double precision gridy=NULL, text[] pixeltype=ARRAY['8BUI'], double precision[] value=ARRAY[1], double precision[] nodataval=ARRAY[0], double precision skewx=0, double precision skewy=0, boolean touched=false);

raster ST_AsRaster(geometry geom, double precision scalex, double precision scaley, text pixeltype, double precision value=1, double precision nodataval=0, double precision upperleftx=NULL, double precision upperlefty=NULL, double precision skewx=0, double precision skewy=0, boolean touched=false);

raster ST_AsRaster(geometry geom, double precision scalex, double precision scaley, text[] pixeltype, double precision[] value=ARRAY[1], double precision[] nodataval=ARRAY[0], double precision upperleftx=NULL, double precision upperlefty=NULL, double precision skewx=0, double precision skewy=0, boolean touched=false);

raster ST_AsRaster(geometry geom, integer width, integer height, double precision gridx, double precision gridy, text pixeltype, double precision value=1, double precision nodataval=0, double precision skewx=0, double precision skewy=0, boolean touched=false);

raster ST_AsRaster(geometry geom, integer width, integer height, double precision gridx=NULL, double precision gridy=NULL, text[] pixeltype=ARRAY['8BUI'], double precision[] value=ARRAY[1], double precision[] nodataval=ARRAY[0], double precision skewx=0, double precision skewy=0, boolean touched=false);

raster ST_AsRaster(geometry geom, integer width, integer height, text pixeltype, double precision value=1, double precision nodataval=0, double precision upperleftx=NULL, double precision upperlefty=NULL, double precision skewx=0, double precision skewy=0, boolean touched=false);

raster ST_AsRaster(geometry geom, integer width, integer height, text[] pixeltype, double precision[] value=ARRAY[1], double precision[] nodataval=ARRAY[0], double precision upperleftx=NULL, double precision upperlefty=NULL, double precision skewx=0, double precision skewy=0, boolean touched=false);

설명

PostGIS 도형을 PostGIS 래스터로 변환합니다. 다양한 변종들을 통해 출력 래스터의 정렬 방향과 픽셀 크기를 크게 세 가지 방법으로 설정할 수 있습니다.

처음 두 변종으로 이루어진 첫 번째 방법은 주어진 참조 래스터와 동일한 정렬 방향(scalex, scaleygridx, gridy), 픽셀 유형, NODATA 값을 가진 래스터를 생성합니다. 일반적으로, 참조 래스터를 담고 있는 테이블과 도형을 담고 있는 테이블을 결합하는 방법으로 해당 참조 래스터를 입력합니다.

네 변종으로 이루어진 두 번째 방법은 픽셀 크기(scalex & scaleyskewx & skewy)의 파라미터를 제공, 사용자가 래스터의 차원을 설정할 수 있도록 합니다. 결과 래스터의 width & height 가 도형의 범위에 맞도록 조정될 것입니다. 대부분의 경우, 정수형 scalex & scaley 인수들을 PostgreSQL이 올바른 변종을 선택하도록 이중 정밀도 데이터형으로 형변환해야만 합니다.

네 변종으로 이루어진 세 번째 방법은 래스터의 차원(width & height)을 제공, 사용자가 래스터의 차원을 수정할 수 있도록 합니다. 결과 래스터의 픽셀 크기 파라미터(scalex & scaleyskewx & skewy)가 도형의 범위에 맞도록 조정될 것입니다.

뒤의 두 방법 가운데 각 방법의 처음 두 변종들은 사용자가 정렬 그리드의 임의의 모서리(gridx & gridy)를 설정할 수 있도록 합니다. 다른 두 변종들은 좌상단(upperleftx & upperlefty))을 입력받습니다.

각 방법의 변종은 단일 밴드 래스터 또는 복수 밴드 래스터를 생성할 수 있게 해줍니다. 복수 밴드 래스터를 생성하려면, 사용자가 픽셀 유형의 배열(pixeltype[]), 초기값의 배열(value) 그리고 NODTATA 값의 배열(nodataval)을 준비해야만 합니다. 이들을 입력하지 않으면, 기본적으로 픽셀 유형은 8BUI, 초기값은 1, NODATA 값은 0이 됩니다.

출력 래스터는 소스 도형과 동일한 공간 참조 시스템을 가지게 됩니다. 유일한 예외는 참조 래스터를 받는 변종들뿐입니다. 이런 경우 결과 래스터는 참조 래스터와 동일한 SRID를 가지게 됩니다.

선택적인 touched 파라미터의 기본값은 거짓으로 GDAL ALL_TOUCHED 래스터화 옵션에 매핑되는데, 이 옵션은 라인 또는 폴리곤에 닿은 픽셀을 없앨 것인지 말 것인지 결정합니다. 렌더링된 라인 경로 상에 있는 픽셀만이 아니라, 그 중심점이 폴리곤 내부에 있는 픽셀 또한 말이죠.

이 함수는 ST_AsPNG 및 다른 ST_AsGDALRaster 계열 함수와 결합해서 사용할 때 데이터베이스로부터 직접 가져온 도형의 JPEG 또는 PNG를 렌더링하는 데 특히 유용합니다.

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

[Note]

아직 만곡 도형, TIN, 다면체 표면 등의 복잡 도형 유형을 렌더링할 수는 없지만, GDAL이 관련 기능을 지원하게 되면 할 수 있게 될 것입니다.

예시: PNG 파일로 도형을 출력

검정색 원

-- this will output a black circle taking up 150 x 150 pixels --
SELECT ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10),150, 150));

PostGIS만을 이용해서 렌더링된 버퍼의 예시

-- the bands map to RGB bands - the value (118,154,118) - teal  --
SELECT ST_AsPNG(
    ST_AsRaster(
        ST_Buffer(
            ST_GeomFromText('LINESTRING(50 50,150 150,150 50)'), 10,'join=bevel'),
            200,200,ARRAY['8BUI', '8BUI', '8BUI'], ARRAY[118,154,118], ARRAY[0,0,0]));