ES-DE/es-core/src/ThemeData.h
2022-01-31 23:22:42 +01:00

262 lines
8.4 KiB
C++

// SPDX-License-Identifier: MIT
//
// EmulationStation Desktop Edition
// ThemeData.h
//
// Finds available themes on the file system and loads and parses these.
// Basic error checking for valid elements and data types is done here,
// with additional validation handled by the individual components.
//
#ifndef ES_CORE_THEME_DATA_H
#define ES_CORE_THEME_DATA_H
#include "utils/FileSystemUtil.h"
#include "utils/MathUtil.h"
#include <algorithm>
#include <any>
#include <deque>
#include <map>
#include <memory>
#include <sstream>
#include <vector>
namespace pugi
{
class xml_node;
}
class GuiComponent;
class ImageComponent;
class NinePatchComponent;
class Sound;
class TextComponent;
class Window;
namespace ThemeFlags
{
// clang-format off
// These are only the most common flags shared accross multiple components, in addition
// to these there are many component-specific options.
enum PropertyFlags : unsigned int {
PATH = 0x00000001,
POSITION = 0x00000002,
SIZE = 0x00000004,
ORIGIN = 0x00000008,
COLOR = 0x00000010,
FONT_PATH = 0x00000020,
FONT_SIZE = 0x00000040,
ALIGNMENT = 0x00000080,
TEXT = 0x00000100,
METADATA = 0x00000200,
FORCE_UPPERCASE = 0x00000400,
LINE_SPACING = 0x00000800,
DELAY = 0x00001000,
Z_INDEX = 0x00002000,
ROTATION = 0x00004000,
VISIBLE = 0x00008000,
ALL = 0xFFFFFFFF
};
// clang-format on
} // namespace ThemeFlags
class ThemeException : public std::exception
{
public:
std::string message;
const char* what() const throw() { return message.c_str(); }
template <typename T> friend ThemeException& operator<<(ThemeException& e, T message)
{
std::stringstream ss;
ss << e.message << message;
e.message = ss.str();
return e;
}
void setFiles(const std::deque<std::string>& deque)
{
// Add all paths to the error message, separated by -> so it's easy to read the log
// output in case of theme loading errors.
*this << "\"" << deque.front() << "\"";
for (auto it = deque.cbegin() + 1; it != deque.cend(); ++it)
*this << " -> \"" << (*it) << "\"";
}
};
class ThemeData
{
public:
class ThemeElement
{
public:
bool extra;
std::string type;
struct Property {
void operator=(const glm::vec4& value)
{
r = value;
const glm::vec4 initVector {value};
v = glm::vec2 {initVector.x, initVector.y};
}
void operator=(const glm::vec2& value) { v = value; }
void operator=(const std::string& value) { s = value; }
void operator=(const unsigned int& value) { i = value; }
void operator=(const float& value) { f = value; }
void operator=(const bool& value) { b = value; }
glm::vec4 r;
glm::vec2 v;
std::string s;
unsigned int i;
float f;
bool b;
};
std::map<std::string, Property> properties;
template <typename T> const T get(const std::string& prop) const
{
#if defined(LEGACY_MACOS)
if (std::is_same<T, glm::vec2>::value)
return *(const T*)&properties.at(prop).v;
else if (std::is_same<T, std::string>::value)
return *(const T*)&properties.at(prop).s;
else if (std::is_same<T, unsigned int>::value)
return *(const T*)&properties.at(prop).i;
else if (std::is_same<T, float>::value)
return *(const T*)&properties.at(prop).f;
else if (std::is_same<T, bool>::value)
return *(const T*)&properties.at(prop).b;
else if (std::is_same<T, glm::vec4>::value)
return *(const T*)&properties.at(prop).r;
return T();
#else
if (std::is_same<T, glm::vec2>::value)
return std::any_cast<const T>(properties.at(prop).v);
else if (std::is_same<T, std::string>::value)
return std::any_cast<const T>(properties.at(prop).s);
else if (std::is_same<T, unsigned int>::value)
return std::any_cast<const T>(properties.at(prop).i);
else if (std::is_same<T, float>::value)
return std::any_cast<const T>(properties.at(prop).f);
else if (std::is_same<T, bool>::value)
return std::any_cast<const T>(properties.at(prop).b);
else if (std::is_same<T, glm::vec4>::value)
return std::any_cast<const T>(properties.at(prop).r);
return T();
#endif
}
bool has(const std::string& prop) const
{
return (properties.find(prop) != properties.cend());
}
};
ThemeData();
class ThemeView
{
public:
std::map<std::string, ThemeElement> elements;
std::vector<std::string> legacyOrderedKeys;
};
struct ThemeVariant {
std::string name;
std::string label;
bool selectable;
bool override;
std::string overrideTrigger;
std::string overrideVariant;
};
struct ThemeCapability {
std::vector<ThemeVariant> variants;
std::vector<std::string> aspectRatios;
bool legacyTheme;
};
struct ThemeSet {
std::string path;
ThemeCapability capabilities;
std::string getName() const { return Utils::FileSystem::getStem(path); }
std::string getThemePath(const std::string& system) const
{
return path + "/" + system + "/theme.xml";
}
};
void loadFile(const std::map<std::string, std::string>& sysDataMap, const std::string& path);
bool hasView(const std::string& view);
ThemeView& getViewElements(std::string view) { return mViews[view]; }
static std::vector<GuiComponent*> makeExtras(const std::shared_ptr<ThemeData>& theme,
const std::string& view);
const ThemeElement* getElement(const std::string& view,
const std::string& element,
const std::string& expectedType) const;
const static std::map<std::string, ThemeSet>& getThemeSets();
const static std::string getThemeFromCurrentSet(const std::string& system);
const static std::string getAspectRatioLabel(const std::string& aspectRatio);
const bool isLegacyTheme() { return mLegacyTheme; }
enum ElementPropertyType {
NORMALIZED_RECT,
NORMALIZED_PAIR,
PATH,
STRING,
COLOR,
FLOAT,
BOOLEAN
};
std::map<std::string, std::string> mVariables;
private:
static const std::shared_ptr<ThemeData> getDefault();
unsigned int getHexColor(const std::string& str);
std::string resolvePlaceholders(const std::string& in);
static ThemeCapability parseThemeCapabilities(const std::string& path);
void parseIncludes(const pugi::xml_node& themeRoot);
void parseFeatures(const pugi::xml_node& themeRoot);
void parseVariants(const pugi::xml_node& themeRoot);
void parseAspectRatios(const pugi::xml_node& themeRoot);
void parseVariables(const pugi::xml_node& root);
void parseViews(const pugi::xml_node& themeRoot);
void parseView(const pugi::xml_node& viewNode, ThemeView& view);
void parseElement(const pugi::xml_node& elementNode,
const std::map<std::string, ElementPropertyType>& typeMap,
ThemeElement& element);
static std::map<std::string, std::map<std::string, ElementPropertyType>> sElementMap;
static std::map<std::string, std::map<std::string, std::string>> sPropertyAttributeMap;
static std::vector<std::string> sLegacySupportedFeatures;
static std::vector<std::string> sLegacySupportedViews;
static std::vector<std::string> sSupportedViews;
static std::vector<std::pair<std::string, std::string>> sSupportedAspectRatios;
static inline std::map<std::string, ThemeSet> mThemeSets;
std::map<std::string, ThemeData::ThemeSet>::iterator mCurrentThemeSet;
std::map<std::string, ThemeView> mViews;
std::deque<std::string> mPaths;
std::vector<std::string> mVariants;
std::string mSelectedVariant;
std::string mSelectedAspectRatio;
bool mLegacyTheme;
};
#endif // ES_CORE_THEME_DATA_H