Changes between Version 9 and Version 10 of FDORfc63


Ignore:
Timestamp:
06/13/12 08:19:55 (12 years ago)
Author:
danstoica
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • FDORfc63

    v9 v10  
    88 
    99||RFC Template Version||(1.0)||
    10 ||Submission Date|| June 04, 2012 ||
    11 ||Last Modified|| Dan Stoica May 18, 2012 ||
     10||Submission Date|| June 13, 2012 ||
     11||Last Modified|| Dan Stoica June 13, 2012 ||
    1212||Author||Dan Stoica||
    1313||RFC Status||For review||
     
    9191    ///
    9292    /// \remarks
    93     /// Applies only for Mode #1. The Featid is not encoded.
    94     ///
    95     /// \param featId
    96     /// Input The feature identifier
     93    /// Applies only for Mode #1. The objectId is not encoded.
     94    ///
     95    /// \param objectId
     96    /// Input The object identifier
    9797    /// \param ext
    9898    /// Input A bounding box
     
    101101    /// Returns Nothing
    102102    ///
    103     FDO_SPATIAL_API void InsertObject(FdoInt64 featId, FdoIEnvelope *ext);
     103    FDO_SPATIAL_API void InsertObject(FdoInt64 objectId, FdoIEnvelope *ext);
    104104
    105105    /// \brief
     
    107107    ///
    108108    /// \remarks
    109     /// Applies for Mode #2 and #3. The FeatId is encoded as follows:
     109    /// Applies for Mode #2 and #3. The objectId is encoded as follows:
    110110    /// Mode #2:
    111     ///      32 bits (0-31)  - 1-based featId #
     111    ///      32 bits (0-31)  - 1-based object identifier
    112112    ///      32 bits (32-63) - 1-based segment # (contiguous)
    113113    ///
    114114    /// Mode #3:
    115     ///      0 bits          - featId # (will be ignored)
     115    ///      0 bits          - object identifier (will be ignored)
    116116    ///      16 bits (0-15)  - part # (for multi-features) max. 65534
    117117    ///      16 bits (16-31) - subpart # (e.g. polygons with interior rings) max 65534
     
    121121    /// Mode #2 can be used instead.
    122122    ///
    123     /// \param featId
    124     /// Input The feature identifier
     123    /// \param objectId
     124    /// Input The object identifier
    125125    /// \param fgfArray
    126126    /// Input A geometry in FGF format
     
    129129    /// Returns Nothing
    130130    ///
    131     FDO_SPATIAL_API void InsertObject(FdoInt32 featId, FdoByteArray* fgfArray);
     131    FDO_SPATIAL_API void InsertObject(FdoInt32 objectId, FdoByteArray* fgfArray);
    132132
    133133    /// \brief
     
    138138    /// In Mode #3 the spatial index will be emptied.
    139139    ///
    140     /// \param featId
    141     /// Input The feature identifier.
     140    /// \param objectId
     141    /// Input The object identifier.
    142142    /// \param ext
    143143    /// Input The bounding box of the feature. It may be NULL in which case
     
    147147    /// Returns Nothing
    148148    ///
    149     FDO_SPATIAL_API void EraseObject(FdoInt64 featId, FdoIEnvelope *ext);
     149    FDO_SPATIAL_API void EraseObject(FdoInt64 objectId, FdoIEnvelope *ext);
    150150
    151151    /// \brief
     
    163163    /// \param marker
    164164    /// Input A marker returned by the Spatial index iterator
    165     /// \param featId
    166     /// Output The featId
     165    /// \param objectId
     166    /// Output The object identifier
    167167    /// \param iVertex
    168168    /// Output The index of the segment in the original geometry, 1-based
     
    171171    /// Returns Nothing
    172172    ///
    173     FDO_SPATIAL_API void     DecodeMarker(FdoInt64 marker, FdoInt32 &featId, FdoInt32 &iSegment);
     173    FDO_SPATIAL_API void     DecodeMarker(FdoInt64 marker, FdoInt32 &objectId, FdoInt32 &iSegment);
    174174
    175175    /// \brief
     
    241241== Remarks ==
    242242
    243 * The API proposes 3 usage modes. This provides maximum flexibility for various scenarios.
    244 * Mode 1 implements a regular spatial index, very performant
     243* The API proposes 3 usage modes. This provides maximum versatility for various scenarios.
     244* Mode 1 implements a regular spatial index, very performant.
    245245* For mode 2 and 3 the client code has to implement a segment visitor in order to retrieve a segment from the geometry.
    246246* This API is a wrapper over the R-tree implementation located in the Sqlite provider and developed by Traian Stanev.