SDO_GEOR.setDefaultAlpha

形式

SDO_GEOR.setDefaultAlpha(
     georaster     IN OUT SDO_GEORASTER, 
     defaultAlpha  IN NUMBER);

説明

GeoRasterオブジェクトを表示する際に、(RGBA色空間の)アルファの色構成要素に使用されるレイヤー番号を設定します。または、defaultAlphaパラメータにNULLが指定された場合、既存の値を削除します。

パラメータ

georaster: GeoRasterオブジェクトを指定します。
defaultAlpha: 指定したGeoRasterオブジェクトを表示する際に、(RGBA色空間の)アルファの色構成要素に使用されるレイヤー番号を指定します。指定する値は0(ゼロ)より大きく、GeoRasterオブジェクトのレイヤーの最大番号以下である必要があります。

使用上のノート

デフォルトの赤、緑、青およびアルファの値は、疑似カラー表示またはグレースケール表示ではなく、トゥルーカラー表示に使用されます。これらの値はオプションで、マルチレイヤーまたはハイパースペクトルのGeoRasterオブジェクトをビジュアル化する場合にのみ使用されます。

処理の完了後、GeoRasterオブジェクトは自動的に検証されます。

アルファの色構成要素のみで使用するレイヤー番号を設定しようとした場合、またはdefaultAlphaが、GeoRasterオブジェクトの有効なレイヤー番号ではない場合は、例外が発生します。

例

次の例では、GEORASTER_TABLE表に含まれるGeoRasterオブジェクト(GEORASTER列)のデフォルトの赤、緑、青およびアルファの色レイヤーを設定して、それらのGeoRasterオブジェクトを表示する際に赤、緑、青およびアルファの色構成要素に使用されるレイヤー番号の配列を戻します。(GEORASTER_TABLE表の定義は、「記憶域パラメータ」の例1-1の次に説明されています。)

DECLARE
  grobj sdo_georaster;
BEGIN
  SELECT georaster INTO grobj FROM georaster_table WHERE georid=4 FOR UPDATE;
  sdo_geor.setDefaultRed(grobj, 5);
  sdo_geor.setDefaultGreen(grobj, 4);
  sdo_geor.setDefaultBlue(grobj, 3);
  sdo_geor.setDefaultAlpha(grobj, 2);
  UPDATE georaster_table SET georaster = grobj WHERE georid=4;
  COMMIT;
END;
/

SELECT sdo_geor.getDefaultColorLayer(georaster) FROM georaster_table
  WHERE georid=4;
 
SDO_GEOR.GETDEFAULTCOLORLAYER(GEORASTER)
--------------------------------------------------------------------------------
SDO_NUMBER_ARRAY(5, 4, 3, 2)
 
1 row selected.

7.123 SDO_GEOR.setDefaultAlpha