30 #ifndef GDAL_PAM_H_INCLUDED
31 #define GDAL_PAM_H_INCLUDED
39 #define GCIF_GEOTRANSFORM 0x01
40 #define GCIF_PROJECTION 0x02
41 #define GCIF_METADATA 0x04
42 #define GCIF_GCPS 0x08
44 #define GCIF_NODATA 0x001000
45 #define GCIF_CATEGORYNAMES 0x002000
46 #define GCIF_MINMAX 0x004000
47 #define GCIF_SCALEOFFSET 0x008000
48 #define GCIF_UNITTYPE 0x010000
49 #define GCIF_COLORTABLE 0x020000
50 #define GCIF_COLORINTERP 0x020000
51 #define GCIF_BAND_METADATA 0x040000
52 #define GCIF_RAT 0x080000
53 #define GCIF_MASK 0x100000
54 #define GCIF_BAND_DESCRIPTION 0x200000
56 #define GCIF_ONLY_IF_MISSING 0x10000000
57 #define GCIF_PROCESS_BANDS 0x20000000
59 #define GCIF_PAM_DEFAULT (GCIF_GEOTRANSFORM | GCIF_PROJECTION | \
60 GCIF_METADATA | GCIF_GCPS | \
61 GCIF_NODATA | GCIF_CATEGORYNAMES | \
62 GCIF_MINMAX | GCIF_SCALEOFFSET | \
63 GCIF_UNITTYPE | GCIF_COLORTABLE | \
64 GCIF_COLORINTERP | GCIF_BAND_METADATA | \
65 GCIF_RAT | GCIF_MASK | \
66 GCIF_ONLY_IF_MISSING | GCIF_PROCESS_BANDS|\
67 GCIF_BAND_DESCRIPTION)
71 #define GPF_DIRTY 0x01 // .pam file needs to be written on close
72 #define GPF_TRIED_READ_FAILED 0x02 // no need to keep trying to read .pam.
73 #define GPF_DISABLED 0x04 // do not try any PAM stuff.
74 #define GPF_AUXMODE 0x08 // store info in .aux (HFA) file.
75 #define GPF_NOSAVE 0x10 // do not try to save pam info.
92 int bHaveGeoTransform;
93 double adfGeoTransform[6];
97 char *pszGCPProjection;
115 int IsPamFilenameAPotentialSiblingFile();
123 virtual CPLXMLNode *SerializeToXML(
const char *);
124 virtual CPLErr XMLInit(
CPLXMLNode *,
const char * );
126 virtual CPLErr TryLoadXML(
char **papszSiblingFiles = NULL);
127 virtual CPLErr TrySaveXML();
129 CPLErr TryLoadAux(
char **papszSiblingFiles = NULL);
132 virtual const char *BuildPamFilename();
134 void PamInitialize();
137 void SetPhysicalFilename(
const char * );
138 const char *GetPhysicalFilename();
139 void SetSubdatasetName(
const char *);
140 const char *GetSubdatasetName();
157 const char *pszGCPProjection );
160 const char * pszDomain =
"" );
162 const char * pszValue,
163 const char * pszDomain =
"" );
164 virtual char **
GetMetadata(
const char * pszDomain =
"" );
166 const char * pszDomain =
"" );
170 virtual CPLErr CloneInfo(
GDALDataset *poSrcDS,
int nCloneInfoFlags );
172 virtual CPLErr IBuildOverviews(
const char *pszResampling,
173 int nOverviews,
int *panOverviewList,
174 int nListBands,
int *panBandList,
175 GDALProgressFunc pfnProgress,
176 void * pProgressData );
180 void MarkPamDirty() { nPamFlags |= GPF_DIRTY; }
182 int GetPamFlags() {
return nPamFlags; }
183 void SetPamFlags(
int nValue ) { nPamFlags = nValue; }
201 double dfNoDataValue;
208 char **papszCategoryNames;
236 virtual CPLXMLNode *SerializeToXML(
const char *pszVRTPath );
237 virtual CPLErr XMLInit(
CPLXMLNode *,
const char * );
239 void PamInitialize();
267 virtual double GetOffset(
int *pbSuccess = NULL );
269 virtual double GetScale(
int *pbSuccess = NULL );
272 virtual CPLErr
GetHistogram(
double dfMin,
double dfMax,
273 int nBuckets, GUIntBig * panHistogram,
274 int bIncludeOutOfRange,
int bApproxOK,
275 GDALProgressFunc,
void *pProgressData );
278 int *pnBuckets, GUIntBig ** ppanHistogram,
280 GDALProgressFunc,
void *pProgressData);
283 int nBuckets, GUIntBig *panHistogram );
286 const char * pszDomain =
"" );
288 const char * pszValue,
289 const char * pszDomain =
"" );
295 virtual CPLErr CloneInfo(
GDALRasterBand *poSrcBand,
int nCloneInfoFlags );
305 int CPL_DLL PamParseHistogram(
CPLXMLNode *psHistItem,
306 double *pdfMin,
double *pdfMax,
307 int *pnBuckets, GUIntBig **ppanHistogram,
308 int *pbIncludeOutOfRange,
int *pbApproxOK );
310 PamFindMatchingHistogram(
CPLXMLNode *psSavedHistograms,
311 double dfMin,
double dfMax,
int nBuckets,
312 int bIncludeOutOfRange,
int bApproxOK );
314 PamHistogramToXMLTree(
double dfMin,
double dfMax,
315 int nBuckets, GUIntBig * panHistogram,
316 int bIncludeOutOfRange,
int bApprox );
319 const char CPL_DLL * PamGetProxy(
const char * );
320 const char CPL_DLL * PamAllocateProxy(
const char * );
321 const char CPL_DLL * PamDeallocateProxy(
const char * );
322 void CPL_DLL PamCleanProxyDB(
void );
The GDALRasterAttributeTable (or RAT) class is used to encapsulate a table used to provide attribute ...
Definition: gdal_rat.h:46
Definition: gdal_pam.h:197
virtual CPLErr GetGeoTransform(double *)
Fetch the affine transformation coefficients.
Definition: gdaldataset.cpp:903
virtual double GetScale(int *pbSuccess=NULL)
Fetch the raster value scale.
Definition: gdalrasterband.cpp:2317
Document node structure.
Definition: cpl_minixml.h:65
virtual double GetNoDataValue(int *pbSuccess=NULL)
Fetch the no data value for this band.
Definition: gdalrasterband.cpp:1428
virtual char ** GetCategoryNames()
Fetch the list of category names for this raster.
Definition: gdalrasterband.cpp:1335
virtual void SetDescription(const char *)
Set object description.
Definition: gdalmajorobject.cpp:116
virtual void FlushCache(void)
Flush all write cached data to disk.
Definition: gdaldataset.cpp:374
virtual CPLErr SetColorInterpretation(GDALColorInterp)
Set color interpretation of a band.
Definition: gdalrasterband.cpp:1807
virtual CPLErr GetDefaultHistogram(double *pdfMin, double *pdfMax, int *pnBuckets, GUIntBig **ppanHistogram, int bForce, GDALProgressFunc, void *pProgressData)
Fetch default raster histogram.
Definition: gdalrasterband.cpp:3198
virtual CPLErr SetProjection(const char *)
Set the projection reference string for this dataset.
Definition: gdaldataset.cpp:846
virtual GDALColorInterp GetColorInterpretation()
How should this band be interpreted as color?
Definition: gdalrasterband.cpp:1767
virtual CPLErr SetScale(double)
Set scaling ratio.
Definition: gdalrasterband.cpp:2362
virtual double GetOffset(int *pbSuccess=NULL)
Fetch the raster value offset.
Definition: gdalrasterband.cpp:2218
virtual const char * GetProjectionRef(void)
Fetch the projection definition string for this dataset.
Definition: gdaldataset.cpp:803
Definition: gdal_pam.h:85
virtual GDALRasterAttributeTable * GetDefaultRAT()
Fetch default Raster Attribute Table.
Definition: gdalrasterband.cpp:4505
virtual char ** GetMetadata(const char *pszDomain="")
Fetch metadata.
Definition: gdalmajorobject.cpp:243
virtual CPLErr SetOffset(double)
Set scaling offset.
Definition: gdalrasterband.cpp:2263
virtual CPLErr GetHistogram(double dfMin, double dfMax, int nBuckets, GUIntBig *panHistogram, int bIncludeOutOfRange, int bApproxOK, GDALProgressFunc, void *pProgressData)
Compute raster histogram.
Definition: gdalrasterband.cpp:2683
Convenient string class based on std::string.
Definition: cpl_string.h:283
virtual CPLErr SetGCPs(int nGCPCount, const GDAL_GCP *pasGCPList, const char *pszGCPProjection)
Assign GCPs.
Definition: gdaldataset.cpp:1341
virtual CPLErr SetDefaultHistogram(double dfMin, double dfMax, int nBuckets, GUIntBig *panHistogram)
Set default histogram.
Definition: gdalrasterband.cpp:4410
virtual CPLErr SetColorTable(GDALColorTable *)
Set the raster color table.
Definition: gdalrasterband.cpp:1899
virtual const char * GetMetadataItem(const char *pszName, const char *pszDomain="")
Fetch single metadata item.
Definition: gdalmajorobject.cpp:331
Definition: gdal_pam.h:230
virtual const GDAL_GCP * GetGCPs()
Fetch GCPs.
Definition: gdaldataset.cpp:1287
virtual CPLErr SetGeoTransform(double *)
Set the affine transformation coefficients.
Definition: gdaldataset.cpp:956
virtual CPLErr DeleteNoDataValue()
Remove the no data value for this band.
Definition: gdalrasterband.cpp:1539
virtual CPLErr SetMetadata(char **papszMetadata, const char *pszDomain="")
Set metadata.
Definition: gdalmajorobject.cpp:286
virtual int GetGCPCount()
Get number of GCPs.
Definition: gdaldataset.cpp:1211
virtual CPLErr SetNoDataValue(double)
Set the no data value for this band.
Definition: gdalrasterband.cpp:1483
virtual const char * GetUnitType()
Return raster unit type.
Definition: gdalrasterband.cpp:2409
A subclass of GDALDataset which introduces the ability to save and restore auxiliary information (coo...
Definition: gdal_pam.h:110
virtual GDALColorTable * GetColorTable()
Fetch the color table associated with band.
Definition: gdalrasterband.cpp:1854
virtual char ** GetFileList(void)
Fetch files forming dataset.
Definition: gdaldataset.cpp:2303
virtual const char * GetGCPProjection()
Get output projection for GCPs.
Definition: gdaldataset.cpp:1250
virtual CPLErr SetCategoryNames(char **)
Set the category names for this band.
Definition: gdalrasterband.cpp:1379
virtual CPLErr SetUnitType(const char *)
Set unit type.
Definition: gdalrasterband.cpp:2453
A single raster band (or channel).
Definition: gdal_priv.h:735
A set of associated raster bands, usually from one file.
Definition: gdal_priv.h:296
virtual CPLErr SetDefaultRAT(const GDALRasterAttributeTable *)
Set default Raster Attribute Table.
Definition: gdalrasterband.cpp:4549
GDALColorInterp
Definition: gdal.h:173
virtual CPLErr SetMetadataItem(const char *pszName, const char *pszValue, const char *pszDomain="")
Set single metadata item.
Definition: gdalmajorobject.cpp:374
Definition: gdal_priv.h:659
Ground Control Point.
Definition: gdal.h:492