29.7 SDO_TIN_PKG.TO_GEOMETRY

書式

SDO_TIN_PKG.TO_GEOMETRY(
     pts         IN BLOB, 
     trs         IN BLOB, 
     num_pts     IN NUMBER, 
     num_trs     IN NUMBER, 
     tin_ind_dim IN NUMBER, 
     tin_tot_dim IN NUMBER, 
     srid        IN NUMBER DEFAULT NULL, 
     blk_domain  IN SDO_ORGSCL_TYPE DEFAULT NULL, 
     get_ids     IN NUMBER DEFAULT NULL 
     ) RETURN SDO_GEOMETRY;

説明

TINのすべてまたは一部を表すジオメトリ・オブジェクトを戻します。

パラメータ

pts

点を含むBLOBを指定します。

trs

三角形を含むBLOBを指定します。

num_pts

結果として生成されるジオメトリに含まれる点の最大数を指定します。

num_pts

結果として生成されるジオメトリに含まれる三角形の最大数を指定します。

tin_ind_dim

索引付けする空間次元数を指定します。

tin_tot_dim

データに定義する空間次元数を指定します。

srid

データに関連付けられた空間参照(座標系)IDを指定します。このパラメータがNULLの場合、SRID値はデータに関連付けられません。

blk_domain

(現在は使用されていません)

get_ids

NULLまたは0 (デフォルト)の場合は、戻されるジオメトリ内にある各点のブロックIDと点IDが含まれず、1の場合は、戻されるジオメトリ内にある各点のブロックIDと点IDが含まれます。get_idsが1の場合、戻されるジオメトリ内の各点に空間次元と2つの追加次元が含まれます。例としては、(x, y, z, blk_id, pt_id)のようになります。

使用上の注意

このファンクションは、ptsパラメータのすべての点ジオメトリおよびtrsパラメータのすべての三角形ジオメトリを表す、単一のSDO_GEOMETRY集合オブジェクトを戻します。たとえば、点および三角形にクリップ操作の結果またはブロック全体の内容を反映することもできます。

TINを使用して表面をモデル化する方法は、「表面のモデル化」を参照してください。

例

次の例では、TINを表す複数点の集合ジオメトリ・オブジェクトを戻します。これは、Oracle Database Examplesメディアからすでにファイルをインストールしている場合は、$ORACLE_HOME/md/demo/TIN/examples/plsql/tin.sqlから取得できます(『Oracle Database Examplesインストレーション・ガイド』を参照)。

. . .
-- Return points in blk_id of the TIN as a multipoint collection. 
select sdo_tin_pkg.to_geometry(
                    a.points,   -- point LOB
                    a.triangles,   -- point LOB
                    a.num_points, -- # of points in the LOB
                    a.num_triangles, -- # of points in the LOB
                    2,  -- index dimensionality (gtype dim in extent in INIT)
                    3,  -- total dimensionality
                    null -- SRID
                    ) from blktab a where blk_id=0;
. . .