classgdaldataset.html

gdal库的学习文档

Add a band to a dataset.<p>
This method will add a new band to the dataset if the underlying format supports this action. Most formats do not.<p>
Note that the new <a class="el" href="classGDALRasterBand.html">GDALRasterBand</a> is not returned. It may be fetched after successful completion of the method by calling <a class="el" href="classGDALDataset.html#d96adcf07f2979ad176e37a7f8638fb6">GDALDataset::GetRasterBand</a>(<a class="el" href="classGDALDataset.html#01ed7cc3d711651470212dac01af69a0">GDALDataset::GetRasterCount()</a>-1) as the newest band will always be the last band.<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>eType</em>&nbsp;</td><td>the data type of the pixels in the new band.</td></tr>
    <tr><td valign="top"></td><td valign="top"><em>papszOptions</em>&nbsp;</td><td>a list of NAME=VALUE option strings. The supported options are format specific. NULL may be passed by default.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>CE_None on success or CE_Failure on failure. </dd></dl>

</div>
</div><p>
<a class="anchor" name="39396324384dc195866a374775fa74ef"></a><!-- doxytag: member="GDALDataset::GetInternalHandle" ref="39396324384dc195866a374775fa74ef" args="(const char *)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void * GDALDataset::GetInternalHandle           </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Fetch a format specific internally meaningful handle.<p>
This method is the same as the C <a class="el" href="gdal_8h.html#d2a5c715e49ab94c9842ef62d3fc061f">GDALGetInternalHandle()</a> method.<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>pszHandleName</em>&nbsp;</td><td>the handle name desired. The meaningful names will be specific to the file format.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the desired handle value, or NULL if not recognised/supported. </dd></dl>

</div>
</div><p>
<a class="anchor" name="86db47943e47ae71e97d6ba7a30213d0"></a><!-- doxytag: member="GDALDataset::GetDriver" ref="86db47943e47ae71e97d6ba7a30213d0" args="(void)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="classGDALDriver.html">GDALDriver</a> * GDALDataset::GetDriver           </td>
          <td>(</td>
          <td class="paramtype">void&nbsp;</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Fetch the driver to which this dataset relates.<p>
This method is the same as the C <a class="el" href="gdal_8h.html#115e56894fda0a51ad99820b1bc38391">GDALGetDatasetDriver()</a> function.<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the driver on which the dataset was created with <a class="el" href="classGDALDataset.html#6764788806a1785c97036d1dba064497">GDALOpen()</a> or <a class="el" href="gdal_8h.html#f68516793118967e1292519cbd66442c">GDALCreate()</a>. </dd></dl>

</div>
</div><p>
<a class="anchor" name="499a33ef83b64c38fa218c83a113bd09"></a><!-- doxytag: member="GDALDataset::GetGCPCount" ref="499a33ef83b64c38fa218c83a113bd09" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int GDALDataset::GetGCPCount           </td>
          <td>(</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Get number of GCPs.<p>
This method is the same as the C function <a class="el" href="gdal_8h.html#cb5f3db440085f54402d9ba842bf1fc3">GDALGetGCPCount()</a>.<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>number of GCPs for this dataset. Zero if there are none. </dd></dl>

</div>
</div><p>
<a class="anchor" name="35ea63c2f9ea12afd190ca2446d02ddb"></a><!-- doxytag: member="GDALDataset::GetGCPProjection" ref="35ea63c2f9ea12afd190ca2446d02ddb" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char * GDALDataset::GetGCPProjection           </td>
          <td>(</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Get output projection for GCPs.<p>
This method is the same as the C function <a class="el" href="gdal_8h.html#9de50ea77a57cb6bc84afdc658288c08">GDALGetGCPProjection()</a>.<p>
The projection string follows the normal rules from <a class="el" href="classGDALDataset.html#a42537e1062ce254d124b29ff3ebe857">GetProjectionRef()</a>.<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>internal projection string or "" if there are no GCPs. </dd></dl>

</div>
</div><p>
<a class="anchor" name="c91ea1fc26dd19f14d31baec4988d5b6"></a><!-- doxytag: member="GDALDataset::GetGCPs" ref="c91ea1fc26dd19f14d31baec4988d5b6" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const <a class="el" href="structGDAL__GCP.html">GDAL_GCP</a> * GDALDataset::GetGCPs           </td>
          <td>(</td>
          <td class="paramname">          </td>
          <td>&nbsp;)&nbsp;</td>
          <td width="100%"><code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Fetch GCPs.<p>
This method is the same as the C function <a class="el" href="gdal_8h.html#c301b5c545843cf2ef672a831153d1e3">GDALGetGCPs()</a>.<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>pointer to internal GCP structure list. It should not be modified, and may change on the next GDAL call. </dd></dl>

</div>
</div><p>
<a class="anchor" name="3c812b05467213f05055c1f18438d874"></a><!-- doxytag: member="GDALDataset::SetGCPs" ref="3c812b05467213f05055c1f18438d874" args="(int nGCPCount, const GDAL_GCP *pasGCPList, const char *pszGCPProjection)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">CPLErr GDALDataset::SetGCPs           </td>
          <td>(</td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>nGCPCount</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="el" href="structGDAL__GCP.html">GDAL_GCP</a> *&nbsp;</td>
          <td class="paramname"> <em>pasGCPList</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>pszGCPProjection</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"><code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Assign GCPs.<p>
This method is the same as the C function <a class="el" href="gdal_8h.html#cd47aa85ca5751fbe9ea09c1a2341ef8">GDALSetGCPs()</a>.<p>
This method assigns the passed set of GCPs to this dataset, as well as setting their coordinate system. Internally copies are made of the coordinate system and list of points, so the caller remains resposible for deallocating these arguments if appropriate.<p>
Most formats do not support setting of GCPs, even foramts that can handle GCPs. These formats will return CE_Failure.<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>nGCPCount</em>&nbsp;</td><td>number of GCPs being assigned.</td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pasGCPList</em>&nbsp;</td><td>array of GCP structures being assign (nGCPCount in array).</td></tr>
    <tr><td valign="top"></td><td valign="top"><em>pszGCPProjection</em>&nbsp;</td><td>the new OGC WKT coordinate system to assign for the GCP output coordinates. This parameter should be "" if no output coordinate system is known.</td></tr>
  </table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>CE_None on success, CE_Failure on failure (including if action is not supported for this format). </dd></dl>

</div>
</div><p>
<a class="anchor" name="03a02a76682d883b378a2241528775c7"></a><!-- doxytag: member="GDALDataset::AdviseRead" ref="03a02a76682d883b378a2241528775c7" args="(int nXOff, int nYOff, int nXSize, int nYSize, int nBufXSize, int nBufYSize, GDALDataType eDT, int nBandCount, int *panBandList, char **papszOptions)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">CPLErr GDALDataset::AdviseRead           </td>
          <td>(</td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>nXOff</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>nYOff</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>nXSize</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>nYSize</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>nBufXSize</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>nBufYSize</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>