7.122 SDO_GEOR.setControlPoint

形式

SDO_GEOR.setControlPoint (
     inGeoraster  IN OUT SDO_GEORASTER, 
     controlPoint IN SDO_GEOR_GCP);

説明

GeoRasterオブジェクトの地上基準点(GCP)を追加するか、既存のGCPを置き換えます(入力基準点と同じID値を持つ場合)。

パラメータ

inGeoraster

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

controlPoint

inGeorasterに追加するGCPを指定します。SDO_GEOR_GCP型のオブジェクトを指定する必要があります(「SDO_GEOR_GCPオブジェクト型」を参照)。

使用上のノート

GCPを使用した地理参照の詳細は、「地上基準点(GCP)地理参照モデル」を参照してください。

controlPointがNULLの場合、ファンクションはアクションを実行せずに戻されます。GCPがcontrolPointで定義されているものと同じ点IDを持つGeoRasterオブジェクト・メタデータで検出されると、そのGCPは置換されますが、それ以外の場合はこのGCPが地理参照モデルに追加されます。

例

次の例では、指定したGeoRasterオブジェクトにGCPを追加します。

DECLARE
   gr1            sdo_georaster;
   GCP         SDO_GEOR_GCP;
BEGIN
   SELECT georaster INTO gr1 from georaster_table WHERE georid=10 FOR UPDATE;
 
   GCP := SDO_GEOR_GCP('21', 'Updated', 1, 
                       2, sdo_number_array(25.625000, 73.875000),
                       2, sdo_number_array(237036.937500, 897987.187500),
                       NULL, NULL);
   sdo_geor.setControlPoint(gr1, GCP);
   UPDATE georaster_table SET georaster=gr1 WHERE georid=10;
   COMMIT;
END;
/