文档

ST_AsTile

更新时间:

从栅格对象裁剪出256或512像素尺寸的瓦片,并转换为基于文件格式的二进制流输出。

语法

record ST_AsTile(raster raster_obj, geometry geom, cstring export_options default '');

返回值

返回一条记录,其中字段包括:

  • ext:影像格式。

  • data:一个bytea表示的256或512像素尺寸的瓦片。

参数

参数名称

描述

raster_obj

输入栅格对象。

geom

表示Tile范围的几何对象。

export_options

输出选项。

描述

export_options参数如下所示:

参数名称

描述

类型

默认值

说明

bands

输出波段列表,以逗号隔开,默认为全波段。

cstring

''

默认为全波段。

format

输出图像格式。

cstring

PNG

支持PNG、JPEG和GTiff三种格式。

pyramid_level

金字塔层级。

integer

-1

默认选择最佳波段。

dim

输出tile的像素尺寸。

integer

256

仅允许指定256或512。

nodata

是否考虑nodata。

boolean

true

如果不指定默认使用数据本身nodata。

nodatavalue

nodata值。

f8

0

当nodata为true时有效。

strength

是否进行增强。

string

none

显示增强的方式,取值如下:

  • none:不进行增强。

  • stats:使用统计值进行拉伸。

  • ratio:按照百分比拉伸。

ratio_offset

百分比偏离。

integer

2

按照n - (100-n)百分比进行拉伸。

alpha

是否增加alpha波段实现透明效果。

boolean

false

-

quality

压缩质量。

integer

75

压缩质量取值为0(最差)~100(最佳)。

示例

SELECT ST_AsTile(rast, ST_GeomFromText('POLYGON((-80 30,-100 30, -100 100, -80 100, -80 30))',4326),'{"format":"PNG","bands":"0,1,2"}') FROM raster_table;

SELECT ST_AsTile(rast, ST_GeomFromText('POLYGON((-80 30,-100 30, -100 100, -80 100, -80 30))',4326),'{"format":"GTiff","bands":"0,1,2","pyramid_level":7}') FROM raster_table;