#pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include using ImGuiDataType = int; using ImGuiInputTextFlags = int; namespace pl { class Evaluator; } namespace hex { class View; class LanguageDefinition; namespace dp { class Node; } namespace prv { class Provider; } /* The Content Registry is the heart of all features in ImHex that are in some way extendable by Plugins. It allows you to add/register new content that will be picked up and used by the ImHex core or by other plugins when needed. */ namespace ContentRegistry { /* Settings Registry. Allows adding of new entries into the ImHex preferences window. */ namespace Settings { using Callback = std::function; struct Entry { std::string name; bool requiresRestart; Callback callback; }; struct Category { std::string name; size_t slot = 0; bool operator<(const Category &other) const { return name < other.name; } operator const std::string &() const { return name; } }; void load(); void store(); void add(const std::string &unlocalizedCategory, const std::string &unlocalizedName, i64 defaultValue, const Callback &callback, bool requiresRestart = false); void add(const std::string &unlocalizedCategory, const std::string &unlocalizedName, const std::string &defaultValue, const Callback &callback, bool requiresRestart = false); void add(const std::string &unlocalizedCategory, const std::string &unlocalizedName, const std::vector &defaultValue, const Callback &callback, bool requiresRestart = false); void addCategoryDescription(const std::string &unlocalizedCategory, const std::string &unlocalizedCategoryDescription); void write(const std::string &unlocalizedCategory, const std::string &unlocalizedName, i64 value); void write(const std::string &unlocalizedCategory, const std::string &unlocalizedName, const std::string &value); void write(const std::string &unlocalizedCategory, const std::string &unlocalizedName, const std::vector &value); i64 read(const std::string &unlocalizedCategory, const std::string &unlocalizedName, i64 defaultValue); std::string read(const std::string &unlocalizedCategory, const std::string &unlocalizedName, const std::string &defaultValue); std::vector read(const std::string &unlocalizedCategory, const std::string &unlocalizedName, const std::vector &defaultValue = {}); std::map> &getEntries(); std::map &getCategoryDescriptions(); nlohmann::json getSetting(const std::string &unlocalizedCategory, const std::string &unlocalizedName); nlohmann::json &getSettingsData(); } /* Command Palette Command Registry. Allows adding of new commands to the command palette */ namespace CommandPaletteCommands { enum class Type : u32 { SymbolCommand, KeywordCommand }; using DisplayCallback = std::function; using ExecuteCallback = std::function; struct Entry { Type type; std::string command; std::string unlocalizedDescription; DisplayCallback displayCallback; ExecuteCallback executeCallback; }; void add( Type type, const std::string &command, const std::string &unlocalizedDescription, const DisplayCallback &displayCallback, const ExecuteCallback &executeCallback = [](auto) {}); std::vector &getEntries(); } /* Pattern Language Function Registry. Allows adding of new functions that may be used inside the pattern language */ namespace PatternLanguage { namespace impl { struct FunctionDefinition { pl::api::Namespace ns; std::string name; pl::api::FunctionParameterCount parameterCount; pl::api::FunctionCallback callback; bool dangerous; }; } std::unique_ptr createDefaultRuntime(prv::Provider *provider); void addPragma(const std::string &name, const pl::api::PragmaHandler &handler); void addFunction(const pl::api::Namespace &ns, const std::string &name, pl::api::FunctionParameterCount parameterCount, const pl::api::FunctionCallback &func); void addDangerousFunction(const pl::api::Namespace &ns, const std::string &name, pl::api::FunctionParameterCount parameterCount, const pl::api::FunctionCallback &func); std::map &getPragmas(); std::vector &getFunctions(); } /* View Registry. Allows adding of new windows */ namespace Views { namespace impl { void add(View *view); } template T, typename... Args> void add(Args &&...args) { return impl::add(new T(std::forward(args)...)); } std::map &getEntries(); View *getViewByName(const std::string &unlocalizedName); } /* Tools Registry. Allows adding new entries to the tools window */ namespace Tools { namespace impl { using Callback = std::function; struct Entry { std::string name; Callback function; }; } void add(const std::string &unlocalizedName, const impl::Callback &function); std::vector &getEntries(); } /* Data Inspector Registry. Allows adding of new types to the data inspector */ namespace DataInspector { enum class NumberDisplayStyle { Decimal, Hexadecimal, Octal }; namespace impl { using DisplayFunction = std::function; using EditingFunction = std::function(std::string, std::endian)>; using GeneratorFunction = std::function &, std::endian, NumberDisplayStyle)>; struct Entry { std::string unlocalizedName; size_t requiredSize; impl::GeneratorFunction generatorFunction; std::optional editingFunction; }; } void add(const std::string &unlocalizedName, size_t requiredSize, impl::GeneratorFunction displayGeneratorFunction, std::optional editingFunction = std::nullopt); std::vector &getEntries(); } /* Data Processor Node Registry. Allows adding new processor nodes to be used in the data processor */ namespace DataProcessorNode { namespace impl { using CreatorFunction = std::function; struct Entry { std::string category; std::string name; CreatorFunction creatorFunction; }; void add(const Entry &entry); } template T, typename... Args> void add(const std::string &unlocalizedCategory, const std::string &unlocalizedName, Args &&...args) { add(impl::Entry { unlocalizedCategory.c_str(), unlocalizedName.c_str(), [=] { auto node = new T(std::forward(args)...); node->setUnlocalizedName(unlocalizedName); return node; } }); } void addSeparator(); std::vector &getEntries(); } /* Language Registry. Allows together with the LangEntry class and the _lang user defined literal to add new languages */ namespace Language { void registerLanguage(const std::string &name, const std::string &languageCode); void addLocalizations(const std::string &languageCode, const LanguageDefinition &definition); std::map &getLanguages(); std::map> &getLanguageDefinitions(); } /* Interface Registry. Allows adding new items to various interfaces */ namespace Interface { namespace impl { using DrawCallback = std::function; using LayoutFunction = std::function; using ClickCallback = std::function; struct Layout { std::string unlocalizedName; LayoutFunction callback; }; struct MainMenuItem { std::string unlocalizedName; }; struct MenuItem { std::string unlocalizedName; DrawCallback callback; }; struct SidebarItem { std::string icon; DrawCallback callback; }; struct TitleBarButton { std::string icon; std::string unlocalizedTooltip; ClickCallback callback; }; } void registerMainMenuItem(const std::string &unlocalizedName, u32 priority); void addMenuItem(const std::string &unlocalizedMainMenuName, u32 priority, const impl::DrawCallback &function); void addWelcomeScreenEntry(const impl::DrawCallback &function); void addFooterItem(const impl::DrawCallback &function); void addToolbarItem(const impl::DrawCallback &function); void addSidebarItem(const std::string &icon, const impl::DrawCallback &function); void addTitleBarButton(const std::string &icon, const std::string &unlocalizedTooltip, const impl::ClickCallback &function); void addLayout(const std::string &unlocalizedName, const impl::LayoutFunction &function); std::multimap &getMainMenuItems(); std::multimap &getMenuItems(); std::vector &getWelcomeScreenEntries(); std::vector &getFooterItems(); std::vector &getToolbarItems(); std::vector &getSidebarItems(); std::vector &getTitleBarButtons(); std::vector &getLayouts(); } /* Provider Registry. Allows adding new data providers to be created from the UI */ namespace Provider { namespace impl { void addProviderName(const std::string &unlocalizedName); } template T> void add(const std::string &unlocalizedName, bool addToList = true) { (void)EventManager::subscribe([expectedName = unlocalizedName](const std::string &name, hex::prv::Provider **provider) { if (name != expectedName) return; auto newProvider = new T(); hex::ImHexApi::Provider::add(newProvider); if (provider != nullptr) *provider = newProvider; }); if (addToList) impl::addProviderName(unlocalizedName); } std::vector &getEntries(); } namespace DataFormatter { namespace impl { using Callback = std::function; struct Entry { std::string unlocalizedName; Callback callback; }; } void add(const std::string &unlocalizedName, const impl::Callback &callback); std::vector &getEntries(); } namespace FileHandler { namespace impl { using Callback = std::function; struct Entry { std::vector extensions; Callback callback; }; } void add(const std::vector &extensions, const impl::Callback &callback); std::vector &getEntries(); } namespace HexEditor { class DataVisualizer { public: DataVisualizer(u16 bytesPerCell, u16 maxCharsPerCell) : m_bytesPerCell(bytesPerCell), m_maxCharsPerCell(maxCharsPerCell) {} virtual ~DataVisualizer() = default; virtual void draw(u64 address, const u8 *data, size_t size, bool upperCase) = 0; virtual bool drawEditing(u64 address, u8 *data, size_t size, bool upperCase, bool startedEditing) = 0; [[nodiscard]] u16 getBytesPerCell() const { return this->m_bytesPerCell; } [[nodiscard]] u16 getMaxCharsPerCell() const { return this->m_maxCharsPerCell; } protected: const static int TextInputFlags; bool drawDefaultEditingTextBox(u64 address, const char *format, ImGuiDataType dataType, u8 *data, ImGuiInputTextFlags flags) const; private: u16 m_bytesPerCell; u16 m_maxCharsPerCell; }; namespace impl { void addDataVisualizer(const std::string &unlocalizedName, DataVisualizer *visualizer); std::map &getVisualizers(); } template T, typename... Args> void addDataVisualizer(const std::string &unlocalizedName, Args &&...args) { return impl::addDataVisualizer(unlocalizedName, new T(std::forward(args)...)); } } }; }