@cpp.js/package-gdal 1.0.0-beta.21 → 1.0.0-beta.23

package/dist/prebuilt/Android-x86_64/include/gdal_mdreader.h

@@ -0,0 +1,240 @@
+/******************************************************************************
+ * $Id$
+ *
+ * Project:  GDAL Core
+ * Purpose:  Read metadata (mainly the remote sensing imagery) from files of
+ *           different providers like DigitalGlobe, GeoEye etc.
+ * Author:   Dmitry Baryshnikov, polimax@mail.ru
+ *
+ ******************************************************************************
+ * Copyright (c) 2014-2015, NextGIS info@nextgis.ru
+ *
+ * SPDX-License-Identifier: MIT
+ ****************************************************************************/
+
+#ifndef GDAL_MDREADER_H_INCLUDED
+#define GDAL_MDREADER_H_INCLUDED
+
+#include "cpl_port.h"
+#include "gdal_priv.h"
+
+#include <map>
+
+#define MD_DOMAIN_IMD "IMD"         /**< image metadata section */
+#define MD_DOMAIN_RPC "RPC"         /**< rpc metadata section */
+#define MD_DOMAIN_IMAGERY "IMAGERY" /**< imagery metadata section */
+#define MD_DOMAIN_DEFAULT ""        /**< default metadata section */
+
+#define MD_NAME_ACQDATETIME                                                    \
+    "ACQUISITIONDATETIME" /**< Acquisition Date Time property name. The time   \
+                             should be in UTC */
+#define MD_NAME_SATELLITE                                                      \
+    "SATELLITEID" /**< Satellite identificator property name */
+#define MD_NAME_CLOUDCOVER                                                     \
+    "CLOUDCOVER" /**< Cloud coverage property name. The value between 0 - 100  \
+                    or 999 if n/a */
+#define MD_NAME_MDTYPE                                                         \
+    "METADATATYPE" /**< Metadata reader type property name. The reader         \
+                      processed this metadata */
+
+#define MD_DATETIMEFORMAT "%Y-%m-%d %H:%M:%S" /**< Date time format */
+#define MD_CLOUDCOVER_NA "999" /**< The value if cloud cover is n/a */
+
+/**
+ * RPC/RPB specific defines
+ */
+
+#define RPC_ERR_BIAS "ERR_BIAS"
+#define RPC_ERR_RAND "ERR_RAND"
+#define RPC_LINE_OFF "LINE_OFF"
+#define RPC_SAMP_OFF "SAMP_OFF"
+#define RPC_LAT_OFF "LAT_OFF"
+#define RPC_LONG_OFF "LONG_OFF"
+#define RPC_HEIGHT_OFF "HEIGHT_OFF"
+#define RPC_LINE_SCALE "LINE_SCALE"
+#define RPC_SAMP_SCALE "SAMP_SCALE"
+#define RPC_LAT_SCALE "LAT_SCALE"
+#define RPC_LONG_SCALE "LONG_SCALE"
+#define RPC_HEIGHT_SCALE "HEIGHT_SCALE"
+#define RPC_LINE_NUM_COEFF "LINE_NUM_COEFF"
+#define RPC_LINE_DEN_COEFF "LINE_DEN_COEFF"
+#define RPC_SAMP_NUM_COEFF "SAMP_NUM_COEFF"
+#define RPC_SAMP_DEN_COEFF "SAMP_DEN_COEFF"
+
+/* Optional */
+#define RPC_MIN_LONG "MIN_LONG"
+#define RPC_MIN_LAT "MIN_LAT"
+#define RPC_MAX_LONG "MAX_LONG"
+#define RPC_MAX_LAT "MAX_LAT"
+
+/* Pleiades Neo nomenclature */
+#define RPC_LAT_NUM_COEFF "LAT_NUM_COEFF"
+#define RPC_LAT_DEN_COEFF "LAT_DEN_COEFF"
+#define RPC_LON_NUM_COEFF "LON_NUM_COEFF"
+#define RPC_LON_DEN_COEFF "LON_DEN_COEFF"
+
+/**
+ * Enumerator of metadata readers
+ */
+
+typedef enum
+{
+    MDR_None = 0x00000000,     /**< no reader */
+    MDR_DG = 0x00000001,       /**< Digital Globe, METADATATYPE=DG */
+    MDR_GE = 0x00000002,       /**< Geo Eye,       METADATATYPE=GE */
+    MDR_OV = 0x00000004,       /**< Orb View,      METADATATYPE=OV */
+    MDR_PLEIADES = 0x00000008, /**< Pleiades,      METADATATYPE=DIMAP */
+    MDR_SPOT = 0x00000010,     /**< Spot,          METADATATYPE=DIMAP */
+    MDR_RDK1 = 0x00000020,     /**< Resurs DK1,    METADATATYPE=MSP */
+    MDR_LS = 0x00000040,       /**< Landsat,       METADATATYPE=ODL */
+    MDR_RE = 0x00000080,       /**< RapidEye,      METADATATYPE=RE */
+    MDR_KOMPSAT = 0x00000100,  /**< Kompsat,       METADATATYPE=KARI */
+    MDR_EROS = 0x00000200,     /**< EROS,          METADATATYPE=EROS */
+    MDR_ALOS = 0x00000400,     /**< ALOS,          METADATATYPE=ALOS */
+    MDR_ANY = MDR_DG | MDR_GE | MDR_OV | MDR_PLEIADES | MDR_SPOT | MDR_RDK1 |
+              MDR_LS | MDR_RE | MDR_KOMPSAT | MDR_EROS |
+              MDR_ALOS /**< any reader */
+} MDReaders;
+
+/**
+ * The base class for all metadata readers
+ */
+class CPL_DLL GDALMDReaderBase
+{
+
+    CPL_DISALLOW_COPY_ASSIGN(GDALMDReaderBase)
+
+    static bool
+    ReadXMLToListFirstPass(const CPLXMLNode *psNode,
+                           std::map<std::string, int> &oMapCountKeysFull,
+                           const std::string &osPrefixFull, int nDepth);
+
+    char **ReadXMLToList(const CPLXMLNode *psNode, char **papszList,
+                         const std::map<std::string, int> &oMapCountKeysFullRef,
+                         std::map<std::string, int> &oMapCountKeysFull,
+                         std::map<std::string, int> &oMapCountKeys,
+                         const std::string &osPrefix,
+                         const std::string &osPrefixFull);
+
+  public:
+    GDALMDReaderBase(const char *pszPath, char **papszSiblingFiles);
+    virtual ~GDALMDReaderBase();
+
+    /**
+     * @brief Get specified metadata domain
+     * @param pszDomain The metadata domain to return
+     * @return List of metadata items
+     */
+    virtual char **GetMetadataDomain(const char *pszDomain);
+    /**
+     * @brief Fill provided metadata store class
+     * @param poMDMD Metadata store class
+     * @return true on success or false
+     */
+    virtual bool FillMetadata(GDALMultiDomainMetadata *poMDMD);
+    /**
+     * @brief Determine whether the input parameter correspond to the particular
+     *        provider of remote sensing data completely
+     * @return True if all needed sources files found
+     */
+    virtual bool HasRequiredFiles() const = 0;
+    /**
+     * @brief Get metadata file names. The caller become owner of returned list
+     *        and have to free it via CSLDestroy.
+     * @return A file name list
+     */
+    virtual char **GetMetadataFiles() const = 0;
+
+  protected:
+    /**
+     * @brief Load metadata to the correspondent IMD, RPB, IMAGERY and DEFAULT
+     *        domains
+     */
+    virtual void LoadMetadata();
+    /**
+     * @brief Convert string like 2012-02-25T00:25:59.9440000Z to time
+     * @param pszDateTime String to convert
+     * @return value in second sinc epoch 1970-01-01 00:00:00
+     */
+    virtual GIntBig GetAcquisitionTimeFromString(const char *pszDateTime);
+    /**
+     * @brief ReadXMLToList Transform xml to list of NULL terminated name=value
+     *        strings
+     * @param psNode A xml node to process
+     * @param papszList A list to fill with name=value strings
+     * @param pszName A name of parent node. For root xml node should be empty.
+     *        If name is not empty, the sibling nodes will not proceed
+     * @return An input list filled with values
+     */
+    virtual char **ReadXMLToList(CPLXMLNode *psNode, char **papszList,
+                                 const char *pszName = "");
+    /**
+     * @brief AddXMLNameValueToList Execute from ReadXMLToList to add name and
+     *        value to list. One can override this function for special
+     *        processing input values before add to list.
+     * @param papszList A list to fill with name=value strings
+     * @param pszName A name to add
+     * @param pszValue A value to add
+     * @return An input list filled with values
+     */
+    virtual char **AddXMLNameValueToList(char **papszList, const char *pszName,
+                                         const char *pszValue);
+
+  protected:
+    //! @cond Doxygen_Suppress
+    char **m_papszIMDMD = nullptr;
+    char **m_papszRPCMD = nullptr;
+    char **m_papszIMAGERYMD = nullptr;
+    char **m_papszDEFAULTMD = nullptr;
+    bool m_bIsMetadataLoad = false;
+    //! @endcond
+};
+
+/**
+ * The metadata reader main class.
+ * The main purpose of this class is to provide an correspondent reader
+ * for provided path.
+ */
+class CPL_DLL GDALMDReaderManager
+{
+
+    CPL_DISALLOW_COPY_ASSIGN(GDALMDReaderManager)
+
+  public:
+    GDALMDReaderManager();
+    virtual ~GDALMDReaderManager();
+
+    /**
+     * @brief Try to detect metadata reader correspondent to the provided
+     *        datasource path
+     * @param pszPath a path to GDALDataset
+     * @param papszSiblingFiles file list for metadata search purposes
+     * @param nType a preferable reader type (may be the OR of MDReaders)
+     * @return an appropriate reader or NULL if no such reader or error.
+     * The pointer delete by the GDALMDReaderManager, so the user have not
+     * delete it.
+     */
+    virtual GDALMDReaderBase *GetReader(const char *pszPath,
+                                        char **papszSiblingFiles,
+                                        GUInt32 nType = MDR_ANY);
+
+  protected:
+    //! @cond Doxygen_Suppress
+    GDALMDReaderBase *m_pReader = nullptr;
+    //! @endcond
+};
+
+// misc
+CPLString CPLStrip(const CPLString &osString, const char cChar);
+CPLString CPLStripQuotes(const CPLString &osString);
+char **GDALLoadRPBFile(const CPLString &osFilePath);
+char CPL_DLL **GDALLoadRPCFile(const CPLString &osFilePath);
+char **GDALLoadIMDFile(const CPLString &osFilePath);
+bool GDALCheckFileHeader(const CPLString &soFilePath, const char *pszTestString,
+                         int nBufferSize = 256);
+
+CPLErr GDALWriteRPBFile(const char *pszFilename, char **papszMD);
+CPLErr CPL_DLL GDALWriteRPCTXTFile(const char *pszFilename, char **papszMD);
+CPLErr GDALWriteIMDFile(const char *pszFilename, char **papszMD);
+
+#endif  // GDAL_MDREADER_H_INCLUDED

