102 lines
2.9 KiB
C++
102 lines
2.9 KiB
C++
/* SPDX-FileCopyrightText: 2009 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup GHOST
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <optional>
|
|
#include <string>
|
|
|
|
#include "GHOST_Types.hh"
|
|
|
|
class GHOST_ISystemPaths {
|
|
public:
|
|
/**
|
|
* Creates the one and only system.
|
|
* \return An indication of success.
|
|
*/
|
|
static GHOST_TSuccess create();
|
|
|
|
/**
|
|
* Disposes the one and only system.
|
|
* \return An indication of success.
|
|
*/
|
|
static GHOST_TSuccess dispose();
|
|
|
|
/**
|
|
* Returns a pointer to the one and only system.
|
|
* \return A pointer to the system.
|
|
*/
|
|
static GHOST_ISystemPaths *get();
|
|
|
|
protected:
|
|
/**
|
|
* Constructor.
|
|
* Protected default constructor to force use of static createSystem member.
|
|
*/
|
|
GHOST_ISystemPaths() {}
|
|
|
|
/**
|
|
* Destructor.
|
|
* Protected default constructor to force use of static dispose member.
|
|
*/
|
|
virtual ~GHOST_ISystemPaths() = default;
|
|
|
|
public:
|
|
/**
|
|
* Determine the base directory in which shared resources are located. It will first try to use
|
|
* "unpack and run" path, then look for properly installed path, including versioning.
|
|
* \return Unsigned char string pointing to system directory (eg `/usr/share/blender/`).
|
|
*/
|
|
virtual const char *getSystemDir(int version, const char *versionstr) const = 0;
|
|
|
|
/**
|
|
* The base directory where architecture-dependent files are located,
|
|
* mirroring #getSystemDir under the install lib tree (eg `/usr/lib/blender/`).
|
|
*
|
|
* \return String pointing to the system libraries directory,
|
|
* or null when this build has no separate system library directory.
|
|
*
|
|
* For portable builds this function always returns null, for specific details
|
|
* see CMake's `BLENDER_INSTALL_LIBDIR` define for when this is/isn't used and why.
|
|
*/
|
|
virtual const char *getSystemLibsDir(int /*version*/, const char * /*versionstr*/) const
|
|
{
|
|
return nullptr;
|
|
}
|
|
|
|
/**
|
|
* Determine the base directory in which user configuration is stored, including versioning.
|
|
* If needed, it will create the base directory.
|
|
* \return Unsigned char string pointing to user directory (eg `~/.blender/`).
|
|
*/
|
|
virtual const char *getUserDir(int version, const char *versionstr) const = 0;
|
|
|
|
/**
|
|
* Determine a special ("well known") and easy to reach user directory.
|
|
* \return If successfull, a string containing the user directory path (eg `~/Documents/`).
|
|
*/
|
|
virtual std::optional<std::string> getUserSpecialDir(GHOST_TUserSpecialDirTypes type) const = 0;
|
|
|
|
/**
|
|
* Determine the directory of the current binary
|
|
* \return Unsigned char string pointing to the binary directory.
|
|
*/
|
|
virtual const char *getBinaryDir() const = 0;
|
|
|
|
/**
|
|
* Add the file to the operating system most recently used files
|
|
*/
|
|
virtual void addToSystemRecentFiles(const char *filepath) const = 0;
|
|
|
|
private:
|
|
/** The one and only system paths. */
|
|
static GHOST_ISystemPaths *system_paths_;
|
|
|
|
MEM_CXX_CLASS_ALLOC_FUNCS("GHOST:GHOST_ISystemPaths")
|
|
};
|