ST_Raster.crop

定義

ST_Raster.crop 関数は、既存の ST_Raster オブジェクトを指定した範囲にトリミングします。範囲は、地理座標またはピクセル座標のどちらかで指定できます。関数は SQL UPDATE ステートメント内でのみ適用できます。それ以外の場所(SELECT ステートメントや WHERE 句など)で使用した場合は、データベース エラーが返されます。SQL SELECT ステートメントの選択リストで同様の機能を利用するには、ST_Raster.subset 関数をご参照ください。

構文

Oracle

crop (extent IN VARCHAR2) RETURN ST_RASTER

crop (extent IN VARCHAR2, 
      unit IN VARCHAR2) RETURN ST_RASTER

PostgreSQL

crop (raster IN ST_RASTER, 
      extent IN TEXT) RETURN ST_RASTER

crop (raster IN ST_RASTER, 
      extent IN TEXT, 
      unit IN TEXT) RETURN ST_RASTER

SQL Server

crop (extent IN NVARCHAR, 
      unit IN NVARCHAR) RETURN ST_RASTER

戻り値

ST_Raster

パラメータ

パラメータ

説明

extent <minx,miny,maxx,maxy>

トリミングする ST_Raster の範囲(地理座標)

raster

トリミングする ST_Raster 値

unit <'pixel'>

pixel キーワードを指定すると、extent がピクセル座標として入力されます。pixel の引数を省略すると、extent は地理座標として入力されます。

次の例は、既存のラスタを(0,0,100,100)の範囲でトリミングしています。

Oracle

UPDATE IMAGE2 i 
SET image = i.image.crop ('0,0,100,100', 'pixel');

PostgreSQL

UPDATE image2 
SET image = crop (image, '0,0,100,100', 'pixel');

SQL Server

UPDATE image2 
SET image = image.crop ('0,0,100,100', 'pixel');
9/14/2013