1
0
mirror of synced 2024-12-05 12:37:57 +01:00
ImHex/source/views/view_help.cpp

301 lines
13 KiB
C++
Raw Normal View History

2020-11-14 21:16:03 +01:00
#include "views/view_help.hpp"
namespace hex {
ViewHelp::ViewHelp() : View("Help") {
this->getWindowOpenState() = true;
2020-11-14 21:16:03 +01:00
}
ViewHelp::~ViewHelp() {
}
static void drawTitle(const std::string &title) {
ImGui::TextColored(ImVec4(0.6F, 0.6F, 1.0F, 1.0F), title.c_str());
}
static void drawCodeSegment(const std::string &id, const std::string &code) {
ImGui::PushStyleColor(ImGuiCol_ChildBg, ImVec4(0.2F, 0.2F, 0.2F, 0.3F));
ImGui::BeginChild(id.c_str(), ImVec2(-1, ImGui::CalcTextSize(code.c_str()).y));
ImGui::Text("%s", code.c_str());
ImGui::EndChild();
ImGui::NewLine();
ImGui::PopStyleColor();
};
2020-11-14 21:16:03 +01:00
Proper DPI scaling and basic custom font (#85) * add glm to arch deps After running got `None of the required 'glm' found`. This fixes that * dist/fedora: Include file magic headers Due to differences in package names between Deb based systems, Arch Linux, and RPM based systems the package containing the development headers for file were missing from the Fedora dependencies script. This includes the package `file-devel`, which is the package which resolves the issue. In Fedora, one can identify the package providing a specific file using the verb "whatprovides" with the command dnf, e.g.: [~]$ dnf whatprovides /usr/include/magic.h Last metadata expiration check: 4 days, 0:23:05 ago on Fri 04 Dec 2020 09:06:53 AM PST. file-devel-5.39-3.fc33.i686 : Libraries and header files for file development Repo : fedora Matched from: Filename : /usr/include/magic.h file-devel-5.39-3.fc33.x86_64 : Libraries and header files for file development Repo : @System Matched from: Filename : /usr/include/magic.h file-devel-5.39-3.fc33.x86_64 : Libraries and header files for file development Repo : fedora Matched from: Filename : /usr/include/magic.h If one is unsure of the specific path, globbing may be used (but must be quoted): dnf whatprovides "*/magic.h" Resolves #48 * dist: Prevent already installed packages in ArchLinux and MSYS2. Use --needed option with pacman to prevent it. * Add script to install dependencies on Debian/Ubuntu. Tested with Xubuntu 20.04 and Debian testing (in today's Docker image bitnami/minideb). Update README.md. * ci: rework (#31) * Support non standard LLVM library names (#86) This fix openSUSE and Gentoo issue mentioned in https://github.com/WerWolv/ImHex/issues/37#issuecomment-739503138. (tested on openSUSE tumbleweed via Docker) I also took the liberty of renaming llvm_lib to llvm_demangle_lib to be more specific in the ``CMakeLists.txt``. * Implement proper DPI handling * Implement basic custom font support * Fix building on windows * Hopefully fix fonts on Windows * Fix several scaling issues * Replace font renderer with freetype * Updated CI and dependency scripts * Rebuild default font atlas * Correct platform detection macro for mingw * Fixed PKGBUILD Co-authored-by: brockelmore <31553173+brockelmore@users.noreply.github.com> Co-authored-by: Brian 'Redbeard' Harrington <redbeard@dead-city.org> Co-authored-by: Biswapriyo Nath <nathbappai@gmail.com> Co-authored-by: Stéphane Gourichon <stephane.gourichon@fidergo.fr> Co-authored-by: umarcor <38422348+umarcor@users.noreply.github.com> Co-authored-by: Mary <me@thog.eu> Co-authored-by: WerWolv <werwolv98@gmail.com>
2020-12-11 14:24:42 +01:00
void ViewHelp::drawAboutPopup() {
if (ImGui::BeginPopupModal("About", &this->m_aboutWindowOpen, ImGuiWindowFlags_AlwaysAutoResize)) {
2020-12-21 11:24:27 +01:00
ImGui::Text("ImHex Hex Editor v%s by WerWolv", IMHEX_VERSION);
ImGui::Text("%s@%s", GIT_BRANCH, GIT_COMMIT_HASH);
2020-11-14 21:16:03 +01:00
ImGui::NewLine();
2020-12-21 11:24:27 +01:00
ImGui::Text("Source code available on GitHub:"); ImGui::SameLine();
ImGui::TextColored(ImVec4(0.4F, 0.4F, 0.8F, 1.0F), "WerWolv/ImHex ");
2020-11-14 21:16:03 +01:00
ImGui::NewLine();
ImGui::Text("Libraries used");
2020-12-21 11:24:27 +01:00
ImGui::Separator();
2020-11-14 21:16:03 +01:00
ImGui::PushStyleColor(ImGuiCol_ChildBg, ImVec4(0.2F, 0.2F, 0.2F, 0.3F));
ImGui::BulletText("ImGui by ocornut");
ImGui::BulletText("imgui_club by ocornut");
2020-11-17 15:38:42 +01:00
ImGui::BulletText("ImGui-Addons by gallickgunner");
ImGui::BulletText("ImGuiColorTextEdit by BalazsJako");
ImGui::BulletText("capstone by aquynh");
ImGui::BulletText("JSON for Modern C++ by nlohmann");
2020-11-14 21:16:03 +01:00
ImGui::NewLine();
ImGui::BulletText("GNU libmagic");
ImGui::BulletText("OpenSSL libcrypto");
ImGui::BulletText("GLFW3");
ImGui::BulletText("LLVM");
ImGui::BulletText("Python 3");
2020-12-21 11:24:27 +01:00
ImGui::BulletText("FreeType");
2020-11-14 21:16:03 +01:00
ImGui::PopStyleColor();
ImGui::EndPopup();
}
}
void ViewHelp::drawPatternHelpPopup() {
if (!this->m_patternHelpWindowOpen) return;
2020-11-14 21:16:03 +01:00
ImGui::SetNextWindowSizeConstraints(ImVec2(450, 300), ImVec2(2000, 1000));
if (ImGui::Begin("Pattern Language Cheat Sheet", &this->m_patternHelpWindowOpen)) {
2020-11-14 21:16:03 +01:00
ImGui::Text("ImHex Pattern Language Cheat Sheet");
ImGui::Separator();
ImGui::NewLine();
drawTitle("Preprocessor directives");
2020-11-17 13:59:16 +01:00
ImGui::TextWrapped(
"Preprocessor directives can be used to alter the code before it's being parsed. Supported are "
"#define to replace one string with another and #include to include a separate file");
drawCodeSegment("preprocessor",
2020-11-17 13:59:16 +01:00
"#define HEADER_OFFSET 0x100\n"
"#include <cstdint.hexpat>\n"
"#include \"mypattern.hexpat\""
);
drawTitle("Pragma directives");
2020-11-22 11:20:01 +01:00
ImGui::TextWrapped(
"Pragma directives are used to give ImHex additional information about the code being read. Currently "
"the following directives are supported.");
drawCodeSegment("pragma",
"// Allow this file to be loaded as pattern when a file\n"
"// identified as application/x-executable gets loaded\n"
2020-11-22 11:20:01 +01:00
"#pragma MIME application/x-executable\n"
);
drawTitle("Built-in types");
2020-11-14 21:16:03 +01:00
ImGui::TextWrapped(
"The following built-in types are available for use");
drawCodeSegment("built-in",
2020-11-14 21:16:03 +01:00
"u8, s8\n"
"u16, s16\n"
"u32, s32\n"
"u64, s64\n"
"u128, s128\n"
"float, double"
);
drawTitle("Variables and Arrays");
2020-11-14 21:16:03 +01:00
ImGui::TextWrapped(
2020-11-22 11:20:01 +01:00
"Normal variables as well as arrays are used to highlight and display values. "
"It is possible to create arrays within structs and unions that use the value of a previously "
"declared variable as size. In order to override the native / globally set endianess setting, every "
"type in a variable declaration may be prefixed with be or le to turn only it into a big or little endian type.");
drawCodeSegment("vars arrays",
2020-11-14 21:16:03 +01:00
"u32 variable;\n"
2020-11-22 11:20:01 +01:00
"s8 string[16];\n"
"u8 customSizedArray[variable];\n"
"be u32 bigEndianVariable;"
2020-11-14 21:16:03 +01:00
);
drawTitle("Structs");
2020-11-14 21:16:03 +01:00
ImGui::TextWrapped(
"To bundle multiple variables together, a struct can be used. To insert padding bytes which won't show "
"up in the pattern data view or be highlighted, use the padding[size] syntax.");
drawCodeSegment("struct",
2020-11-14 21:16:03 +01:00
"struct Header {\n"
" u32 magic;\n"
" u8 version;\n"
" padding[4];\n"
2020-11-14 21:16:03 +01:00
" Flags flags;\n"
2020-11-22 11:20:01 +01:00
"};"
2020-11-14 21:16:03 +01:00
);
drawTitle("Unions");
ImGui::TextWrapped(
"A union is used to make two or more variables occupy the same region of memory. "
"The union will have the size of the biggest contained variable.");
drawCodeSegment("union",
"union Color {\n"
" u32 rgba;\n"
" Components components;\n"
2020-11-22 11:20:01 +01:00
"};"
);
drawTitle("Pointers");
2020-11-22 11:20:01 +01:00
ImGui::TextWrapped(
"\"Another possible type of member in structs and unions are pointers. They are variables"
"whose value is used as an offset from the start of the file to locate the actual offset. "
"The leading type is treated as the data being pointed to and the trailing type as the size of the pointer.");
drawCodeSegment("pointer",
2020-11-22 11:20:01 +01:00
"Data *data : u16;"
);
drawTitle("Bitfields");
ImGui::TextWrapped(
"To decode values that are stored in fields that don't follow the typical 8 bit alignment, bitfields can be used. "
"The size of these fields get specified in numbers of bits.");
drawCodeSegment("bitfield",
"bitfield Permission {\n"
" r : 1;\n"
" w : 1;\n"
" x : 1;\n"
2020-11-22 11:20:01 +01:00
"};"
);
drawTitle("Enum");
2020-11-14 21:16:03 +01:00
ImGui::TextWrapped(
"If a value can only be a few specific values with special meaning, an enum can be used. "
"The underlying type has to be specified using a unsigned, built-in type after the name. "
"Entries can be listed with or without a value. The values start counting at zero and increase by one "
"for every next entry");
drawCodeSegment("enum",
2020-11-14 21:16:03 +01:00
"enum OperatingSystem : u8 {\n"
" Windows = 0x10,\n"
" MacOSX,\n"
" Linux = 'L'\n"
2020-11-22 11:20:01 +01:00
"};"
2020-11-14 21:16:03 +01:00
);
drawTitle("Using declarations");
2020-11-14 21:16:03 +01:00
ImGui::TextWrapped(
"A using declaration can be used to create type aliases for already existing types. This can be "
"a built-in type, a struct, enum or another alias type.");
drawCodeSegment("using",
2020-11-14 21:16:03 +01:00
"using magic_t = u32;"
);
drawTitle("Comments");
2020-11-14 21:16:03 +01:00
ImGui::TextWrapped(
"To create a comment the C // or /* */ syntax can be used. //-style comments end at the next new line "
"and /*-style comments only end when at the next */.");
drawCodeSegment("comment",
2020-11-14 21:16:03 +01:00
"// This is a single line comment\n\n"
"/* This is a\n"
"multiline comment */"
);
drawTitle("Variable placement");
2020-11-14 21:16:03 +01:00
ImGui::TextWrapped(
"In order to highlight bytes and displaying their value in the pattern data window, "
"a variable needs to be created and placed in memory. The following line of code creates"
"a unsigned 32 bit variable named data and places it at offset 0x100."
);
drawCodeSegment("var placement", "u32 data @ 0x100;");
}
ImGui::End();
}
void ViewHelp::drawMathEvaluatorHelp() {
if (!this->m_mathHelpWindowOpen) return;
ImGui::SetNextWindowSizeConstraints(ImVec2(450, 300), ImVec2(2000, 1000));
if (ImGui::Begin("Calculator Cheat Sheet", &this->m_mathHelpWindowOpen)) {
ImGui::Text("ImHex Math Evaluator Cheat Sheet");
ImGui::Separator();
ImGui::NewLine();
ImGui::TextWrapped("ImGui has a simple math evaluator / calculator built-in. It works by parsing the "
"expressions passed to it and displaying the result in the History table.");
ImGui::NewLine();
drawTitle("Basic Operators");
ImGui::TextWrapped(
"The following basic mathematical operators are supported");
drawCodeSegment("basicOperators",
"+ : Addition\n"
"- : Subtraction\n"
"* : Multiplication\n"
"/ : Division\n"
"% : Modulus\n"
"** : Exponentiation\n"
"() : Brackets\n"
"x = : Variable assignment");
drawTitle("Bitwise Operators");
ImGui::TextWrapped(
"The following bitwise operators are supported");
drawCodeSegment("bitwiseOperators",
"& : Bitwise AND\n"
"| : Bitwise OR\n"
"^ : Bitwise XOR\n"
"~ : Bitwise NOT\n"
"<< : Logical shift left\n"
">> : Logical shift right\n"
"## : Bitwise concatenation");
drawTitle("Boolean Operators");
ImGui::TextWrapped(
"The following bitwise operators are supported");
drawCodeSegment("booleanOperators",
"&& : Boolean AND\n"
"|| : Boolean OR\n"
"^^ : Boolean XOR\n"
"! : Boolean NOT\n"
"== : Equality comparison\n"
"!= : Inequality comparison\n"
"> : Greater than comparison\n"
"< : Less than comparison\n"
">= : Greater than or equals comparison\n"
"<= : Less than or equals comparison");
drawTitle("Built-in Functions");
ImGui::TextWrapped(
"The following functions are built into the evaluator");
drawCodeSegment("functions",
"sin(x) : Sine function\n"
"cos(x) : Cosine function\n"
"tan(x) : Tangent function\n"
"ceil(x) : Rounds value to next bigger integer\n"
"floor(x) : Rounds value to next smaller integer\n"
"sign(x) : Returns the value's sign\n"
"abs(x) : Absolute value\n"
"ln(x) : Natural Logarithm\n"
"lb(x) : Logarithm with base 2\n"
"log(x, b) : Logarithm with custom base. Defaults to base 10\n"
"clear() : Clear History and variables\n"
"read(a) : Read 1 byte from loaded data\n"
"write(a, x) : Write 1 byte to loaded data");
2020-11-14 21:16:03 +01:00
}
ImGui::End();
2020-11-14 21:16:03 +01:00
}
void ViewHelp::drawContent() {
2020-11-17 13:59:16 +01:00
this->drawAboutPopup();
this->drawPatternHelpPopup();
this->drawMathEvaluatorHelp();
2020-11-14 21:16:03 +01:00
}
void ViewHelp::drawMenu() {
2020-11-14 21:16:03 +01:00
if (ImGui::BeginMenu("Help")) {
if (ImGui::MenuItem("About", "")) {
View::doLater([] { ImGui::OpenPopup("About"); });
this->m_aboutWindowOpen = true;
}
2020-11-14 21:16:03 +01:00
ImGui::Separator();
if (ImGui::MenuItem("Pattern Language Cheat Sheet", "")) {
this->m_patternHelpWindowOpen = true;
}
if (ImGui::MenuItem("Calculator Cheat Sheet", "")) {
this->m_mathHelpWindowOpen = true;
}
2020-11-14 21:16:03 +01:00
ImGui::EndMenu();
}
}
}