1
0
mirror of https://github.com/vcmi/vcmi.git synced 2024-12-10 09:50:17 +02:00
vcmi/lib/VCMIDirs.h
2022-12-28 17:59:16 +02:00

77 lines
2.7 KiB
C++

/*
* VCMIDirs.h, part of VCMI engine
*
* Authors: listed in file AUTHORS in main folder
*
* License: GNU General Public License v2.0 or later
* Full text of license available in license.txt file, in main folder
*
*/
#pragma once
VCMI_LIB_NAMESPACE_BEGIN
class DLL_LINKAGE IVCMIDirs
{
public:
// Path to user-specific data directory
virtual boost::filesystem::path userDataPath() const = 0;
// Path to "cache" directory, can be used for any non-essential files
virtual boost::filesystem::path userCachePath() const = 0;
// Path to writeable directory with user configs
virtual boost::filesystem::path userConfigPath() const = 0;
// Path to writeable directory to store log files
virtual boost::filesystem::path userLogsPath() const;
// Path to saved games
virtual boost::filesystem::path userSavePath() const;
// Path to "extracted" directory, used to temporarily hold extracted Original H3 files
virtual boost::filesystem::path userExtractedPath() const;
// Paths to global system-wide data directories. First items have higher priority
virtual std::vector<boost::filesystem::path> dataPaths() const = 0;
// Full path to client executable, including name (e.g. /usr/bin/vcmiclient)
virtual boost::filesystem::path clientPath() const = 0;
// Full path to editor executable, including name (e.g. /usr/bin/vcmieditor)
virtual boost::filesystem::path mapEditorPath() const = 0;
// Full path to server executable, including name (e.g. /usr/bin/vcmiserver)
virtual boost::filesystem::path serverPath() const = 0;
// Path where vcmi libraries can be found (in AI and Scripting subdirectories)
virtual boost::filesystem::path libraryPath() const = 0;
// absolute path to passed library (needed due to android libs being placed in single dir, not respecting original lib dirs;
// by default just concats libraryPath, given folder and libraryName
virtual boost::filesystem::path fullLibraryPath(const std::string & desiredFolder,
const std::string & baseLibName) const;
// Path where vcmi binaries can be found
virtual boost::filesystem::path binaryPath() const = 0;
// Returns system-specific name for dynamic libraries ( StupidAI => "libStupidAI.so" or "StupidAI.dll")
virtual std::string libraryName(const std::string & basename) const = 0;
// virtual std::string libraryName(const char* basename) const = 0; ?
// virtual std::string libraryName(std::string&& basename) const = 0;?
virtual std::string genHelpString() const;
// Creates not existed, but required directories.
// Updates directories what change name/path between versions.
// Function called automatically.
virtual void init();
};
namespace VCMIDirs
{
extern DLL_LINKAGE const IVCMIDirs & get();
}
VCMI_LIB_NAMESPACE_END