ogr__api_8h.html

gdal库的学习文档

</div><p>
<a class="anchor" name="fd11ea603491207a89c75b6b9480e091"></a><!-- doxytag: member="ogr_api.h::OGR_Dr_GetName" ref="fd11ea603491207a89c75b6b9480e091" args="(OGRSFDriverH)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char * OGR_Dr_GetName           </td>
          <td>(</td>
          <td class="paramtype">OGRSFDriverH&nbsp;</td>
          <td class="paramname"> <em>hDriver</em>          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Fetch name of driver (file format). This name should be relatively short (10-40 characters), and should reflect the underlying file format. For instance "ESRI Shapefile".<p>
This function is the same as the C++ method <a class="el" href="classOGRSFDriver.html#0e7f90e5c390bccc9e708b75235a2735">OGRSFDriver::GetName()</a>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>hDriver</em>&nbsp;</td><td>handle to the the driver to get the name from. </td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>driver name. This is an internal string and should not be modified or freed. </dd></dl>

</div>
</div><p>
<a class="anchor" name="bd35488a77aae79835b8b753095cebc7"></a><!-- doxytag: member="ogr_api.h::OGR_Dr_Open" ref="bd35488a77aae79835b8b753095cebc7" args="(OGRSFDriverH, const char *, int)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OGRDataSourceH OGR_Dr_Open           </td>
          <td>(</td>
          <td class="paramtype">OGRSFDriverH&nbsp;</td>
          <td class="paramname"> <em>hDriver</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>pszName</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>bUpdate</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Attempt to open file with this driver.<p>
This function is the same as the C++ method <a class="el" href="classOGRSFDriver.html#ee265c3b0a3d4fa3572020d255bb4564">OGRSFDriver::Open()</a>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>hDriver</em>&nbsp;</td><td>handle to the driver that is used to open file. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pszName</em>&nbsp;</td><td>the name of the file, or data source to try and open. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>bUpdate</em>&nbsp;</td><td>TRUE if update access is required, otherwise FALSE (the default).</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>NULL on error or if the pass name is not supported by this driver, otherwise an handle to an <a class="el" href="classOGRDataSource.html">OGRDataSource</a>. This <a class="el" href="classOGRDataSource.html">OGRDataSource</a> should be closed by deleting the object when it is no longer needed. </dd></dl>

</div>
</div><p>
<a class="anchor" name="9010219bbc2e32627064ed860048d979"></a><!-- doxytag: member="ogr_api.h::OGR_Dr_TestCapability" ref="9010219bbc2e32627064ed860048d979" args="(OGRSFDriverH, const char *)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int OGR_Dr_TestCapability           </td>
          <td>(</td>
          <td class="paramtype">OGRSFDriverH&nbsp;</td>
          <td class="paramname"> <em>hDriver</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>pszCap</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Test if capability is available.<p>
One of the following data source capability names can be passed into this function, and a TRUE or FALSE value will be returned indicating whether or not the capability is available for this object.<p>
<ul>
<li>
<b>ODrCCreateDataSource</b>: True if this driver can support creating data sources.<p>
</li>
<li>
<b>ODrCDeleteDataSource</b>: True if this driver supports deleting data sources.<p>
</li>
</ul>
<p>
The define macro forms of the capability names should be used in preference to the strings themselves to avoid mispelling.<p>
This function is the same as the C++ method <a class="el" href="classOGRSFDriver.html#6c37cb7552902cd27cd6d4b904d7c744">OGRSFDriver::TestCapability()</a>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>hDriver</em>&nbsp;</td><td>handle to the driver to test the capability against. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pszCap</em>&nbsp;</td><td>the capability to test.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>TRUE if capability available otherwise FALSE. </dd></dl>

</div>
</div><p>
<a class="anchor" name="424d383a37fbeaea58acaea11717f320"></a><!-- doxytag: member="ogr_api.h::OGR_DS_CreateLayer" ref="424d383a37fbeaea58acaea11717f320" args="(OGRDataSourceH, const char *, OGRSpatialReferenceH, OGRwkbGeometryType, char **)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">OGRLayerH OGR_DS_CreateLayer           </td>
          <td>(</td>
          <td class="paramtype">OGRDataSourceH&nbsp;</td>
          <td class="paramname"> <em>hDS</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>pszName</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">OGRSpatialReferenceH&nbsp;</td>
          <td class="paramname"> <em>hSpatialRef</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">OGRwkbGeometryType&nbsp;</td>
          <td class="paramname"> <em>eType</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">char **&nbsp;</td>
          <td class="paramname"> <em>papszOptions</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
This function attempts to create a new layer on the data source with the indicated name, coordinate system, geometry type. The papszOptions argument can be used to control driver specific creation options. These options are normally documented in the format specific documentation.<p>
This function is the same as the C++ method <a class="el" href="classOGRDataSource.html#39cfc6e0ee790506d7638b0dce03c7da">OGRDataSource::CreateLayer()</a>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>hDS</em>&nbsp;</td><td>The dataset handle. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pszName</em>&nbsp;</td><td>the name for the new layer. This should ideally not match any existing layer on the datasource. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>hSpatialRef</em>&nbsp;</td><td>handle to the coordinate system to use for the new layer, or NULL if no coordinate system is available. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>eType</em>&nbsp;</td><td>the geometry type for the layer. Use wkbUnknown if there are no constraints on the types geometry to be written. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>papszOptions</em>&nbsp;</td><td>a StringList of name=value options. Options are driver specific, and driver information can be found at the following url: <a href="http://gdal.velocet.ca/projects/opengis/ogrhtml/ogr_formats.html">http://gdal.velocet.ca/projects/opengis/ogrhtml/ogr_formats.html</a></td></tr>