ST_Raster.buildPyramid

定义

ST_Raster buildPyramid 函数用于构建 ST_Raster 对象的金字塔。此函数仅可用于 SQL UPDATE 语句。在 SELECT 语句中使用时，将返回数据库错误。

语法

Oracle

buildPyramid () RETURN ST_RASTER

buildPyramid (parameter_list IN VARCHAR2) RETURN ST_RASTER

PostgreSQL

buildPyramid (raster IN ST_Raster)

buildPyramid (raster IN ST_Raster, 
              parameter_list IN TEXT)

SQL Server

buildPyramid (parameter_list IN NVARCHAR)

返回值

ST_Raster

参数

parameter_list - 用单引号括起来且以逗号分隔的参数列表；如果未提供参数列表，则将等级设置为 0（删除任何现有金字塔）。参数列表可包含以下参数：

• level <值> - 要构建的最高金字塔等级；默认为 -1，用于指示函数自动确定最高金字塔等级。要移除金字塔，请将该参数设置为 0。
• skipLevel1 - 指示函数不存储第一金字塔等级
• nearest | bilinear | bicubic - 用于构建金字塔的插值算法；默认为最邻近
• quality <值> - 如果基础图层的压缩类型为 JPEG 或 JPEG 2000，则通过设置此参数来控制金字塔的压缩质量。JPEG 压缩的默认值为 75，而 JPEG 2000 压缩的默认值为 0。
• bitrate <值> - JPEG 2000 压缩的比特率
• log <日志文件名> - 用于捕捉 buildPyramid 函数的结果的日志文件。

示例

下面示例所显示的具体内容如下：

1. 第一个示例是使用双线性插值法和默认自动金字塔等级选项为用户定义表中的所有 ST_Raster 对象构建栅格金字塔的语句。
2. 在第二个示例中，nova 表中所有 ST_Raster 对象的栅格金字塔均通过将金字塔等级设置为 0 移除。
3. 在最后一个示例中，未存储金字塔的第一等级；仅存储了第二等级和更高等级。此外，金字塔是使用双线性插值法创建的，而不是使用默认的最邻近法创建的。

Oracle

• UPDATE NOVA n 
  SET image = n.image.buildPyramid('bilinear');

• UPDATE NOVA n 
  SET image = n.image.buildPyramid('level=0');

• UPDATE NOVA n
  SET image = n.image.buildPyramid('skipLevel1,bilinear');

PostgreSQL

• UPDATE nova 
  SET image = buildPyramid(image,'bilinear');

• UPDATE nova 
  SET image = buildPyramid(image,'level=0');

• UPDATE nova 
  SET image = buildPyramid(image,'skipLevel1,bilinear');

SQL Server

• UPDATE nova 
  SET image = image.buildPyramid('bilinear');

• UPDATE nova 
  SET image = image.buildPyramid('level=0');

• UPDATE nova 
  SET image = image.buildPyramid('skipLevel1,bilinear');