ST_PixelAsPolygons
上一頁  11.6. 光柵像素存取器與設定器  下一頁

名稱

ST_PixelAsPolygons — 傳回光柵波段中每個像素的邊界多邊形幾何形狀，以及每個像素的值、X 和 Y 光柵座標。

概要

setof record ST_PixelAsPolygons(raster rast, integer band=1, boolean exclude_nodata_value=TRUE);

描述

傳回光柵波段中每個像素的邊界多邊形幾何形狀，以及每個像素的值（雙精度）、X 和 Y 光柵座標（整數）。

傳回記錄格式：geom 幾何, val 雙精度, x 整數, y 整數。

[Note]

當 exclude_nodata_value = TRUE 時，僅傳回那些值不是 NODATA 的像素作為點。
[Note]

ST_PixelAsPolygons 會為每個像素傳回一個多邊形幾何形狀。這與 ST_DumpAsPolygons 不同，後者每個幾何形狀表示一個或多個具有相同像素值的像素。

可用性：2.0.0

增強功能：2.1.0 新增了 exclude_nodata_value 選用參數。

變更：2.1.1 變更了 exclude_nodata_value 的行為。

範例

-- get raster pixel polygon
SELECT (gv).x, (gv).y, (gv).val, ST_AsText((gv).geom) geom
FROM (SELECT ST_PixelAsPolygons(
                 ST_SetValue(ST_SetValue(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 0.001, -0.001, 0.001, 0.001, 4269),
                                                    '8BUI'::text, 1, 0),
                                         2, 2, 10),
                             1, 1, NULL)
) gv
) foo;

 x | y | val |                geom
---+---+-----------------------------------------------------------------------------
 1 | 1 |     | POLYGON((0 0,0.001 0.001,0.002 0,0.001 -0.001,0 0))
 1 | 2 |   1 | POLYGON((0.001 -0.001,0.002 0,0.003 -0.001,0.002 -0.002,0.001 -0.001))
 2 | 1 |   1 | POLYGON((0.001 0.001,0.002 0.002,0.003 0.001,0.002 0,0.001 0.001))
 2 | 2 |  10 | POLYGON((0.002 0,0.003 0.001,0.004 0,0.003 -0.001,0.002 0))