package/dist/prebuilt/Android-x86_64/include/gdal_pam.h

@@ -0,0 +1,461 @@
+/******************************************************************************
+ * $Id$
+ *
+ * Project:  GDAL Core
+ * Purpose:  Declaration for Peristable Auxiliary Metadata classes.
+ * Author:   Frank Warmerdam, warmerdam@pobox.com
+ *
+ ******************************************************************************
+ * Copyright (c) 2005, Frank Warmerdam <warmerdam@pobox.com>
+ *
+ * SPDX-License-Identifier: MIT
+ ****************************************************************************/
+
+#ifndef GDAL_PAM_H_INCLUDED
+#define GDAL_PAM_H_INCLUDED
+
+//! @cond Doxygen_Suppress
+
+#include "cpl_minixml.h"
+#include "gdal_priv.h"
+#include <array>
+#include <limits>
+#include <map>
+#include <vector>
+
+class GDALPamRasterBand;
+
+/* Clone Info Flags */
+
+#define GCIF_GEOTRANSFORM 0x01
+#define GCIF_PROJECTION 0x02
+#define GCIF_METADATA 0x04
+#define GCIF_GCPS 0x08
+
+#define GCIF_NODATA 0x001000
+#define GCIF_CATEGORYNAMES 0x002000
+#define GCIF_MINMAX 0x004000
+#define GCIF_SCALEOFFSET 0x008000
+#define GCIF_UNITTYPE 0x010000
+#define GCIF_COLORTABLE 0x020000
+/* Same value as GCIF_COLORTABLE */
+#define GCIF_COLORINTERP 0x020000
+#define GCIF_BAND_METADATA 0x040000
+#define GCIF_RAT 0x080000
+#define GCIF_MASK 0x100000
+#define GCIF_BAND_DESCRIPTION 0x200000
+
+#define GCIF_ONLY_IF_MISSING 0x10000000
+#define GCIF_PROCESS_BANDS 0x20000000
+
+#define GCIF_PAM_DEFAULT                                                       \
+    (GCIF_GEOTRANSFORM | GCIF_PROJECTION | GCIF_METADATA | GCIF_GCPS |         \
+     GCIF_NODATA | GCIF_CATEGORYNAMES | GCIF_MINMAX | GCIF_SCALEOFFSET |       \
+     GCIF_UNITTYPE | GCIF_COLORTABLE | GCIF_BAND_METADATA | GCIF_RAT |         \
+     GCIF_MASK | GCIF_ONLY_IF_MISSING | GCIF_PROCESS_BANDS |                   \
+     GCIF_BAND_DESCRIPTION)
+
+/* GDAL PAM Flags */
+/* ERO 2011/04/13 : GPF_AUXMODE seems to be unimplemented */
+#define GPF_DIRTY 0x01              // .pam file needs to be written on close
+#define GPF_TRIED_READ_FAILED 0x02  // no need to keep trying to read .pam.
+#define GPF_DISABLED 0x04           // do not try any PAM stuff.
+#define GPF_AUXMODE 0x08            // store info in .aux (HFA) file.
+#define GPF_NOSAVE 0x10             // do not try to save pam info.
+
+/* ==================================================================== */
+/*      GDALDatasetPamInfo                                              */
+/*                                                                      */
+/*      We make these things a separate structure of information        */
+/*      primarily so we can modify it without altering the size of      */
+/*      the GDALPamDataset.  It is an effort to reduce ABI churn for    */
+/*      driver plugins.                                                 */
+/* ==================================================================== */
+class GDALDatasetPamInfo
+{
+  public:
+    char *pszPamFilename = nullptr;
+
+    std::vector<CPLXMLTreeCloser> m_apoOtherNodes{};
+
+    OGRSpatialReference *poSRS = nullptr;
+
+    int bHaveGeoTransform = false;
+    std::array<double, 6> adfGeoTransform{};
+
+    std::vector<gdal::GCP> asGCPs{};
+    OGRSpatialReference *poGCP_SRS = nullptr;
+
+    CPLString osPhysicalFilename{};
+    CPLString osSubdatasetName{};
+    CPLString osDerivedDatasetName{};
+    CPLString osAuxFilename{};
+
+    int bHasMetadata = false;
+};
+
+//! @endcond
+
+/* ******************************************************************** */
+/*                           GDALPamDataset                             */
+/* ******************************************************************** */
+
+/** PAM dataset */
+class CPL_DLL GDALPamDataset : public GDALDataset
+{
+    friend class GDALPamRasterBand;
+
+  private:
+    int IsPamFilenameAPotentialSiblingFile();
+
+  protected:
+    GDALPamDataset(void);
+    //! @cond Doxygen_Suppress
+    int nPamFlags = 0;
+    GDALDatasetPamInfo *psPam = nullptr;
+
+    virtual CPLXMLNode *SerializeToXML(const char *);
+    virtual CPLErr XMLInit(const CPLXMLNode *, const char *);
+
+    virtual CPLErr TryLoadXML(CSLConstList papszSiblingFiles = nullptr);
+    virtual CPLErr TrySaveXML();
+
+    CPLErr TryLoadAux(CSLConstList papszSiblingFiles = nullptr);
+    CPLErr TrySaveAux();
+
+    virtual const char *BuildPamFilename();
+
+    void PamInitialize();
+    void PamClear();
+
+    void SetPhysicalFilename(const char *);
+    const char *GetPhysicalFilename();
+    void SetSubdatasetName(const char *);
+    const char *GetSubdatasetName();
+    void SetDerivedDatasetName(const char *);
+    //! @endcond
+
+  public:
+    ~GDALPamDataset() override;
+
+    CPLErr FlushCache(bool bAtClosing) override;
+
+    const OGRSpatialReference *GetSpatialRef() const override;
+    CPLErr SetSpatialRef(const OGRSpatialReference *poSRS) override;
+
+    CPLErr GetGeoTransform(double *) override;
+    CPLErr SetGeoTransform(double *) override;
+    void DeleteGeoTransform();
+
+    int GetGCPCount() override;
+    const OGRSpatialReference *GetGCPSpatialRef() const override;
+    const GDAL_GCP *GetGCPs() override;
+    using GDALDataset::SetGCPs;
+    CPLErr SetGCPs(int nGCPCount, const GDAL_GCP *pasGCPList,
+                   const OGRSpatialReference *poSRS) override;
+
+    CPLErr SetMetadata(char **papszMetadata,
+                       const char *pszDomain = "") override;
+    CPLErr SetMetadataItem(const char *pszName, const char *pszValue,
+                           const char *pszDomain = "") override;
+    char **GetMetadata(const char *pszDomain = "") override;
+    const char *GetMetadataItem(const char *pszName,
+                                const char *pszDomain = "") override;
+
+    char **GetFileList(void) override;
+
+    void ClearStatistics() override;
+
+    //! @cond Doxygen_Suppress
+    virtual CPLErr CloneInfo(GDALDataset *poSrcDS, int nCloneInfoFlags);
+
+    CPLErr IBuildOverviews(const char *pszResampling, int nOverviews,
+                           const int *panOverviewList, int nListBands,
+                           const int *panBandList, GDALProgressFunc pfnProgress,
+                           void *pProgressData,
+                           CSLConstList papszOptions) override;
+
+    // "semi private" methods.
+    void MarkPamDirty();
+
+    GDALDatasetPamInfo *GetPamInfo()
+    {
+        return psPam;
+    }
+
+    int GetPamFlags()
+    {
+        return nPamFlags;
+    }
+
+    void SetPamFlags(int nValue)
+    {
+        nPamFlags = nValue;
+    }
+
+    //! @endcond
+
+  private:
+    CPL_DISALLOW_COPY_ASSIGN(GDALPamDataset)
+};
+
+//! @cond Doxygen_Suppress
+
+constexpr double GDAL_PAM_DEFAULT_NODATA_VALUE = 0;
+// Parenthesis for external code around std::numeric_limits<>::min/max,
+// for external Windows code that might have includes <windows.h> before
+// without defining NOMINMAX
+constexpr int64_t GDAL_PAM_DEFAULT_NODATA_VALUE_INT64 =
+    (std::numeric_limits<int64_t>::min)();
+constexpr uint64_t GDAL_PAM_DEFAULT_NODATA_VALUE_UINT64 =
+    (std::numeric_limits<uint64_t>::max)();
+
+/* ==================================================================== */
+/*      GDALRasterBandPamInfo                                           */
+/*                                                                      */
+/*      We make these things a separate structure of information        */
+/*      primarily so we can modify it without altering the size of      */
+/*      the GDALPamDataset.  It is an effort to reduce ABI churn for    */
+/*      driver plugins.                                                 */
+/* ==================================================================== */
+struct GDALRasterBandPamInfo
+{
+    GDALPamDataset *poParentDS = nullptr;
+
+    bool bNoDataValueSet = false;
+    bool bNoDataValueSetAsInt64 = false;
+    bool bNoDataValueSetAsUInt64 = false;
+
+    double dfNoDataValue = GDAL_PAM_DEFAULT_NODATA_VALUE;
+    int64_t nNoDataValueInt64 = GDAL_PAM_DEFAULT_NODATA_VALUE_INT64;
+    uint64_t nNoDataValueUInt64 = GDAL_PAM_DEFAULT_NODATA_VALUE_UINT64;
+
+    GDALColorTable *poColorTable = nullptr;
+
+    GDALColorInterp eColorInterp = GCI_Undefined;
+
+    char *pszUnitType = nullptr;
+    char **papszCategoryNames = nullptr;
+
+    double dfOffset = 0.0;
+    double dfScale = 1.0;
+
+    int bHaveMinMax = FALSE;
+    double dfMin = 0;
+    double dfMax = 0;
+
+    int bHaveStats = FALSE;
+    double dfMean = 0;
+    double dfStdDev = 0;
+
+    CPLXMLNode *psSavedHistograms = nullptr;
+
+    GDALRasterAttributeTable *poDefaultRAT = nullptr;
+
+    bool bOffsetSet = false;
+    bool bScaleSet = false;
+
+    void CopyFrom(const GDALRasterBandPamInfo &sOther);
+};
+
+//! @endcond
+/* ******************************************************************** */
+/*                          GDALPamRasterBand                           */
+/* ******************************************************************** */
+
+/** PAM raster band */
+class CPL_DLL GDALPamRasterBand : public GDALRasterBand
+{
+    friend class GDALPamDataset;
+
+  protected:
+    //! @cond Doxygen_Suppress
+    virtual CPLXMLNode *SerializeToXML(const char *pszVRTPath);
+    virtual CPLErr XMLInit(const CPLXMLNode *, const char *);
+
+    void PamInitialize();
+    void PamClear();
+    void PamInitializeNoParent();
+    void MarkPamDirty();
+
+    GDALRasterBandPamInfo *psPam = nullptr;
+    //! @endcond
+
+  public:
+    GDALPamRasterBand();
+    //! @cond Doxygen_Suppress
+    explicit GDALPamRasterBand(int bForceCachedIO);
+    //! @endcond
+    ~GDALPamRasterBand() override;
+
+    void SetDescription(const char *) override;
+
+    CPLErr SetNoDataValue(double) override;
+    CPLErr SetNoDataValueAsInt64(int64_t nNoData) override;
+    CPLErr SetNoDataValueAsUInt64(uint64_t nNoData) override;
+    double GetNoDataValue(int *pbSuccess = nullptr) override;
+    int64_t GetNoDataValueAsInt64(int *pbSuccess = nullptr) override;
+    uint64_t GetNoDataValueAsUInt64(int *pbSuccess = nullptr) override;
+    CPLErr DeleteNoDataValue() override;
+
+    CPLErr SetColorTable(GDALColorTable *) override;
+    GDALColorTable *GetColorTable() override;
+
+    CPLErr SetColorInterpretation(GDALColorInterp) override;
+    GDALColorInterp GetColorInterpretation() override;
+
+    const char *GetUnitType() override;
+    CPLErr SetUnitType(const char *) override;
+
+    char **GetCategoryNames() override;
+    CPLErr SetCategoryNames(char **) override;
+
+    double GetOffset(int *pbSuccess = nullptr) override;
+    CPLErr SetOffset(double) override;
+    double GetScale(int *pbSuccess = nullptr) override;
+    CPLErr SetScale(double) override;
+
+    CPLErr GetHistogram(double dfMin, double dfMax, int nBuckets,
+                        GUIntBig *panHistogram, int bIncludeOutOfRange,
+                        int bApproxOK, GDALProgressFunc,
+                        void *pProgressData) override;
+
+    CPLErr GetDefaultHistogram(double *pdfMin, double *pdfMax, int *pnBuckets,
+                               GUIntBig **ppanHistogram, int bForce,
+                               GDALProgressFunc, void *pProgressData) override;
+
+    CPLErr SetDefaultHistogram(double dfMin, double dfMax, int nBuckets,
+                               GUIntBig *panHistogram) override;
+
+    CPLErr SetMetadata(char **papszMetadata,
+                       const char *pszDomain = "") override;
+    CPLErr SetMetadataItem(const char *pszName, const char *pszValue,
+                           const char *pszDomain = "") override;
+
+    GDALRasterAttributeTable *GetDefaultRAT() override;
+    CPLErr SetDefaultRAT(const GDALRasterAttributeTable *) override;
+
+    //! @cond Doxygen_Suppress
+    // new in GDALPamRasterBand.
+    virtual CPLErr CloneInfo(GDALRasterBand *poSrcBand, int nCloneInfoFlags);
+
+    // "semi private" methods.
+    GDALRasterBandPamInfo *GetPamInfo()
+    {
+        return psPam;
+    }
+
+    //! @endcond
+  private:
+    CPL_DISALLOW_COPY_ASSIGN(GDALPamRasterBand)
+
+    void ResetNoDataValues();
+};
+
+//! @cond Doxygen_Suppress
+
+/* ******************************************************************** */
+/*                          GDALPamMultiDim                             */
+/* ******************************************************************** */
+
+/** Class that serializes/deserializes metadata on multidimensional objects.
+ * Currently SRS on GDALMDArray.
+ */
+class CPL_DLL GDALPamMultiDim
+{
+    struct Private;
+    std::unique_ptr<Private> d;
+
+    void Load();
+    void Save();
+
+  public:
+    explicit GDALPamMultiDim(const std::string &osFilename);
+    virtual ~GDALPamMultiDim();
+
+    std::shared_ptr<OGRSpatialReference>
+    GetSpatialRef(const std::string &osArrayFullName,
+                  const std::string &osContext);
+
+    void SetSpatialRef(const std::string &osArrayFullName,
+                       const std::string &osContext,
+                       const OGRSpatialReference *poSRS);
+
+    CPLErr GetStatistics(const std::string &osArrayFullName,
+                         const std::string &osContext, bool bApproxOK,
+                         double *pdfMin, double *pdfMax, double *pdfMean,
+                         double *pdfStdDev, GUInt64 *pnValidCount);
+
+    void SetStatistics(const std::string &osArrayFullName,
+                       const std::string &osContext, bool bApproxStats,
+                       double dfMin, double dfMax, double dfMean,
+                       double dfStdDev, GUInt64 nValidCount);
+
+    void ClearStatistics();
+
+    void ClearStatistics(const std::string &osArrayFullName,
+                         const std::string &osContext);
+
+    static std::shared_ptr<GDALPamMultiDim>
+    GetPAM(const std::shared_ptr<GDALMDArray> &poParent);
+};
+
+/* ******************************************************************** */
+/*                          GDALPamMDArray                              */
+/* ******************************************************************** */
+
+/** Class that relies on GDALPamMultiDim to serializes/deserializes metadata. */
+class CPL_DLL GDALPamMDArray : public GDALMDArray
+{
+    std::shared_ptr<GDALPamMultiDim> m_poPam;
+
+  protected:
+    GDALPamMDArray(const std::string &osParentName, const std::string &osName,
+                   const std::shared_ptr<GDALPamMultiDim> &poPam,
+                   const std::string &osContext = std::string());
+
+    bool SetStatistics(bool bApproxStats, double dfMin, double dfMax,
+                       double dfMean, double dfStdDev, GUInt64 nValidCount,
+                       CSLConstList papszOptions) override;
+
+  public:
+    const std::shared_ptr<GDALPamMultiDim> &GetPAM() const
+    {
+        return m_poPam;
+    }
+
+    CPLErr GetStatistics(bool bApproxOK, bool bForce, double *pdfMin,
+                         double *pdfMax, double *pdfMean, double *padfStdDev,
+                         GUInt64 *pnValidCount, GDALProgressFunc pfnProgress,
+                         void *pProgressData) override;
+
+    void ClearStatistics() override;
+
+    bool SetSpatialRef(const OGRSpatialReference *poSRS) override;
+
+    std::shared_ptr<OGRSpatialReference> GetSpatialRef() const override;
+};
+
+// These are mainly helper functions for internal use.
+int CPL_DLL PamParseHistogram(CPLXMLNode *psHistItem, double *pdfMin,
+                              double *pdfMax, int *pnBuckets,
+                              GUIntBig **ppanHistogram,
+                              int *pbIncludeOutOfRange, int *pbApproxOK);
+CPLXMLNode CPL_DLL *PamFindMatchingHistogram(CPLXMLNode *psSavedHistograms,
+                                             double dfMin, double dfMax,
+                                             int nBuckets,
+                                             int bIncludeOutOfRange,
+                                             int bApproxOK);
+CPLXMLNode CPL_DLL *PamHistogramToXMLTree(double dfMin, double dfMax,
+                                          int nBuckets, GUIntBig *panHistogram,
+                                          int bIncludeOutOfRange, int bApprox);
+
+// For managing the proxy file database.
+const char CPL_DLL *PamGetProxy(const char *);
+const char CPL_DLL *PamAllocateProxy(const char *);
+const char CPL_DLL *PamDeallocateProxy(const char *);
+void CPL_DLL PamCleanProxyDB(void);
+
+//! @endcond
+
+#endif /* ndef GDAL_PAM_H_INCLUDED */