ラスタの指定した位置のピクセルをジオメトリオブジェクトに変換します。各オブジェクトは、ピクセルのセントロイドで表現されます。
構文
setof record ST_PixelAsCentroids(raster raster_obj,
integer band default 0,
integer pyramid default 0,
boolean exclude_nodata_value default true,
out integer rowsn,
out integer columnsn,
out integer bandsn,
out double value,
out geometry geom);パラメーター
| パラメーター | 型 | デフォルト値 | 説明 |
|---|---|---|---|
raster_obj | raster | — | クエリ対象のラスタ。 |
band | integer | 0 | クエリ対象のバンド ID。有効なバンド ID は 0 から始まります。 |
pyramid | integer | 0 | クエリ対象のピラミッドレベル。 |
exclude_nodata_value | boolean | true | NoData ピクセルを除外するかどうか。 |
rowsn | out integer | — | ピクセルの行番号。 |
columnsn | out integer | — | ピクセルの列番号。 |
bandsn | out integer | — | ピクセルのバンド ID。 |
value | out double | — | ピクセル値。 |
geom | out geometry | — | ピクセルのセントロイド。 |
説明
ST_PixelAsCentroids は、ST_PixelAsPoints の ref_point パラメーターに CENTER を設定した場合の ST_PixelAsPoints と同じ結果を返します。
例
WITH tmp AS (
SELECT (ST_PixelAsCentroids(rast, 1)).*
FROM rast_table
WHERE id = 10 )
SELECT rowsn, columnsn, bandsn, value, ST_AsEWKT(geom) FROM tmp WHERE value > 38.0;
----------------------------------------------------
100 | 100 | 0 | 43 | SRID=4326;POINT(-89.5 0.5)