Name

ST_AsJPEG — 将栅格拼贴选定的带区作为单个联合照片导出组(JPEG)图像(字节数组)返回。如果未指定标注栏且有1个或3个以上标注栏,则仅使用第一个标注栏。如果只有3个波段,则使用所有3个波段并将其映射到RGB。

Synopsis

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

bytea ST_AsJPEG(raster rast, integer nband, integer quality);

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

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

bytea ST_AsJPEG(raster rast, integer[] nbands, integer quality);

描述

将栅格的选定带区作为单个联合图像导出组图像(JPEG)返回。使用 ST_AsGDALRaster 如果需要作为不太常见的栅格类型导出。如果未指定标注栏且有1个或3个以上标注栏,则仅使用第一个标注栏。如果是3个波段,则使用全部3个波段。该函数有许多变体,具有许多选项。现将这些建议逐项列出:

  • nband 是针对单波段出口的。

  • nbands 是要导出的带区数组(请注意,对于JPEG,最大值为3),带区的顺序为RGB。例如,数组[3,2,1]表示将波段3映射为红色,将波段2映射为绿色,将波段1映射为蓝色

  • quality 0到100之间的数字。数字越大,图像越清晰。

  • options 为JPEG定义的GDAL选项的文本数组(请参阅JPEG的Create_Options ST_GDALDrivers )。对于JPEG,有效值为 PROGRESSIVE 开或关,然后 QUALITY 范围从0到100,默认为75。参考 GDAL栅格格式选项 了解更多详细信息。

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

示例:输出

-- output first 3 bands 75% quality
SELECT ST_AsJPEG(rast) As rastjpg
    FROM dummy_rast WHERE rid=2;

-- output only first band as 90% quality
SELECT ST_AsJPEG(rast,1,90) As rastjpg
    FROM dummy_rast WHERE rid=2;

-- output first 3 bands (but make band 2 Red, band 1 green, and band 3 blue, progressive and 90% quality
SELECT ST_AsJPEG(rast,ARRAY[2,1,3],ARRAY['QUALITY=90','PROGRESSIVE=ON']) As rastjpg
    FROM dummy_rast WHERE rid=2;

另请参阅

Section 11.3, “使用PostGIS栅格构建自定义应用程序”, ST_GDALDrivers, ST_AsGDALRaster, ST_AsPNG, ST_AsTIFF