ArcMap

ST_Raster.buildPyramid

定義

ST_Raster の buildPyramid 関数は、ST_Raster オブジェクトのピラミッドを構築します。この関数は SQL UPDATE ステートメントのみで使用します。SELECT ステートメントで使用すると、データベース エラーが返されます。

構文

Oracle

buildPyramid () RETURN ST_RASTER

buildPyramid (parameter_list IN VARCHAR2) RETURN ST_RASTER

PostgreSQL

buildPyramid (raster IN ST_Raster)

buildPyramid (raster IN ST_Raster, 
              parameter_list IN TEXT)

SQL Server

buildPyramid (parameter_list IN NVARCHAR)

戻り値

ST_Raster

パラメーター

parameter_list - 単一引用符で囲んだパラメーターのカンマ区切りのリスト。パラメーター リストを指定しない場合は、level が 0 に設定されます (既存のピラミッドがすべて削除されます)。パラメーター リストには、以下のパラメーターを指定します。

  • level <値> - 構築するピラミッドの最大レベル。デフォルトは -1 で、最大ピラミッド レベルが自動的に決定されます。ピラミッドを削除するには、このパラメーターを 0 に設定します。
  • skipLevel1 - 最初のピラミッド レベルを格納しません。
  • nearest | bilinear | bicubic - ピラミッドの構築に使用する内挿アルゴリズム。デフォルトは nearest です。
  • quality <値> - ベース レイヤーの圧縮タイプが JPEG または JPEG 2000 の場合は、このパラメーターを設定してピラミッドの圧縮品質を制御します。JPEG 圧縮のデフォルトは 75、JPEG 2000 圧縮のデフォルトは 0 です。
  • bitrate <値> - JPEG 2000 圧縮のビット レート。
  • log <ログファイル名> - buildPyramid 関数の結果を記録するログ ファイル。

例

以下の例では、次の内容を示します。

  1. 1 つめの例では、共一次内挿法とデフォルトの自動ピラミッド レベル オプションを使用して、ユーザー定義のテーブルに格納されているすべての ST_Raster オブジェクトのラスター ピラミッドを構築するステートメントを示します。
  2. 2 つめの例では、ピラミッド レベルを 0 に設定して、nova テーブルに格納されたすべての ST_Raster オブジェクトのラスター ピラミッドを削除します。
  3. 最後の例では、ピラミッドの第 1 レベルを格納せず、第 2 レベル以降を格納しています。また、デフォルトの最近隣内挿でなく、共一次内挿法を使用してピラミッドを作成します。

Oracle

  • UPDATE NOVA n 
SET image = n.image.buildPyramid('bilinear');

  • UPDATE NOVA n 
SET image = n.image.buildPyramid('level=0');

  • UPDATE NOVA n
SET image = n.image.buildPyramid('skipLevel1,bilinear');

PostgreSQL

  • UPDATE nova 
SET image = buildPyramid(image,'bilinear');

  • UPDATE nova 
SET image = buildPyramid(image,'level=0');

  • UPDATE nova 
SET image = buildPyramid(image,'skipLevel1,bilinear');

SQL Server

  • UPDATE nova 
SET image = image.buildPyramid('bilinear');

  • UPDATE nova 
SET image = image.buildPyramid('level=0');

  • UPDATE nova 
SET image = image.buildPyramid('skipLevel1,bilinear');