ST_Raster

定義

ST_Raster は、ST_Raster タイプのオブジェクトを作成します。

構文

Oracle

sde.st_raster (filename IN VARCHAR2)

sde.st_raster (filename IN VARCHAR2, 
               options IN VARCHAR2)

sde.st_raster (data IN ST_PIXELDATA)

sde.st_raster (data IN ST_PIXELDATA, 
               options IN VARCHAR2)

PostgreSQL

st_raster (filename IN TEXT)

st_raster (filename IN TEXT, 
           options IN TEXT)

st_raster (data IN ST_PIXELDATA)

st_raster (data IN ST_PIXELDATA, 
           options IN TEXT)

SQL Server

st_raster (filename IN NVARCHAR, 
           data IN ST_PIXELDATA, 
           options IN NVARCHAR)

パラメーター

パラメーター	説明
filename	ソース ラスター データの名前
data	定義済みの ST_PixelData オブジェクト
options	単一引用符で囲んだカンマ区切りのリスト。以下のパラメーターを指定できます。 align - ST_Raster のピクセル セルの配置に従うように、ソース ピクセルを最大でピクセル セルの幅または高さの半分まで自動的にシフトします。デフォルトではデータのシフトを行わず、データが整列されない場合はエラーを返します。 compression <lz77 | jpeg | jp2> - ST_Raster オブジェクトに適用する圧縮アルゴリズムを指定します。デフォルトでは、データは圧縮されません。 interleave <separate | contiguous> - このオプションは、3 バンドの 8 ビット ピクセル データを格納する ST_Raster オブジェクトに適用されます。インターリーブに separate を指定すると、ピクセル データが独立した RGB バンドに格納されます。contiguous を指定すると、ピクセル データは隣接する赤、緑、および青ピクセルの単一のバンドに格納されます。 recursive - 名前が検索条件に一致する画像ファイルを、filename 引数に指定したフォルダーとそのサブフォルダーで検索するようコンストラクターに指示します。 conversion <rgb | grayscale> - rgb に設定した場合は、シングルバンドのカラーマップ ソース画像を 3 バンドの RGB ST_Raster オブジェクトに変換するよう、コンストラクターに指示します。conversion パラメーターを grayscale に設定すると、コンストラクターは 1 ビットの白黒ソース画像を変換して、8 ビットのグレースケール ST_Raster オブジェクトに挿入します。 quality <値> - JPEG または JPEG 2000 可変圧縮に関する ST_Raster オプションの圧縮品質を指定します。 bitrate <値> - JPEG 2000 圧縮のビット レートを指定します。 nodata <(r,g,b) | 値> - ST_Raster に挿入したときに NoData に変換される、ソース画像のピクセル値を指定します。 nocolormap - カラーマップ ソース画像を ST_Raster に挿入するときに、カラーマップを削除するように指定します。 edge <値>:<許容値> - ST_Raster の周囲にある NoData にマークされた不要な境界ピクセルを削除します。edge オプションを指定すると、指定した値の範囲にあるピクセルだけが、ラスターの外側エッジのみから削除されます。これにより、ラスター内部にある同じ値のピクセルが削除されるのを防止します。 level=<ピラミッド レベル> - ソース画像を ST_Raster に挿入した後に作成される最大のピラミッド レベル。 origin (x,y) - ST_Raster のピラミッド基準原点。 skipLevel1 - ST_Raster のピラミッドの第 1 レベルを作成しません。 tile (<幅>,<高さ>) - タイルの ST_Raster 格納の幅と高さ。 nearest | bilinear | bicubic - ST_Raster オブジェクトのピラミッドを作成する内挿アルゴリズム。 log <ログファイル名> - コンストラクターが結果を書き込むログ ファイル。

例

Oracle

次の例は、ST_Raster コンストラクターを明示的に呼び出して、GeoTIFF 画像ファイルを ST_Raster オブジェクトに挿入しています。

INSERT INTO NOVA (image)
 VALUES (sde.st_raster('nova.tif','compression=lz77'));

次の例は、ST_Raster オブジェクトの値を、テーブル world からテーブル nova にコピーしています。この場合、INSERT ステートメントによって ST_Raster コンストラクターが暗黙的に呼び出され、コピー先のテーブルに ST_Raster オブジェクトが作成されます。

INSERT INTO NOVA (image)
SELECT image 
FROM WORLD;

次の例では、ST_Raster オブジェクトのピクセルで ST_PixelData オブジェクトを設定し、別の ST_Raster オブジェクトに挿入しています。

DECLARE
  	  data sde.ST_PixelData;
BEGIN
  	  SELECT t.image.getPixelData('level=1') INTO DATA FROM NOVA t;
  	  INSERT INTO NOVA VALUES (sde.st_raster(data, 'compression=lz77'));
     END; 
     /

PostgreSQL

次の例は、ST_Raster コンストラクターを明示的に呼び出して、GeoTIFF 画像ファイルを ST_Raster オブジェクトに挿入しています。

INSERT INTO nova (image)
VALUES (sde.st_raster('nova.tif','compression=lz77'));

次の例は、ST_Raster オブジェクトの値を、テーブル world からテーブル nova にコピーしています。この場合、INSERT ステートメントによって ST_Raster コンストラクターが暗黙的に呼び出され、コピー先のテーブルに ST_Raster オブジェクトが作成されます。

INSERT INTO nova (image)
SELECT image 
FROM world;

次の例では、ST_Raster オブジェクトのピクセルで ST_PixelData オブジェクトを設定し、別の ST_Raster オブジェクトに挿入しています。

DECLARE data st_pixeldata; 
BEGIN 
		SELECT getPixelData(image, 'level=1') 
  INTO data 
  FROM nova; 
  INSERT into nova 
  VALUES (sde.st_raster(data,''compression=lz77'')); 
END;

SQL Server

次の例は、ST_Raster コンストラクターを明示的に呼び出して、GeoTIFF 画像ファイルを ST_Raster オブジェクトに挿入しています。

INSERT INTO nova (image)
 VALUES (ST_Raster::construct('nova.tif',NULL,'compression=lz77'));

次の例は、ST_Raster オブジェクトの値を、テーブル world からテーブル nova にコピーしています。この場合、INSERT ステートメントによって ST_Raster コンストラクターが暗黙的に呼び出され、コピー先のテーブルに ST_Raster オブジェクトが作成されます。

INSERT INTO nova (image)
SELECT image 
FROM world;

次の例では、ST_Raster オブジェクトのピクセルで ST_PixelData オブジェクトを設定し、別の ST_Raster オブジェクトに挿入しています。

DECLARE
@data ST_Pixeldata;
SET @data =
(SELECT image.getPixelData('level=1')
 FROM nova);
 INSERT INTO nova
 
VALUES (ST_Raster::construct(NULL, @data, 'compression=lz77')) ;