ossimPreferences.h

Go to the documentation of this file.

//*******************************************************************
//
// License:  See top level LICENSE.txt file.
// 
// DESCRIPTION:
//   Contains declaration of class ossimPreferences. This class provides
//   a static keywordlist for global preferences. Objects needing access to
//   application-wide global parameters shall do so through this class.
//
// SOFTWARE HISTORY:
//>
//   23Apr2001  Oscar Kramer
//              Initial coding.
//<
//*****************************************************************************

#ifndef ossimPreferences_HEADER
#define ossimPreferences_HEADER

#include <ossim/base/ossimFilename.h>
#include <ossim/base/ossimKeywordlist.h>

/*!****************************************************************************
 *
 * CLASS:  ossimPreferences
 *
 *****************************************************************************/
class OSSIMDLLEXPORT ossimPreferences
{
public:
   // This is only here so we can swig wrap this.  The destructor should never be called directly.
   ~ossimPreferences();
   static ossimPreferences* instance();

   bool loadPreferences();
   bool loadPreferences(const ossimFilename& pathname);

   bool savePreferences() const;
   bool savePreferences(const ossimFilename& pathname);

   const char* findPreference(const char* key) const {return theKWL.find(key);}


   void addPreference(const char* key,
                      const char* value);

   const ossimKeywordlist& preferencesKWL() const { return theKWL; }
   
   ossimKeywordlist& preferencesKWL()  { return theKWL; }
   
   void addPreferences(const ossimKeywordlist& kwl,
                       const char* prefix=0,
                       bool stripPrefix=true);

   ossimFilename getPreferencesFilename() const;
   
protected:
   ossimPreferences();
   ossimPreferences(const ossimPreferences&) {}

   void operator = (const ossimPreferences&) const {}

   static ossimPreferences* theInstance;
   ossimKeywordlist         theKWL;
   ossimFilename            thePrefFilename;
   mutable bool             theInstanceIsModified;
};

#endif