ST_SnapToGrid
上一個  11.7. 影像編輯器  下一個

名稱

ST_SnapToGrid — 通過將影像對齊網格來重新採樣。新的像素值使用最近鄰 (NearestNeighbor，英式或美式拼寫皆可)、雙線性 (Bilinear)、立方 (Cubic)、立方樣條 (CubicSpline) 或蘭索斯 (Lanczos) 重採樣演算法計算。預設為最近鄰。

概要

raster ST_SnapToGrid(raster rast, double precision gridx, double precision gridy, text algorithm=NearestNeighbor, double precision maxerr=0.125, double precision scalex=DEFAULT 0, double precision scaley=DEFAULT 0);

raster ST_SnapToGrid(raster rast, double precision gridx, double precision gridy, double precision scalex, double precision scaley, text algorithm=NearestNeighbor, double precision maxerr=0.125);

raster ST_SnapToGrid(raster rast, double precision gridx, double precision gridy, double precision scalexy, text algorithm=NearestNeighbor, double precision maxerr=0.125);

描述

通過將影像對齊由任意像素角 (gridx & gridy) 定義的網格，並可選擇指定像素大小 (scalex & scaley) 來重新採樣影像。新的像素值使用最近鄰 (NearestNeighbor，英式或美式拼寫皆可)、雙線性 (Bilinear)、立方 (Cubic)、立方樣條 (CubicSpline) 或蘭索斯 (Lanczos) 重採樣演算法計算。預設為最近鄰，這是最快的方法，但會導致最差的插值結果。

gridx 和 gridy 定義新網格的任意像素角。這不一定是新影像的左上角，並且它不必位於新影像範圍內或邊緣上。

您可以選擇使用 scalex 和 scaley 定義新網格的像素大小。

新影像的範圍將包含所提供影像的範圍。

如果未指定 maxerr，則 maxerror 百分比為 0.125。

[Note]

有關更多詳細信息，請參閱：GDAL Warp 重採樣方法。
[Note]

如果需要更多控制網格參數，請使用 ST_Resample。

可用性：2.0.0 需要 GDAL 1.6.1+

已更改：2.1.0 可在沒有 SRID 的影像上運作

範例

一個簡單的範例，將影像對齊到稍微不同的網格。

-- the original raster upper left X
SELECT ST_UpperLeftX(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0));
-- result
0

-- the upper left of raster after snapping
SELECT ST_UpperLeftX(ST_SnapToGrid(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0), 0.0002, 0.0002));

--result
-0.0008