ST_AsJPEG
戻る  11.11. 出力  次へ

名前

ST_AsJPEG — ラスターの選択されたバンドを、単一の Joint Photographic Exports Group (JPEG) 画像としてバイト配列で返します。バンドを指定せず、1バンドか 3より多いバンドがある場合には、1番バンドを使用します。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);

説明

ラスターの選択されたバンドを、単一の Joint Photographic Exports Group (JPEG) 画像として返します。 より一般でないラスタータイプで出力する必要がある場合には、ST_AsGDALRasterを使います。バンドを指定せず、1バンドか3より多いバンドがある場合には、1番バンドを使用します。3バンドのみ指定した場合には、3バンドを使用します。この関数には多数の任意引数が付くさまざまな形式があります。引数については次の通りです。

  • nband 単一バンド出力のためのものです。

  • nbands 出力バンドの配列 (JPEG では 3要素が最大です) で、バンドの並び順は RGB です。たとえば ARRAY[3,2,1]は、3番バンドを赤、2番バンドを緑、1番バンドを青にそれぞれ対応させます。

  • quality 0から 100の数値です。高いほどしっかりした画像になります。

  • options JPEG のために定義する GDAL オプションの文字列配列です (ST_GDALDriversの create_options を見てください)。JPEG の妥当なパラメーターは PROGRESSIVEの'ON'または'OFF'と、QUALITYの 0から 100までの数 (デフォルトは 75) です。詳細については GDAL Raster format optionsをご覧下さい。

Availability: 2.0.0 - GDAL 1.6.0以上が必要です。

例: 出力

最初の 3バンドを 75%品質で出力します。

コード
SELECT ST_AsJPEG(rast) As rastjpg
FROM dummy_rast WHERE rid=2;

最初のバンドだけを 90%品質で出力します。

コード
SELECT ST_AsJPEG(rast, 1, 90) As rastjpg
FROM dummy_rast WHERE rid=2;

先頭から 3バンドを、2番バンドは赤に、1番バンドは緑に、3番バンドは青に、それぞれ割り当て、プログレッシブを使用した 90%品質で出力します。

コード
SELECT ST_AsJPEG(rast, ARRAY[2, 1, 3], ARRAY['QUALITY=90', 'PROGRESSIVE=ON']) As rastjpg
FROM dummy_rast WHERE rid=2;