文档

ST_Clip

更新时间:

对raster对象进行裁剪操作。

语法

bytea ST_Clip(raster raster_obj,integer pyramidLevel,  box extent, BoxType boxType);
bytea ST_Clip(raster raster_obj,integer pyramidLevel,  box extent, BoxType boxType, integer destSrid);
record ST_Clip(raster raster_obj,
                     geometry geom,
                     integer pyramidLevel default 0,
                     cstring bands default '',
                     float8[] nodata default NULL,
                     cstring clipOption default '',
                     cstring storageOption default '',
                     out box outwindow,
                     out bytea rasterblob)

参数

参数名称

描述

raster_obj

需要裁剪的raster对象。

pyramidLevel

金字塔层级。

extent

需要裁剪的范围,格式为'((minX,minY),(maxX,maxY))'

boxType

范围的类型,只能是以下一种:

  • Raster (像元坐标)

  • World (世界坐标)

destSrid

指定输出像元子集的空间参考值。

geom

需要裁剪的geometry对象。

bands

需要裁剪的波段,用'0-2'或者‘1,2,3’这种形式表示,以0开始。 默认为'', 表示裁剪所有的波段。

nodata

用float8[]表示的nodata数值。 如果数值个数少于波段数量,则使用波段设置的nodata值填充。如果波段未设置nodata,则用0填充。

clipOption

表示裁剪选项。

storageOption

表示返回结果的存储选项。

outwindow

表示结果raster对象的大小。

rasterblob

表示二进制像素矩阵。

clipOption参数如下。

参数名称

类型

默认值

描述

window_clip

bool

false

是否使用geometry的外包框进行裁剪。取值:

  • true:使用geometry的MBR裁剪。

  • false:使用geometry对象裁剪。

rast_coord

bool

false

传入的geometry是否使用的是象元坐标。如果是象元坐标,横坐标x表示象元的列号(起始为0),纵坐标y表示象元的行号(起始为0)。

storageOption参数如下。

参数名称

类型

默认值

描述

compression

string

lz4

压缩算法类型。取值:

  • none

  • jpeg

  • zlib

  • png

  • lzo

  • lz4

quality

integer

75

压缩质量,只针对jpeg压缩算法。

interleaving

string

和原始raster一致

交错方式。取值:

  • bip:Band interleaved by pixel。

  • bil:Band interleaved by pixel。

  • bsq:Band Sequential。

endian

string

和原始raster一致

字节序。取值:

  • NDR:Little endian。

  • XDR:Big endian。

描述

默认的裁剪缓存为100 MB,代表最多只能裁剪出100 MB大小的结果数据,如果需要调整返回结果大小,可使用参数ganos.raster.clip_max_buffer_size设置缓存的大小。

示例

Select ST_Clip(raster_obj, 0, '((128.980,30.0),(129.0,30.2))', 'World') from clip_table;
Select ST_Clip(raster_obj, 0, '((128.980,30.0),(129.0,30.2))', 'World', 4326) from clip_table;

-- 使用geometry裁剪
-- 都是用默认值裁剪
SELECT (ST_CLIP(rast, ST_geomfromtext('Polygon((0 0, 45 45, 90 45, 45 0, 0 0))', 4326), 0)).* from clip_table where id =1;

-- 使用白色作为背景色填充并且压缩为png图片
SELECT (ST_CLIP(rast, ST_geomfromtext('Polygon((0 0, 45 45, 90 45, 45 0, 0 0))', 4326), 0, '', ARRAY[254,254,254], '', '{"compression":"png","interleaving":"bip"}')).* from clip_table where id =1;

-- 使用geometry的窗口裁剪
SELECT (ST_CLIP(rast, ST_geomfromtext('Polygon((0 0, 45 45, 90 45, 45 0, 0 0))', 4326), 0, '', NULL, '{"window_clip":true}', '')).* from clip_table where id =1;
  • 本页导读 (1)
文档反馈