SDO_GEOR.setDefaultColorLayer

形式

SDO_GEOR.setDefaultColorLayer(
     georaster   IN OUT SDO_GEORASTER, 
     defaultRGB  IN SDO_NUMBER_ARRAY);

説明

GeoRasterオブジェクトを表示する際に、赤、緑、青およびアルファの各色構成要素に使用されるデフォルトのレイヤー番号を設定します。または、defaultRGBパラメータにNULLが指定された場合、既存の値を削除します。

パラメータ

georaster: GeoRasterオブジェクトを指定します。
defaultRGB: 指定したGeoRasterオブジェクトを表示する際の赤、緑、青およびアルファの各色構成要素を示す3つまたは4つの数値の配列を指定します。各数値は0(ゼロ)より大きく、GeoRasterオブジェクトのレイヤーの最大番号以下である必要があります。

使用上のノート

指定されたRGBAレイヤー番号は、疑似カラー表示またはグレースケール表示ではなく、トゥルーカラー表示に使用されます。

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

SDO_GEOR.setDefaultRed、SDO_GEOR.setDefaultGreen、SDO_GEOR.setDefaultBlueおよびSDO_GEOR.setDefaultAlphaプロシージャを使用すると、それぞれの色構成要素(RGB)のレイヤー番号を設定できます。

デフォルトのRGBAレイヤー番号は、同時に設定または削除する必要があります。デフォルトのアルファ・レイヤー番号はオプションです。デフォルトの赤、緑および青のレイヤー番号を設定する場合、デフォルトのアルファ・レイヤー番号を設定できます。デフォルトの赤、緑および青のレイヤー番号を削除する場合、デフォルトのアルファ・レイヤー番号も削除する必要があります。

デフォルトのアルファ・レイヤーはオプションであるため、(A)このプロシージャに3つの数値を指定してデフォルトの赤、緑および青の色構成要素を設定するか、(B)このプロシージャに4つの数値を指定してデフォルトの赤、緑、青およびアルファの色構成要素を設定できます。defaultRGBが3つの数値の配列である場合、それは赤、緑および青の色構成要素のみを示します。defaultRGBが4つの数値の配列である場合、それは赤、緑、青およびアルファの構成要素を示します。

defaultRGBが不適切なサイズの場合、またはこのパラメータのいずれかの要素がNULLであるか、GeoRasterオブジェクトに対して無効なレイヤー番号である場合は、例外が発生します。

例

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

DECLARE
  grobj sdo_georaster;
BEGIN
  SELECT georaster INTO grobj FROM georaster_table WHERE georid=2 FOR UPDATE;
  sdo_geor.setDefaultColorLayer(grobj, sdo_number_array(1,1,1,1));
  UPDATE georaster_table SET georaster = grobj WHERE georid=2;
  COMMIT;
END;
/

7.125 SDO_GEOR.setDefaultColorLayer