ラスタオブジェクトを JPEG のバイナリ ストリームに変換します。
構文
bytea ST_AsJPEG(raster raster_obj,
box extent,
integer pyramidLevel default 0,
cstring bands default '',
cstring option default '');パラメータ
パラメータ | 説明 |
raster_obj | 処理するラスタオブジェクトです。 |
extent | 画像の範囲です。デフォルトでは、地理座標系が使用されます。 |
pyramidLevel | 画像のピラミッド レベルです。レベルは 0 から始まります。デフォルト値は 0 です。 |
bands | 取得するバンドのリストです。 JPEG 画像のバンド数に基づいて、バンドのリストを設定します。設定ルールは次のとおりです。
|
option | JSON 文字列で指定する変換オプションです。 |
次の表では、option パラメーターのフィールドについて説明します。
パラメータ名 | 説明 | タイプ | デフォルト値 | 説明 |
nodata | NoData 値を処理するかどうかを指定します。 | bool | false |
|
nodataValue | NoData 値です。 | integer | 0 | nodata が true に設定されている場合、このパラメーターの値を指定する必要があります。 |
rast_coord | 入力の | bool | false | ピクセル座標を使用する場合、x 座標はピクセルの列番号、y 座標は行番号を表します。どちらの番号も 0 から始まります。 |
strength | 表示拡張を適用するかどうかを指定します。 | string | none | 表示拡張の方法です。有効な値：
|
quality | 圧縮品質です。 | integer | 75 | 値の範囲は 1 ～ 100 です。 |
説明
この関数は
bytea形式の画像を返します。デフォルトのクリッピングキャッシュは 100 MB で、結果データの最大サイズを定義します。この制限を調整するには、[ganos.raster.clip_max_buffer_size] パラメーターを使用してキャッシュサイズを設定します。
バンド数は次のとおりです。
1：グレースケール画像の単一バンド。
3：R、G、B の 3 バンド。
例
-- クリッピング範囲の使用
SELECT ST_AsJPEG(raster_obj,
'(-180,-90), (0,0)'::Box)
FROM raster_table
WHERE id =1;
-- ピラミッド レベルの指定
SELECT ST_AsJPEG(raster_obj,
'(-180,-90), (0,0)'::Box,
1)
FROM raster_table
WHERE id =1;
-- バンドとクリッピング範囲の指定
SELECT ST_AsJPEG(raster_obj,
'(-180,-90), (0,0)'::Box,
1,
'0-2')
FROM raster_table
WHERE id =1;
-- 統計値に基づくストレッチの使用
SELECT ST_AsJPEG(rast,
'(-180,-90), (0,0)'::Box,
0,
'',
'{"nodata":"false", "nodatavalue":"0","rast_coord":"false", "strength":"stats", "quality":"75"}')
FROM raster_table
WHERE id =1;