mdal_driver.hpp

/*
 MDAL - Mesh Data Abstraction Library (MIT License)
 Copyright (C) 2018 Peter Petrik (zilolv at gmail dot com)
*/
 
#ifndef MDAL_DRIVER_HPP
#define MDAL_DRIVER_HPP
 
#include <string>
#include "mdal_data_model.hpp"
#include "mdal.h"
 
namespace MDAL
{
  enum Capability
  {
    None                      = 0,
    ReadMesh                  = 1 << 0, 
    SaveMesh                  = 1 << 1, 
    ReadDatasets              = 1 << 2, 
    WriteDatasetsOnVertices   = 1 << 3, 
    WriteDatasetsOnFaces      = 1 << 4, 
    WriteDatasetsOnVolumes    = 1 << 5, 
    WriteDatasetsOnEdges      = 1 << 6, 
  };
 
  class Driver
  {
    public:
      Driver( const std::string &name,
              const std::string &longName,
              const std::string &filters,
              int capabilityFlags
            );
      virtual ~Driver();
 
      virtual Driver *create() = 0;
 
      std::string name() const;
      std::string longName() const;
      std::string filters() const;
      bool hasCapability( Capability capability ) const;
      bool hasWriteDatasetCapability( MDAL_DataLocation location ) const;
 
      virtual std::string writeDatasetOnFileSuffix() const;
      virtual std::string saveMeshOnFileSuffix() const;
 
      virtual bool canReadMesh( const std::string &uri );
      virtual bool canReadDatasets( const std::string &uri );
 
      virtual int faceVerticesMaximumCount() const;
 
      // constructs loading uri / uris
      virtual std::string buildUri( const std::string &meshFile );
      // loads mesh
      virtual std::unique_ptr< Mesh > load( const std::string &uri, const std::string &meshName = "" );
      // loads datasets
      virtual void load( const std::string &uri, Mesh *mesh );
      // save mesh
      virtual void save( const std::string &fileName, const std::string &meshName, Mesh *mesh );
 
      // create new dataset group
      virtual void createDatasetGroup(
        Mesh *mesh,
        const std::string &groupName,
        MDAL_DataLocation dataLocation,
        bool hasScalarData,
        const std::string &datasetGroupFile );
 
      // create new 2D dataset from array
      virtual void createDataset( DatasetGroup *group,
                                  RelativeTimestamp time,
                                  const double *values,
                                  const int *active );
 
      // create new 3D dataset from array
      virtual void createDataset( DatasetGroup *group,
                                  RelativeTimestamp time,
                                  const double *values,
                                  const int *verticalLevelCount,
                                  const double *verticalExtrusion );
 
      // persist to the file
      // returns true on error, false on success
      virtual bool persist( DatasetGroup *group );
 
    private:
      std::string mName;
      std::string mLongName;
      std::string mFilters;
      int mCapabilityFlags;
  };
 
} // namespace MDAL
#endif //MDAL_DRIVER_HPP