ST_AsJPEG
上一頁  11.11. 網格輸出  下一頁

名稱

ST_AsJPEG — 將選定的網格圖層波段以單一聯合圖像專家組 (JPEG) 圖像（位元組陣列）傳回。如果沒有指定波段且有 1 個或超過 3 個波段，則僅使用第一個波段。如果只有 3 個波段，則會使用全部 3 個波段並對應到 RGB。

概要

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。例如，ARRAY[3,2,1] 表示將波段 3 對應到紅色，波段 2 對應到綠色，而波段 1 對應到藍色

  • quality 是介於 0 到 100 的數字。數字越高，影像越清晰。

  • options 是 GDAL 選項的文字陣列，定義為 JPEG（請參閱 JPEG 的 create_options ST_GDALDrivers）。對於 JPEG，有效的值為 PROGRESSIVE ON 或 OFF，以及 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;