text: /******************************************************************************
   * $Id: hdf4dataset.h 36501 2016-11-25 14:09:24Z rouault $
   *
   * Project:  Hierarchical Data Format Release 4 (HDF4)
   * Purpose:  Header file for HDF4 datasets reader.
   * Author:   Andrey Kiselev, dron@ak4719.spb.edu
   *
   ******************************************************************************
   * Copyright (c) 2002, Andrey Kiselev <dron@ak4719.spb.edu>
   *
   * Permission is hereby granted, free of charge, to any person obtaining a
   * copy of this software and associated documentation files (the "Software"),
   * to deal in the Software without restriction, including without limitation
   * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   * and/or sell copies of the Software, and to permit persons to whom the
   * Software is furnished to do so, subject to the following conditions:
   *
   * The above copyright notice and this permission notice shall be included
   * in all copies or substantial portions of the Software.
   *
   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
   * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
   * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
   * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
   * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
   * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
   * DEALINGS IN THE SOFTWARE.
   ****************************************************************************/
  
  #ifndef HDF4DATASET_H_INCLUDED_
  #define HDF4DATASET_H_INCLUDED_
  
  #include "cpl_list.h"
  #include "gdal_pam.h"
  
  typedef enum                    // Types of dataset:
  {
      HDF4_SDS,                   // Scientific Dataset
      HDF4_GR,                    // General Raster Image
      HDF4_EOS,                   // HDF EOS
      HDF4_UNKNOWN
  } HDF4DatasetType;
  
  typedef enum                    // Types of data products:
  {
      H4ST_GDAL,                  // HDF written by GDAL
      H4ST_EOS_GRID,              // HDF-EOS Grid
      H4ST_EOS_SWATH,             // HDF-EOS Swath
      H4ST_EOS_SWATH_GEOL,        // HDF-EOS Swath Geolocation Array
      H4ST_SEAWIFS_L1A,           // SeaWiFS Level-1A Data
      H4ST_SEAWIFS_L2,            // SeaWiFS Level-2 Data
      H4ST_SEAWIFS_L3,            // SeaWiFS Level-3 Standard Mapped Image
      H4ST_HYPERION_L1,           // Hyperion L1 Data Product
      H4ST_UNKNOWN
  } HDF4SubdatasetType;
  
  /************************************************************************/
  /* ==================================================================== */
  /*                              HDF4Dataset                             */
  /* ==================================================================== */
  /************************************************************************/
  
  class HDF4Dataset : public GDALPamDataset
  {
  
    private:
  
      bool bIsHDFEOS;
  
      static char **HDF4EOSTokenizeAttrs( const char *pszString );
      static char **HDF4EOSGetObject( char **papszAttrList, char **ppszAttrName,
                                      char **ppszAttrClass, char **ppszAttrValue );
  
    protected:
      int32       hGR;
      int32       hSD;
      int32       nImages;
      HDF4SubdatasetType iSubdatasetType;
      const char  *pszSubdatasetType;
  
      char        **papszGlobalMetadata;
      char        **papszSubDatasets;
  
      CPLErr              ReadGlobalAttributes( int32 );
  
      static GDALDataType GetDataType( int32 ) ;
      static const char   *GetDataTypeName( int32 );
      static int          GetDataTypeSize( int32 );
      static double       AnyTypeToDouble( int32, void * );
      static char         **TranslateHDF4Attributes( int32, int32, char *,
                                                     int32, int32, char ** );
      static char         **TranslateHDF4EOSAttributes( int32, int32, int32,
                                                        char ** );
  
    public:
                  HDF4Dataset();
      virtual ~HDF4Dataset();
  
      virtual char      **GetMetadataDomainList() override;
      virtual char        **GetMetadata( const char * pszDomain = "" ) override;
      static GDALDataset  *Open( GDALOpenInfo * );
      static int          Identify( GDALOpenInfo * );
  };
  
  char *SPrintArray( GDALDataType eDataType, const void *paDataArray,
                     int nValues, const char *pszDelimiter );
  
  #endif /* HDF4DATASET_H_INCLUDED_ */
  