SDO_GEOR.getDefaultColorLayer

形式

SDO_GEOR.getDefaultColorLayer(
     georaster  IN SDO_GEORASTER 
     ) RETURN SDO_NUMBER_ARRAY;

説明

GeoRasterオブジェクトを表示する際に、赤、緑、青およびアルファの各色構成要素に使用されるデフォルトのレイヤー番号を戻します。

パラメータ

georaster: GeoRasterオブジェクトを指定します。

使用上のノート

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

SDO_GEOR.getDefaultRed、SDO_GEOR.getDefaultGreen、SDO_GEOR.getDefaultBlueおよびSDO_GEOR.getDefaultAlphaファンクションを使用すると、各色構成要素(RGBA)のレイヤー番号を戻すことができます。

アルファの色構成要素は、オプションです。デフォルトのアルファの色構成要素がメタデータに存在する場合、このファンクションは、それぞれ赤、緑、青およびアルファの色構成要素を識別する4つの数値の配列を戻します。デフォルトの赤、緑および青の色構成要素のみがメタデータに存在する場合、このファンクションは、それぞれ赤、緑および青の色構成要素を識別する3つの数値の配列を戻します。

例

次の例では、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, 2);
  sdo_geor.setDefaultGreen(grobj, 3);
  sdo_geor.setDefaultBlue(grobj, 1);
  sdo_geor.setDefaultAlpha(grobj, 4);
  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(2, 3, 1)
SDO_NUMBER_ARRAY(2, 3, 1, 4)
 
1 row selected.

7.56 SDO_GEOR.getDefaultColorLayer