ST_AsPNG
上一个  11.11. 栅格输出  下一个

名称

ST_AsPNG — 将所选波段的栅格瓦片作为单个可移植网络图形 (PNG) 图像（字节数组）返回。如果栅格中包含 1、3 或 4 个波段，且未指定任何波段，则使用所有波段。如果包含 2 个或多于 4 个波段，且未指定任何波段，则仅使用波段 1。波段被映射到 RGB 或 RGBA 空间。

概要

bytea ST_AsPNG(raster rast, text[] options=NULL);

bytea ST_AsPNG(raster rast, integer nband, integer compression);

bytea ST_AsPNG(raster rast, integer nband, text[] options=NULL);

bytea ST_AsPNG(raster rast, integer[] nbands, integer compression);

bytea ST_AsPNG(raster rast, integer[] nbands, text[] options=NULL);

描述

将栅格的所选波段作为单个可移植网络图形图像 (PNG) 返回。 如果需要导出为不太常见的栅格类型，请使用 ST_AsGDALRaster。 如果未指定任何波段，则导出前 3 个波段。 该函数有许多变体，包含许多选项。 如果未指定 srid，则使用栅格的 srid。下面列出这些变体。

  • nband 用于单波段导出。

  • nbands 是要导出的波段数组（请注意，PNG 的最大值为 4），波段的顺序是 RGBA。 例如，ARRAY[3,2,1] 表示将波段 3 映射到红色，波段 2 映射到绿色，波段 1 映射到蓝色。

  • compression 数字从 1 到 9。数字越大，压缩率越高。

  • options 是 GDAL 选项的文本数组，如 PNG 所定义（请查看 ST_GDALDrivers 的 PNG 的 create_options）。对于 PNG，唯一有效的选项是 ZLEVEL（用于压缩的时间量 -- 默认值为 6），例如 ARRAY['ZLEVEL=9']。不允许使用 WORLDFILE，因为该函数必须输出两个输出。有关更多详细信息，请参阅 GDAL 栅格格式选项。

可用性：2.0.0 - 需要 GDAL >= 1.6.0。

示例

SELECT ST_AsPNG(rast) As rastpng
FROM dummy_rast WHERE rid=2;

-- export the first 3 bands and map band 3 to Red, band 1 to Green, band 2 to blue
SELECT ST_AsPNG(rast, ARRAY[3,1,2]) As rastpng
FROM dummy_rast WHERE rid=2;