ImHex/plugins/builtin/source/content/views/view_help.cpp

#include "content/views/view_help.hpp"

#include <hex/api/content_registry.hpp>

#include <hex/helpers/fmt.hpp>
#include <hex/helpers/logger.hpp>
#include <hex/helpers/fs.hpp>
#include <hex/helpers/utils.hpp>

#include <romfs/romfs.hpp>

namespace hex::plugin::builtin {

    ViewHelp::ViewHelp() : View("hex.builtin.view.help.about.name") {

        ContentRegistry::Interface::addMenuItem("hex.builtin.menu.help", 1000, [&, this] {
            if (ImGui::MenuItem("hex.builtin.view.help.about.name"_lang, "")) {
                ImHexApi::Tasks::doLater([] { ImGui::OpenPopup(View::toWindowName("hex.builtin.view.help.about.name").c_str()); });
                this->m_aboutWindowOpen    = true;
                this->getWindowOpenState() = true;
            }

            if (ImGui::MenuItem("hex.builtin.view.help.documentation"_lang, "")) {
                hex::openWebpage("https://imhex.werwolv.net/docs");
            }
        });
    }

    ViewHelp::~ViewHelp() {
        ImGui::UnloadImage(this->m_logoTexture);
    }

    static void link(const std::string &label, const std::string &url) {
        if (ImGui::BulletHyperlink(label.data()))
            hex::openWebpage(url);
    }

    void ViewHelp::drawAboutMainPage() {
        if (ImGui::BeginTable("about_table", 2, ImGuiTableFlags_SizingFixedFit)) {
            ImGui::TableNextRow();
            ImGui::TableNextColumn();

            if (!this->m_logoTexture.valid()) {
                auto logo           = romfs::get("logo.png");
                this->m_logoTexture = ImGui::LoadImageFromMemory(reinterpret_cast<const ImU8 *>(logo.data()), logo.size());
            }

            ImGui::Image(this->m_logoTexture.textureId, scaled(this->m_logoTexture.size()));
            ImGui::TableNextColumn();

            ImGui::TextFormatted("ImHex Hex Editor v{} by WerWolv - " ICON_FA_CODE_BRANCH, IMHEX_VERSION);

#if defined(GIT_BRANCH) && defined(GIT_COMMIT_HASH)
            ImGui::SameLine();
            if (ImGui::Hyperlink(hex::format("{0}@{1}", GIT_BRANCH, GIT_COMMIT_HASH).c_str()))
                hex::openWebpage("https://github.com/WerWolv/ImHex/commit/" GIT_COMMIT_HASH);
#endif

            ImGui::TextUnformatted("hex.builtin.view.help.about.translator"_lang);

            ImGui::TextUnformatted("hex.builtin.view.help.about.source"_lang);
            ImGui::SameLine();
            if (ImGui::Hyperlink("WerWolv/ImHex"))
                hex::openWebpage("https://github.com/WerWolv/ImHex");

            ImGui::EndTable();
        }

        ImGui::NewLine();

        ImGui::TextUnformatted("hex.builtin.view.help.about.donations"_lang);
        ImGui::Separator();

        constexpr const char *Links[] = { "https://werwolv.net/donate", "https://www.patreon.com/werwolv", "https://github.com/sponsors/WerWolv" };

        ImGui::TextFormattedWrapped("{}", static_cast<const char *>("hex.builtin.view.help.about.thanks"_lang));

        ImGui::NewLine();

        for (auto &link : Links) {
            if (ImGui::Hyperlink(link))
                hex::openWebpage(link);
        }
    }

    void ViewHelp::drawContributorPage() {
        link("Mary for porting ImHex to MacOS", "https://github.com/Thog");
        link("Roblabla for adding the MSI Windows installer", "https://github.com/roblabla");
        link("jam1garner for adding support for Rust plugins", "https://github.com/jam1garner");
    }

    void ViewHelp::drawLibraryCreditsPage() {
        ImGui::PushStyleColor(ImGuiCol_ChildBg, ImVec4(0.2F, 0.2F, 0.2F, 0.3F));

        link("ImGui by ocornut", "https://github.com/ocornut/imgui");
        link("imgui_club by ocornut", "https://github.com/ocornut/imgui_club");
        link("imnodes by Nelarius", "https://github.com/Nelarius/imnodes");
        link("ImGuiColorTextEdit by BalazsJako", "https://github.com/BalazsJako/ImGuiColorTextEdit");
        link("ImPlot by epezent", "https://github.com/epezent/implot");
        link("capstone by aquynh", "https://github.com/aquynh/capstone");
        link("JSON for Modern C++ by nlohmann", "https://github.com/nlohmann/json");
        link("YARA by VirusTotal", "https://github.com/VirusTotal/yara");
        link("Native File Dialog Extended by btzy and mlabbe", "https://github.com/btzy/nativefiledialog-extended");
        link("Native File Dialog Extended by btzy and mlabbe", "https://github.com/btzy/nativefiledialog-extended");
        ImGui::NewLine();
        link("GNU libmagic", "http://www.darwinsys.com/file/");
        link("GLFW3", "https://github.com/glfw/glfw");
        link("LLVM", "https://github.com/llvm/llvm-project");
        link("Python 3", "https://github.com/python/cpython");
        link("FreeType", "https://gitlab.freedesktop.org/freetype/freetype");
        link("Mbed TLS", "https://github.com/ARMmbed/mbedtls");

        ImGui::PopStyleColor();
    }

