OGR: ogr_api.h Source File

00001 /******************************************************************************
00002  * $Id: ogr_api.h 18226 2009-12-09 09:30:48Z chaitanya $
00003  *
00004  * Project:  OpenGIS Simple Features Reference Implementation
00005  * Purpose:  C API for OGR Geometry, Feature, Layers, DataSource and drivers.
00006  * Author:   Frank Warmerdam, warmerdam@pobox.com
00007  *
00008  ******************************************************************************
00009  * Copyright (c) 2002, Frank Warmerdam
00010  *
00011  * Permission is hereby granted, free of charge, to any person obtaining a
00012  * copy of this software and associated documentation files (the "Software"),
00013  * to deal in the Software without restriction, including without limitation
00014  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
00015  * and/or sell copies of the Software, and to permit persons to whom the
00016  * Software is furnished to do so, subject to the following conditions:
00017  *
00018  * The above copyright notice and this permission notice shall be included
00019  * in all copies or substantial portions of the Software.
00020  *
00021  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
00022  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
00023  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
00024  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
00025  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
00026  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
00027  * DEALINGS IN THE SOFTWARE.
00028  ****************************************************************************/
00029 
00030 #ifndef OGR_API_H_INCLUDED
00031 #define OGR_API_H_INCLUDED
00032 
00042 #include "ogr_core.h"
00043 
00044 CPL_C_START
00045 
00046 /* -------------------------------------------------------------------- */
00047 /*      Geometry related functions (ogr_geometry.h)                     */
00048 /* -------------------------------------------------------------------- */
00049 #ifdef DEBUG
00050 typedef struct OGRGeometryHS *OGRGeometryH;
00051 #else
00052 typedef void *OGRGeometryH;
00053 #endif
00054 
00055 #ifndef _DEFINED_OGRSpatialReferenceH
00056 #define _DEFINED_OGRSpatialReferenceH
00057 
00058 #ifdef DEBUG
00059 typedef struct OGRSpatialReferenceHS *OGRSpatialReferenceH;
00060 typedef struct OGRCoordinateTransformationHS *OGRCoordinateTransformationH;
00061 #else
00062 typedef void *OGRSpatialReferenceH;                               
00063 typedef void *OGRCoordinateTransformationH;
00064 #endif
00065 
00066 #endif
00067 
00068 struct _CPLXMLNode;
00069 
00070 /* From base OGRGeometry class */
00071 
00072 OGRErr CPL_DLL OGR_G_CreateFromWkb( unsigned char *, OGRSpatialReferenceH, 
00073                                     OGRGeometryH *, int );
00074 OGRErr CPL_DLL OGR_G_CreateFromWkt( char **, OGRSpatialReferenceH, 
00075                                     OGRGeometryH * );
00076 OGRErr CPL_DLL OGR_G_CreateFromFgf( unsigned char *, OGRSpatialReferenceH, 
00077                                     OGRGeometryH *, int, int * );
00078 void   CPL_DLL OGR_G_DestroyGeometry( OGRGeometryH );
00079 OGRGeometryH CPL_DLL OGR_G_CreateGeometry( OGRwkbGeometryType );
00080 OGRGeometryH CPL_DLL 
00081 OGR_G_ApproximateArcAngles( 
00082     double dfCenterX, double dfCenterY, double dfZ,
00083     double dfPrimaryRadius, double dfSecondaryAxis, double dfRotation, 
00084     double dfStartAngle, double dfEndAngle,
00085     double dfMaxAngleStepSizeDegrees );
00086 
00087 int    CPL_DLL OGR_G_GetDimension( OGRGeometryH );
00088 int    CPL_DLL OGR_G_GetCoordinateDimension( OGRGeometryH );
00089 void   CPL_DLL OGR_G_SetCoordinateDimension( OGRGeometryH, int );
00090 OGRGeometryH CPL_DLL OGR_G_Clone( OGRGeometryH );
00091 void   CPL_DLL OGR_G_GetEnvelope( OGRGeometryH, OGREnvelope * );
00092 OGRErr CPL_DLL OGR_G_ImportFromWkb( OGRGeometryH, unsigned char *, int );
00093 OGRErr CPL_DLL OGR_G_ExportToWkb( OGRGeometryH, OGRwkbByteOrder, unsigned char*);
00094 int    CPL_DLL OGR_G_WkbSize( OGRGeometryH hGeom );
00095 OGRErr CPL_DLL OGR_G_ImportFromWkt( OGRGeometryH, char ** );
00096 OGRErr CPL_DLL OGR_G_ExportToWkt( OGRGeometryH, char ** );
00097 OGRwkbGeometryType CPL_DLL OGR_G_GetGeometryType( OGRGeometryH );
00098 const char CPL_DLL *OGR_G_GetGeometryName( OGRGeometryH );
00099 void   CPL_DLL OGR_G_DumpReadable( OGRGeometryH, FILE *, const char * );
00100 void   CPL_DLL OGR_G_FlattenTo2D( OGRGeometryH );
00101 void   CPL_DLL OGR_G_CloseRings( OGRGeometryH );
00102 
00103 OGRGeometryH CPL_DLL OGR_G_CreateFromGML( const char * );
00104 char   CPL_DLL *OGR_G_ExportToGML( OGRGeometryH );
00105 
00106 #if defined(_CPL_MINIXML_H_INCLUDED)
00107 OGRGeometryH CPL_DLL OGR_G_CreateFromGMLTree( const CPLXMLNode * );
00108 CPLXMLNode CPL_DLL *OGR_G_ExportToGMLTree( OGRGeometryH );
00109 CPLXMLNode CPL_DLL *OGR_G_ExportEnvelopeToGMLTree( OGRGeometryH );
00110 #endif
00111 
00112 char   CPL_DLL *OGR_G_ExportToKML( OGRGeometryH, const char* pszAltitudeMode );
00113 
00114 char   CPL_DLL *OGR_G_ExportToJson( OGRGeometryH );
00115 OGRGeometryH CPL_DLL OGR_G_CreateGeometryFromJson( const char* );
00116 
00117 void   CPL_DLL OGR_G_AssignSpatialReference( OGRGeometryH, 
00118                                              OGRSpatialReferenceH );
00119 OGRSpatialReferenceH CPL_DLL OGR_G_GetSpatialReference( OGRGeometryH );
00120 OGRErr CPL_DLL OGR_G_Transform( OGRGeometryH, OGRCoordinateTransformationH );
00121 OGRErr CPL_DLL OGR_G_TransformTo( OGRGeometryH, OGRSpatialReferenceH );
00122 void   CPL_DLL OGR_G_Segmentize(OGRGeometryH hGeom, double dfMaxLength );
00123 int    CPL_DLL OGR_G_Intersects( OGRGeometryH, OGRGeometryH );
00124 int    CPL_DLL OGR_G_Equals( OGRGeometryH, OGRGeometryH );
00125 int    CPL_DLL OGR_G_Disjoint( OGRGeometryH, OGRGeometryH );
00126 int    CPL_DLL OGR_G_Touches( OGRGeometryH, OGRGeometryH );
00127 int    CPL_DLL OGR_G_Crosses( OGRGeometryH, OGRGeometryH );
00128 int    CPL_DLL OGR_G_Within( OGRGeometryH, OGRGeometryH );
00129 int    CPL_DLL OGR_G_Contains( OGRGeometryH, OGRGeometryH );
00130 int    CPL_DLL OGR_G_Overlaps( OGRGeometryH, OGRGeometryH );
00131 
00132 OGRGeometryH CPL_DLL OGR_G_GetBoundary( OGRGeometryH );
00133 OGRGeometryH CPL_DLL OGR_G_ConvexHull( OGRGeometryH );
00134 OGRGeometryH CPL_DLL OGR_G_Buffer( OGRGeometryH, double, int );
00135 OGRGeometryH CPL_DLL OGR_G_Intersection( OGRGeometryH, OGRGeometryH );
00136 OGRGeometryH CPL_DLL OGR_G_Union( OGRGeometryH, OGRGeometryH );
00137 OGRGeometryH CPL_DLL OGR_G_Difference( OGRGeometryH, OGRGeometryH );
00138 OGRGeometryH CPL_DLL OGR_G_SymmetricDifference( OGRGeometryH, OGRGeometryH );
00139 double CPL_DLL OGR_G_Distance( OGRGeometryH, OGRGeometryH );
00140 
00141 double CPL_DLL OGR_G_GetArea( OGRGeometryH );
00142 int    CPL_DLL OGR_G_Centroid( OGRGeometryH, OGRGeometryH );
00143 
00144 void   CPL_DLL OGR_G_Empty( OGRGeometryH );
00145 int    CPL_DLL OGR_G_IsEmpty (OGRGeometryH );
00146 int    CPL_DLL OGR_G_IsValid (OGRGeometryH );
00147 int    CPL_DLL OGR_G_IsSimple (OGRGeometryH );
00148 int    CPL_DLL OGR_G_IsRing (OGRGeometryH );
00149 
00150 /* backward compatibility */
00151 int    CPL_DLL OGR_G_Intersect( OGRGeometryH, OGRGeometryH );
00152 int    CPL_DLL OGR_G_Equal( OGRGeometryH, OGRGeometryH );
00153 
00154 /* Methods for getting/setting vertices in points, line strings and rings */
00155 int    CPL_DLL OGR_G_GetPointCount( OGRGeometryH );
00156 double CPL_DLL OGR_G_GetX( OGRGeometryH, int );
00157 double CPL_DLL OGR_G_GetY( OGRGeometryH, int );
00158 double CPL_DLL OGR_G_GetZ( OGRGeometryH, int );
00159 void   CPL_DLL OGR_G_GetPoint( OGRGeometryH, int iPoint, 
00160                                double *, double *, double * );
00161 void   CPL_DLL OGR_G_SetPoint( OGRGeometryH, int iPoint, 
00162                                double, double, double );
00163 void   CPL_DLL OGR_G_SetPoint_2D( OGRGeometryH, int iPoint, 
00164                                   double, double );
00165 void   CPL_DLL OGR_G_AddPoint( OGRGeometryH, double, double, double );
00166 void   CPL_DLL OGR_G_AddPoint_2D( OGRGeometryH, double, double );
00167 
00168 /* Methods for getting/setting rings and members collections */
00169 
00170 int    CPL_DLL OGR_G_GetGeometryCount( OGRGeometryH );
00171 OGRGeometryH CPL_DLL OGR_G_GetGeometryRef( OGRGeometryH, int );
00172 OGRErr CPL_DLL OGR_G_AddGeometry( OGRGeometryH, OGRGeometryH );
00173 OGRErr CPL_DLL OGR_G_AddGeometryDirectly( OGRGeometryH, OGRGeometryH );
00174 OGRErr CPL_DLL OGR_G_RemoveGeometry( OGRGeometryH, int, int );
00175 
00176 OGRGeometryH CPL_DLL OGRBuildPolygonFromEdges( OGRGeometryH hLinesAsCollection,
00177                                        int bBestEffort, 
00178                                        int bAutoClose, 
00179                                        double dfTolerance,
00180                                        OGRErr * peErr );
00181 
00182 OGRErr CPL_DLL OGRSetGenerate_DB2_V72_BYTE_ORDER( 
00183     int bGenerate_DB2_V72_BYTE_ORDER );
00184 
00185 int CPL_DLL OGRGetGenerate_DB2_V72_BYTE_ORDER(void);
00186 
00187 /* -------------------------------------------------------------------- */
00188 /*      Feature related (ogr_feature.h)                                 */
00189 /* -------------------------------------------------------------------- */
00190 
00191 #ifdef DEBUG
00192 typedef struct OGRFieldDefnHS   *OGRFieldDefnH;
00193 typedef struct OGRFeatureDefnHS *OGRFeatureDefnH;
00194 typedef struct OGRFeatureHS     *OGRFeatureH;
00195 typedef struct OGRStyleTableHS *OGRStyleTableH;
00196 #else
00197 typedef void *OGRFieldDefnH;
00198 typedef void *OGRFeatureDefnH;
00199 typedef void *OGRFeatureH;
00200 typedef void *OGRStyleTableH;
00201 #endif
00202 
00203 /* OGRFieldDefn */
00204 
00205 OGRFieldDefnH CPL_DLL OGR_Fld_Create( const char *, OGRFieldType );
00206 void   CPL_DLL OGR_Fld_Destroy( OGRFieldDefnH );
00207 
00208 void   CPL_DLL OGR_Fld_SetName( OGRFieldDefnH, const char * );
00209 const char CPL_DLL *OGR_Fld_GetNameRef( OGRFieldDefnH );
00210 OGRFieldType CPL_DLL OGR_Fld_GetType( OGRFieldDefnH );
00211 void   CPL_DLL OGR_Fld_SetType( OGRFieldDefnH, OGRFieldType );
00212 OGRJustification CPL_DLL OGR_Fld_GetJustify( OGRFieldDefnH );
00213 void   CPL_DLL OGR_Fld_SetJustify( OGRFieldDefnH, OGRJustification );
00214 int    CPL_DLL OGR_Fld_GetWidth( OGRFieldDefnH );
00215 void   CPL_DLL OGR_Fld_SetWidth( OGRFieldDefnH, int );
00216 int    CPL_DLL OGR_Fld_GetPrecision( OGRFieldDefnH );
00217 void   CPL_DLL OGR_Fld_SetPrecision( OGRFieldDefnH, int );
00218 void   CPL_DLL OGR_Fld_Set( OGRFieldDefnH, const char *, OGRFieldType, 
00219                             int, int, OGRJustification );
00220 
00221 const char CPL_DLL *OGR_GetFieldTypeName( OGRFieldType );
00222 
00223 /* OGRFeatureDefn */
00224 
00225 OGRFeatureDefnH CPL_DLL OGR_FD_Create( const char * );
00226 void   CPL_DLL OGR_FD_Destroy( OGRFeatureDefnH );
00227 void   CPL_DLL OGR_FD_Release( OGRFeatureDefnH );
00228 const char CPL_DLL *OGR_FD_GetName( OGRFeatureDefnH );
00229 int    CPL_DLL OGR_FD_GetFieldCount( OGRFeatureDefnH );
00230 OGRFieldDefnH CPL_DLL OGR_FD_GetFieldDefn( OGRFeatureDefnH, int );
00231 int    CPL_DLL OGR_FD_GetFieldIndex( OGRFeatureDefnH, const char * );
00232 void   CPL_DLL OGR_FD_AddFieldDefn( OGRFeatureDefnH, OGRFieldDefnH );
00233 OGRwkbGeometryType CPL_DLL OGR_FD_GetGeomType( OGRFeatureDefnH );
00234 void   CPL_DLL OGR_FD_SetGeomType( OGRFeatureDefnH, OGRwkbGeometryType );
00235 int    CPL_DLL OGR_FD_Reference( OGRFeatureDefnH );
00236 int    CPL_DLL OGR_FD_Dereference( OGRFeatureDefnH );
00237 int    CPL_DLL OGR_FD_GetReferenceCount( OGRFeatureDefnH );
00238 
00239 /* OGRFeature */
00240 
00241 OGRFeatureH CPL_DLL OGR_F_Create( OGRFeatureDefnH );
00242 void   CPL_DLL OGR_F_Destroy( OGRFeatureH );
00243 OGRFeatureDefnH CPL_DLL OGR_F_GetDefnRef( OGRFeatureH );
00244 
00245 OGRErr CPL_DLL OGR_F_SetGeometryDirectly( OGRFeatureH, OGRGeometryH );
00246 OGRErr CPL_DLL OGR_F_SetGeometry( OGRFeatureH, OGRGeometryH );
00247 OGRGeometryH CPL_DLL OGR_F_GetGeometryRef( OGRFeatureH );
00248 OGRFeatureH CPL_DLL OGR_F_Clone( OGRFeatureH );
00249 int    CPL_DLL OGR_F_Equal( OGRFeatureH, OGRFeatureH );
00250 
00251 int    CPL_DLL OGR_F_GetFieldCount( OGRFeatureH );
00252 OGRFieldDefnH CPL_DLL OGR_F_GetFieldDefnRef( OGRFeatureH, int );
00253 int    CPL_DLL OGR_F_GetFieldIndex( OGRFeatureH, const char * );
00254 
00255 int    CPL_DLL OGR_F_IsFieldSet( OGRFeatureH, int );
00256 void   CPL_DLL OGR_F_UnsetField( OGRFeatureH, int );
00257 OGRField CPL_DLL *OGR_F_GetRawFieldRef( OGRFeatureH, int );
00258 
00259 int    CPL_DLL OGR_F_GetFieldAsInteger( OGRFeatureH, int );
00260 double CPL_DLL OGR_F_GetFieldAsDouble( OGRFeatureH, int );
00261 const char CPL_DLL *OGR_F_GetFieldAsString( OGRFeatureH, int );
00262 const int CPL_DLL *OGR_F_GetFieldAsIntegerList( OGRFeatureH, int, int * );
00263 const double CPL_DLL *OGR_F_GetFieldAsDoubleList( OGRFeatureH, int, int * );
00264 char  CPL_DLL **OGR_F_GetFieldAsStringList( OGRFeatureH, int );
00265 GByte CPL_DLL *OGR_F_GetFieldAsBinary( OGRFeatureH, int, int * );
00266 int   CPL_DLL  OGR_F_GetFieldAsDateTime( OGRFeatureH, int, int *, int *, int *,
00267                                          int *, int *, int *, int * );
00268 
00269 void   CPL_DLL OGR_F_SetFieldInteger( OGRFeatureH, int, int );
00270 void   CPL_DLL OGR_F_SetFieldDouble( OGRFeatureH, int, double );
00271 void   CPL_DLL OGR_F_SetFieldString( OGRFeatureH, int, const char * );
00272 void   CPL_DLL OGR_F_SetFieldIntegerList( OGRFeatureH, int, int, int * );
00273 void   CPL_DLL OGR_F_SetFieldDoubleList( OGRFeatureH, int, int, double * );
00274 void   CPL_DLL OGR_F_SetFieldStringList( OGRFeatureH, int, char ** );
00275 void   CPL_DLL OGR_F_SetFieldRaw( OGRFeatureH, int, OGRField * );
00276 void   CPL_DLL OGR_F_SetFieldBinary( OGRFeatureH, int, int, GByte * );
00277 void   CPL_DLL OGR_F_SetFieldDateTime( OGRFeatureH, int, 
00278                                        int, int, int, int, int, int, int );
00279 
00280 long   CPL_DLL OGR_F_GetFID( OGRFeatureH );
00281 OGRErr CPL_DLL OGR_F_SetFID( OGRFeatureH, long );
00282 void   CPL_DLL OGR_F_DumpReadable( OGRFeatureH, FILE * );
00283 OGRErr CPL_DLL OGR_F_SetFrom( OGRFeatureH, OGRFeatureH, int );
00284 OGRErr CPL_DLL OGR_F_SetFromWithMap( OGRFeatureH, OGRFeatureH, int , int * );
00285 
00286 const char CPL_DLL *OGR_F_GetStyleString( OGRFeatureH );
00287 void   CPL_DLL OGR_F_SetStyleString( OGRFeatureH, const char * );
00288 void   CPL_DLL OGR_F_SetStyleStringDirectly( OGRFeatureH, char * );
00289 OGRStyleTableH CPL_DLL OGR_F_GetStyleTable( OGRFeatureH );
00290 void   CPL_DLL OGR_F_SetStyleTableDirectly( OGRFeatureH, OGRStyleTableH );
00291 void   CPL_DLL OGR_F_SetStyleTable( OGRFeatureH, OGRStyleTableH );
00292 
00293 /* -------------------------------------------------------------------- */
00294 /*      ogrsf_frmts.h                                                   */
00295 /* -------------------------------------------------------------------- */
00296 
00297 #ifdef DEBUG
00298 typedef struct OGRLayerHS      *OGRLayerH;
00299 typedef struct OGRDataSourceHS *OGRDataSourceH;
00300 typedef struct OGRDriverHS     *OGRSFDriverH;
00301 #else
00302 typedef void *OGRLayerH;
00303 typedef void *OGRDataSourceH;
00304 typedef void *OGRSFDriverH;
00305 #endif
00306 
00307 /* OGRLayer */
00308 
00309 OGRGeometryH CPL_DLL OGR_L_GetSpatialFilter( OGRLayerH );
00310 void   CPL_DLL OGR_L_SetSpatialFilter( OGRLayerH, OGRGeometryH );
00311 void   CPL_DLL OGR_L_SetSpatialFilterRect( OGRLayerH, 
00312                                            double, double, double, double );
00313 OGRErr CPL_DLL OGR_L_SetAttributeFilter( OGRLayerH, const char * );
00314 void   CPL_DLL OGR_L_ResetReading( OGRLayerH );
00315 OGRFeatureH CPL_DLL OGR_L_GetNextFeature( OGRLayerH );
00316 OGRErr CPL_DLL OGR_L_SetNextByIndex( OGRLayerH, long );
00317 OGRFeatureH CPL_DLL OGR_L_GetFeature( OGRLayerH, long );
00318 OGRErr CPL_DLL OGR_L_SetFeature( OGRLayerH, OGRFeatureH );
00319 OGRErr CPL_DLL OGR_L_CreateFeature( OGRLayerH, OGRFeatureH );
00320 OGRErr CPL_DLL OGR_L_DeleteFeature( OGRLayerH, long );
00321 OGRFeatureDefnH CPL_DLL OGR_L_GetLayerDefn( OGRLayerH );
00322 OGRSpatialReferenceH CPL_DLL OGR_L_GetSpatialRef( OGRLayerH );
00323 int    CPL_DLL OGR_L_GetFeatureCount( OGRLayerH, int );
00324 OGRErr CPL_DLL OGR_L_GetExtent( OGRLayerH, OGREnvelope *, int );
00325 int    CPL_DLL OGR_L_TestCapability( OGRLayerH, const char * );
00326 OGRErr CPL_DLL OGR_L_CreateField( OGRLayerH, OGRFieldDefnH, int );
00327 OGRErr CPL_DLL OGR_L_StartTransaction( OGRLayerH );
00328 OGRErr CPL_DLL OGR_L_CommitTransaction( OGRLayerH );
00329 OGRErr CPL_DLL OGR_L_RollbackTransaction( OGRLayerH );
00330 int    CPL_DLL OGR_L_Reference( OGRLayerH );
00331 int    CPL_DLL OGR_L_Dereference( OGRLayerH );
00332 int    CPL_DLL OGR_L_GetRefCount( OGRLayerH );
00333 OGRErr CPL_DLL OGR_L_SyncToDisk( OGRLayerH );
00334 GIntBig CPL_DLL OGR_L_GetFeaturesRead( OGRLayerH );
00335 const char CPL_DLL *OGR_L_GetFIDColumn( OGRLayerH );
00336 const char CPL_DLL *OGR_L_GetGeometryColumn( OGRLayerH );
00337 OGRStyleTableH CPL_DLL OGR_L_GetStyleTable( OGRLayerH );
00338 void   CPL_DLL OGR_L_SetStyleTableDirectly( OGRLayerH, OGRStyleTableH );
00339 void   CPL_DLL OGR_L_SetStyleTable( OGRLayerH, OGRStyleTableH );
00340 
00341 /* OGRDataSource */
00342 
00343 void   CPL_DLL OGR_DS_Destroy( OGRDataSourceH );
00344 const char CPL_DLL *OGR_DS_GetName( OGRDataSourceH );
00345 int    CPL_DLL OGR_DS_GetLayerCount( OGRDataSourceH );
00346 OGRLayerH CPL_DLL OGR_DS_GetLayer( OGRDataSourceH, int );
00347 OGRLayerH CPL_DLL OGR_DS_GetLayerByName( OGRDataSourceH, const char * );
00348 OGRErr    CPL_DLL OGR_DS_DeleteLayer( OGRDataSourceH, int );
00349 OGRSFDriverH CPL_DLL OGR_DS_GetDriver( OGRDataSourceH );
00350 OGRLayerH CPL_DLL OGR_DS_CreateLayer( OGRDataSourceH, const char *, 
00351                                       OGRSpatialReferenceH, OGRwkbGeometryType,
00352                                       char ** );
00353 OGRLayerH CPL_DLL OGR_DS_CopyLayer( OGRDataSourceH, OGRLayerH, const char *,
00354                                     char ** );
00355 int    CPL_DLL OGR_DS_TestCapability( OGRDataSourceH, const char * );
00356 OGRLayerH CPL_DLL OGR_DS_ExecuteSQL( OGRDataSourceH, const char *,
00357                                      OGRGeometryH, const char * );
00358 void   CPL_DLL OGR_DS_ReleaseResultSet( OGRDataSourceH, OGRLayerH );
00359 int    CPL_DLL OGR_DS_Reference( OGRDataSourceH );
00360 int    CPL_DLL OGR_DS_Dereference( OGRDataSourceH );
00361 int    CPL_DLL OGR_DS_GetRefCount( OGRDataSourceH );
00362 int    CPL_DLL OGR_DS_GetSummaryRefCount( OGRDataSourceH );
00363 OGRErr CPL_DLL OGR_DS_SyncToDisk( OGRDataSourceH );
00364 OGRStyleTableH CPL_DLL OGR_DS_GetStyleTable( OGRDataSourceH );
00365 void   CPL_DLL OGR_DS_SetStyleTableDirectly( OGRDataSourceH, OGRStyleTableH );
00366 void   CPL_DLL OGR_DS_SetStyleTable( OGRDataSourceH, OGRStyleTableH );
00367 
00368 /* OGRSFDriver */
00369 
00370 const char CPL_DLL *OGR_Dr_GetName( OGRSFDriverH );
00371 OGRDataSourceH CPL_DLL OGR_Dr_Open( OGRSFDriverH, const char *, int );
00372 int CPL_DLL OGR_Dr_TestCapability( OGRSFDriverH, const char * );
00373 OGRDataSourceH CPL_DLL OGR_Dr_CreateDataSource( OGRSFDriverH, const char *,
00374                                                 char ** );
00375 OGRDataSourceH CPL_DLL OGR_Dr_CopyDataSource( OGRSFDriverH,  OGRDataSourceH, 
00376                                               const char *, char ** );
00377 OGRErr CPL_DLL OGR_Dr_DeleteDataSource( OGRSFDriverH, const char * );
00378 
00379 /* OGRSFDriverRegistrar */
00380 
00381 OGRDataSourceH CPL_DLL OGROpen( const char *, int, OGRSFDriverH * );
00382 OGRDataSourceH CPL_DLL OGROpenShared( const char *, int, OGRSFDriverH * );
00383 OGRErr  CPL_DLL OGRReleaseDataSource( OGRDataSourceH );
00384 void    CPL_DLL OGRRegisterDriver( OGRSFDriverH );
00385 int     CPL_DLL OGRGetDriverCount(void);
00386 OGRSFDriverH CPL_DLL OGRGetDriver( int );
00387 OGRSFDriverH CPL_DLL OGRGetDriverByName( const char * );
00388 int     CPL_DLL OGRGetOpenDSCount(void);
00389 OGRDataSourceH CPL_DLL OGRGetOpenDS( int iDS );
00390 
00391 
00392 /* note: this is also declared in ogrsf_frmts.h */
00393 void CPL_DLL OGRRegisterAll(void);
00394 void CPL_DLL OGRCleanupAll(void);
00395 
00396 /* -------------------------------------------------------------------- */
00397 /*      ogrsf_featurestyle.h                                            */
00398 /* -------------------------------------------------------------------- */
00399 
00400 #ifdef DEBUG
00401 typedef struct OGRStyleMgrHS *OGRStyleMgrH;
00402 typedef struct OGRStyleToolHS *OGRStyleToolH;
00403 #else
00404 typedef void *OGRStyleMgrH;
00405 typedef void *OGRStyleToolH;
00406 #endif
00407 
00408 /* OGRStyleMgr */
00409 
00410 OGRStyleMgrH CPL_DLL OGR_SM_Create(OGRStyleTableH hStyleTable);
00411 void    CPL_DLL OGR_SM_Destroy(OGRStyleMgrH hSM);
00412 
00413 const char CPL_DLL *OGR_SM_InitFromFeature(OGRStyleMgrH hSM, 
00414                                            OGRFeatureH hFeat);
00415 int     CPL_DLL OGR_SM_InitStyleString(OGRStyleMgrH hSM, 
00416                                        const char *pszStyleString);
00417 int     CPL_DLL OGR_SM_GetPartCount(OGRStyleMgrH hSM, 
00418                                     const char *pszStyleString);
00419 OGRStyleToolH CPL_DLL OGR_SM_GetPart(OGRStyleMgrH hSM, int nPartId, 
00420                                      const char *pszStyleString);
00421 int     CPL_DLL OGR_SM_AddPart(OGRStyleMgrH hSM, OGRStyleToolH hST);
00422 int     CPL_DLL OGR_SM_AddStyle(OGRStyleMgrH hSM, const char *pszStyleName, 
00423                                const char *pszStyleString);
00424 
00425 /* OGRStyleTool */
00426 
00427 OGRStyleToolH CPL_DLL OGR_ST_Create(OGRSTClassId eClassId);
00428 void    CPL_DLL OGR_ST_Destroy(OGRStyleToolH hST);
00429 
00430 OGRSTClassId CPL_DLL OGR_ST_GetType(OGRStyleToolH hST);
00431 
00432 OGRSTUnitId CPL_DLL OGR_ST_GetUnit(OGRStyleToolH hST);
00433 void    CPL_DLL OGR_ST_SetUnit(OGRStyleToolH hST, OGRSTUnitId eUnit, 
00434                                double dfGroundPaperScale);
00435 
00436 const char CPL_DLL *OGR_ST_GetParamStr(OGRStyleToolH hST, int eParam, int *bValueIsNull);
00437 int     CPL_DLL OGR_ST_GetParamNum(OGRStyleToolH hST, int eParam, int *bValueIsNull);
00438 double  CPL_DLL OGR_ST_GetParamDbl(OGRStyleToolH hST, int eParam, int *bValueIsNull);
00439 void    CPL_DLL OGR_ST_SetParamStr(OGRStyleToolH hST, int eParam, const char *pszValue);
00440 void    CPL_DLL OGR_ST_SetParamNum(OGRStyleToolH hST, int eParam, int nValue);
00441 void    CPL_DLL OGR_ST_SetParamDbl(OGRStyleToolH hST, int eParam, double dfValue);
00442 const char CPL_DLL *OGR_ST_GetStyleString(OGRStyleToolH hST);
00443 
00444 int CPL_DLL OGR_ST_GetRGBFromString(OGRStyleToolH hST, const char *pszColor, 
00445                                     int *pnRed, int *pnGreen, int *pnBlue, 
00446                                     int *pnAlpha);
00447 
00448 /* OGRStyleTable */
00449 
00450 OGRStyleTableH  CPL_DLL OGR_STBL_Create( void );
00451 void    CPL_DLL OGR_STBL_Destroy( OGRStyleTableH hSTBL ); 
00452 int     CPL_DLL OGR_STBL_SaveStyleTable( OGRStyleTableH hStyleTable,
00453                                          const char *pszFilename );
00454 int     CPL_DLL OGR_STBL_LoadStyleTable( OGRStyleTableH hStyleTable,
00455                                          const char *pszFilename );
00456 const char CPL_DLL *OGR_STBL_Find( OGRStyleTableH hStyleTable, const char *pszName );
00457 void    CPL_DLL OGR_STBL_ResetStyleStringReading( OGRStyleTableH hStyleTable );
00458 const char CPL_DLL *OGR_STBL_GetNextStyle( OGRStyleTableH hStyleTable);
00459 const char CPL_DLL *OGR_STBL_GetLastStyleName( OGRStyleTableH hStyleTable);
00460 
00461 CPL_C_END
00462 
00463 #endif /* ndef OGR_API_H_INCLUDED */