このトピックでは、ST_AsJPEG関数について説明します。 この関数は、ラスターオブジェクトをBYTEAタイプのJPEG画像に変換します。
構文
bytea ST_AsJPEG (ラスターraster_obj、
ボックスの範囲、
integer pyramidLevel default 0,
cstring bands default '',
cstringオプションdefault ''); パラメーター
| パラメーター | 説明 |
| raster_obj | 変換するラスタオブジェクト。 |
| 範囲 | 抽出するデータの部分。 デフォルトでは、データの一部は地理座標系 (GCS) に基づいて指定されます。 |
| pyramidLevel | データを抽出するピラミッドレベル。 有効な値は0から始まります。 デフォルト値：0 |
| バンド | 取得するバンド。The bands that you want to get. このパラメーターは、JPEG画像のバンド数に基づいて設定する必要があります。 次のリストでは、設定ルールについて説明します。
|
| オプション | JSON形式の文字列を変換するために使用されるオプション。 |
次の表に、optionパラメーターのフィールドを示します。
| フィールド | 説明 | データ型 | デフォルト | 説明 |
| ノデータ | NoData値を処理するかどうかを指定します。 | bool | false |
|
| nodataValue | ラスターのNoData値。 | integer | 0 | nodataパラメーターがtrueに設定されている場合は、このパラメーターも指定する必要があります。 |
| rast_coord | 入力ボックスをピクセル座標で指定するかどうかを指定します。 | bool | false | ピクセル座標が使用される場合、x座標は、列番号を指定する。 を指定し、y座標は行番号を指定します。 ピクセルの 両方の列番号。 と行番号 0から開始します。 |
| 強さ | ディスプレイにエンハンスメントを実装するかどうかを指定します。 | String | none | 有効な値：
|
| 品質 | 圧縮後の新しいラスターの画質。 | integer | 75 | 設定可能な値は 1～100 です。 |
説明
- この関数は、BYTEAタイプのJEPGイメージを返します。
- 抽出されたデータを格納するキャッシュのデフォルトサイズは100 MBです。 つまり、最大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;
-データを抽出するバンドのIDを指定します。
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;