    void ViewHelp::drawPathsPage() {
        if (ImGui::BeginTable("##imhex_paths", 2, ImGuiTableFlags_ScrollY | ImGuiTableFlags_Borders | ImGuiTableFlags_RowBg | ImGuiTableFlags_SizingFixedFit)) {
            ImGui::TableSetupScrollFreeze(0, 1);
            ImGui::TableSetupColumn("Type");
            ImGui::TableSetupColumn("Paths");

            constexpr std::array<std::pair<const char *, fs::ImHexPath>, 8> PathTypes = {
                {{ "Resources", fs::ImHexPath::Resources },
                 { "Config", fs::ImHexPath::Config },
                 { "Magic", fs::ImHexPath::Magic },
                 { "Patterns", fs::ImHexPath::Patterns },
                 { "Patterns Includes", fs::ImHexPath::PatternsInclude },
                 { "Plugins", fs::ImHexPath::Plugins },
                 { "Python Scripts", fs::ImHexPath::Python },
                 { "Yara Patterns", fs::ImHexPath::Yara }}
            };

            ImGui::TableHeadersRow();
            for (const auto &[name, type] : PathTypes) {
                ImGui::TableNextRow();
                ImGui::TableNextColumn();
                ImGui::TextUnformatted(name);

                ImGui::TableNextColumn();
                for (auto &path : fs::getDefaultPaths(type))
                    ImGui::TextUnformatted(path.string().c_str());
            }

            ImGui::EndTable();
        }
    }

    void ViewHelp::drawLicensePage() {
        ImGui::TextFormattedWrapped("{}", romfs::get("LICENSE").string());
    }

    void ViewHelp::drawAboutPopup() {
        ImGui::SetNextWindowSize(scaled(ImVec2(600, 350)), ImGuiCond_Always);
        if (ImGui::BeginPopupModal(View::toWindowName("hex.builtin.view.help.about.name").c_str(), &this->m_aboutWindowOpen, ImGuiWindowFlags_NoResize)) {

            if (ImGui::IsKeyDown(ImGui::GetKeyIndex(ImGuiKey_Escape)))
                ImGui::CloseCurrentPopup();

            if (ImGui::BeginTabBar("about_tab_bar")) {

                if (ImGui::BeginTabItem("ImHex")) {
                    if (ImGui::BeginChild(1)) {
                        this->drawAboutMainPage();
                    }
                    ImGui::EndChild();
                    ImGui::EndTabItem();
                }

                if (ImGui::BeginTabItem("hex.builtin.view.help.about.contributor"_lang)) {
                    ImGui::NewLine();
                    if (ImGui::BeginChild(1)) {
                        this->drawContributorPage();
                    }
                    ImGui::EndChild();
                    ImGui::EndTabItem();
                }

                if (ImGui::BeginTabItem("hex.builtin.view.help.about.libs"_lang)) {
                    ImGui::NewLine();
                    if (ImGui::BeginChild(1)) {
                        this->drawLibraryCreditsPage();
                    }
                    ImGui::EndChild();
                    ImGui::EndTabItem();
                }

                if (ImGui::BeginTabItem("hex.builtin.view.help.about.paths"_lang)) {
                    ImGui::NewLine();
                    if (ImGui::BeginChild(1)) {
                        this->drawPathsPage();
                    }
                    ImGui::EndChild();
                    ImGui::EndTabItem();
                }

                if (ImGui::BeginTabItem("hex.builtin.view.help.about.license"_lang)) {
                    ImGui::NewLine();
                    if (ImGui::BeginChild(1)) {
                        this->drawLicensePage();
                    }
                    ImGui::EndChild();
                    ImGui::EndTabItem();
                }

                ImGui::EndTabBar();
            }

            ImGui::EndPopup();
        }
    }

    void ViewHelp::drawContent() {
        if (!this->m_aboutWindowOpen)
            this->getWindowOpenState() = false;

        this->drawAboutPopup();
    }

}