diff --git a/docs/book/_sources/doc_api.md b/docs/book/_sources/doc_api.md index 884d93e9..326b2280 100644 --- a/docs/book/_sources/doc_api.md +++ b/docs/book/_sources/doc_api.md @@ -61,11 +61,7 @@ float EmSize(float nbLines); See [hello_imgui_font.h](https://github.com/pthom/hello_imgui/blob/master/src/hello_imgui/hello_imgui_font.h). ```cpp // - // When loading fonts, use HelloImGui::LoadFont(FontLoadingParams) - // =============================================================== - // instead of ImGui::GetIO().Fonts->AddFontFromFileTTF(), because it will - // automatically adjust the font size to account for HighDPI, and will spare - // you headaches when trying to get consistent font size across different OSes. + // When loading fonts, use HelloImGui::LoadFont(fontFilename, fontSize, fontLoadingParams) // // Font loading parameters: several options are available (color, merging, range, ...) struct FontLoadingParams @@ -107,7 +103,12 @@ See [hello_imgui_font.h](https://github.com/pthom/hello_imgui/blob/master/src/he ImFontConfig fontConfigFontAwesome = ImFontConfig(); }; - // Generic font loading function, with many options: + // When loading fonts, use HelloImGui::LoadFont(FontLoadingParams) + // =============================================================== + // instead of ImGui::GetIO().Fonts->AddFontFromFileTTF(), because it will + // automatically adjust the font size to account for HighDPI, and will spare + // you headaches when trying to get consistent font size across different OSes. + // // see FontLoadingParams and ImFontConfig ImFont* LoadFont(const std::string & fontFilename, float fontSize, const FontLoadingParams & params = {}); diff --git a/docs/book/doc_api.html b/docs/book/doc_api.html index fe1a4934..2cf10f8d 100644 --- a/docs/book/doc_api.html +++ b/docs/book/doc_api.html @@ -477,11 +477,7 @@

Place widgets in a DPI-aware way#

See hello_imgui_font.h.

    //
-    // When loading fonts, use HelloImGui::LoadFont(FontLoadingParams)
-    // ===============================================================
-    // instead of ImGui::GetIO().Fonts->AddFontFromFileTTF(), because it will
-    // automatically adjust the font size to account for HighDPI, and will spare
-    // you headaches when trying to get consistent font size across different OSes.
+    // When loading fonts, use HelloImGui::LoadFont(fontFilename, fontSize, fontLoadingParams)
     //
     // Font loading parameters: several options are available (color, merging, range, ...)
     struct FontLoadingParams
@@ -523,7 +519,12 @@ 
Load fonts        ImFontConfig fontConfigFontAwesome = ImFontConfig();
     };
 
-    // Generic font loading function, with many options:
+    // When loading fonts, use HelloImGui::LoadFont(FontLoadingParams)
+    // ===============================================================
+    // instead of ImGui::GetIO().Fonts->AddFontFromFileTTF(), because it will
+    // automatically adjust the font size to account for HighDPI, and will spare
+    // you headaches when trying to get consistent font size across different OSes.
+    //
     // see FontLoadingParams and ImFontConfig
     ImFont* LoadFont(const std::string & fontFilename, float fontSize,
                      const FontLoadingParams & params = {});
diff --git a/docs/book/searchindex.js b/docs/book/searchindex.js
index 11bc5e2d..bf4f1a6a 100644
--- a/docs/book/searchindex.js
+++ b/docs/book/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["00_00_intro", "05_05_get_started", "60_05_build", "doc_api", "doc_params"], "filenames": ["00_00_intro.md", "05_05_get_started.md", "60_05_build.md", "doc_api.md", "doc_params.md"], "titles": ["Hello ImGui", "Get started", "Build instructions", "API", "Application parameters"], "terms": {"librari": [0, 1, 2, 4], "enabl": [0, 2, 3, 4], "quickli": [0, 4], "write": [0, 2], "multiplatform": [0, 1], "simplic": 0, "although": [0, 2, 3], "being": [0, 4], "extrem": [0, 3], "easi": [0, 2, 3, 4], "us": [0, 1, 3, 4], "can": [0, 1, 2, 3, 4], "creat": [0, 4], "complex": 0, "customiz": [0, 3], "applic": [0, 1], "It": [0, 1, 4], "base": [0, 1, 4], "util": 0, "truli": 0, "linux": [0, 2, 3, 4], "window": [0, 1, 3], "maco": [0, 1, 3, 4], "io": [0, 1, 3, 4], "android": [0, 1, 3, 4], "emscripten": [0, 1, 3, 4], "4": [0, 4], "line": [0, 1, 2, 3], "cmake": 0, "code": [0, 1, 2, 4], "easili": 0, "emb": [0, 1], "asset": [0, 4], "all": [0, 1, 2, 3, 4], "platform": [0, 1, 2, 3, 4], "requir": [0, 1, 3, 4], "set": [0, 1, 2, 4], "icon": [0, 1, 3], "name": [0, 1, 3, 4], "mobil": [0, 1, 4], "etc": [0, 1, 4], "includ": [0, 1, 3, 4], "power": 0, "save": [0, 3, 4], "mode": [0, 4], "reduc": [0, 4], "fp": [0, 3], "when": [0, 3, 4], "idl": 0, "high": [0, 4], "dpi": [0, 4], "support": [0, 4], "scale": 0, "ui": 0, "accord": 0, "whatev": 0, "handl": [0, 1, 4], "dockabl": 0, "multipl": [0, 2, 3, 4], "geometri": [0, 4], "autos": 0, "restor": [0, 4], "posit": [0, 4], "extens": 0, "list": [0, 4], "addit": [0, 1, 3, 4], "movabl": [0, 4], "resiz": [0, 3, 4], "borderless": [0, 4], "font": [0, 1, 2, 4], "emoji": 0, "color": [0, 3, 4], "integr": 0, "test": [0, 2, 3, 4], "engin": [0, 2, 3, 4], "autom": [0, 4], "your": [0, 1, 3, 4], "user": [0, 2, 4], "open": [0, 2, 4], "defin": [0, 2, 4], "add": [0, 1, 4], "backend": [0, 3], "avail": [0, 3, 4], "sdl2": [0, 2], "glfw3": [0, 2], "render": [0, 2, 4], "opengl3": [0, 2], "metal": [0, 2, 4], "vulkan": [0, 2, 4], "directx": [0, 2, 4], "The": [0, 1, 2, 3, 4], "dock": 0, "show": [0, 1, 4], "how": [0, 1, 4], "store": [0, 4], "cpu": [0, 4], "usag": [0, 1, 3], "load": [0, 4], "much": 0, "more": [0, 3], "onlin": 0, "sourc": [0, 4], "video": [0, 4], "tutori": 0, "an": [0, 1, 2, 3, 4], "interact": [0, 1, 4], "built": [0, 1, 2], "simpl": [0, 1, 2, 3], "demonstr": 0, "get": [0, 2], "you": [0, 1, 2, 3, 4], "start": [0, 4], "5": [0, 1, 3, 4], "minut": [0, 1, 4], "full": [0, 3], "fledg": 0, "top": [0, 4], "provid": [0, 1, 2, 3, 4], "lot": [0, 4], "widget": [0, 1, 4], "implot": 0, "node": 0, "editor": [0, 4], "imfiledialog": 0, "imguicolortextedit": 0, "imgui_md": 0, "well": 0, "complet": 0, "python": [0, 2], "bind": [0, 2], "c": [0, 1, 2], "minimum": 1, "develop": 1, "should": [1, 3, 4], "minim": [1, 4], "here": [1, 4], "hello": [1, 4], "world": [1, 4], "7": 1, "6": 1, "hello_imgui": [1, 2, 3, 4], "h": [1, 2, 3, 4], "int": [1, 2, 4], "main": [1, 2, 3, 4], "char": [1, 2, 3], "helloimgui": [1, 3, 4], "run": [1, 2, 4], "imgui": [1, 3], "text": [1, 2, 3, 4], "true": [1, 3, 4], "titl": [1, 4], "size": [1, 3, 4], "auto": [1, 4], "1": [1, 3, 4], "hello_world": 1, "cpp": [1, 2, 3], "recommend": [1, 2], "point": [1, 4], "own": [1, 2, 4], "project": [1, 2], "With": [1, 4], "thi": [1, 2, 3, 4], "do": [1, 2, 3, 4], "need": [1, 2, 3, 4], "clone": [1, 2], "option": [1, 3, 4], "download": [1, 2], "automat": [1, 2, 3, 4], "dure": [1, 4], "configur": 1, "time": [1, 2, 4], "see": [1, 2, 3, 4], "extract": [1, 2], "from": [1, 2, 4], "cmakelist": [1, 2, 3], "txt": [1, 2, 3], "file": [1, 2], "build": 1, "ad": [1, 2, 4], "subfold": [1, 4], "add_subdirectori": [1, 2], "extern": [1, 2], "2": [1, 4], "simpli": 1, "fetch": 1, "NOT": 1, "target": [1, 2, 4], "messag": 1, "statu": [1, 4], "fetchcont": 1, "fetchcontent_declar": 1, "git_repositori": 1, "http": [1, 2], "github": [1, 2], "com": [1, 2], "pthom": [1, 2], "git": [1, 2], "git_tag": 1, "master": 1, "fetchcontent_makeavail": 1, "endif": [1, 2], "helper": [1, 4], "function": [1, 2, 3, 4], "similar": 1, "s": [1, 3, 4], "add_execut": 1, "app_nam": 1, "file1": 1, "file2": 1, "Or": 1, "assets_loc": 1, "path": [1, 2, 4], "By": [1, 3, 4], "default": [1, 2, 3], "which": [1, 2, 3, 4], "mean": [1, 3], "search": 1, "folder": [1, 2, 4], "rel": [1, 3, 4], "locat": [1, 2, 4], "featur": 1, "link": [1, 2], "opengl": [1, 2, 4], "glad": 1, "desktop": [1, 4], "perform": 1, "anyth": 1, "besid": 1, "bundl": [1, 2, 3], "togeth": [1, 4], "app_set": 1, "gener": [1, 3], "jpg": [1, 3], "A": [1, 4], "ani": [1, 2, 4], "deploi": 1, "droidsan": 1, "ttf": 1, "fontawesom": [1, 3], "webfont": 1, "found": [1, 2, 4], "png": [1, 4], "squar": 1, "least": [1, 2], "256x256": 1, "convert": 1, "right": [1, 4], "format": 1, "each": [1, 4], "except": [1, 2, 3, 4], "appl": [1, 2], "info": 1, "plist": 1, "resourc": 1, "specif": [1, 4], "storyboard": 1, "launchscreen": 1, "place": [1, 2, 4], "androidmanifest": 1, "xml": 1, "manifest": 1, "one": [1, 2, 3, 4], "miss": 1, "re": 1, "mipmap": 1, "xxxhdpi": 1, "differ": [1, 4], "resolut": [1, 3, 4], "studio": 1, "them": [1, 2, 3, 4], "click": 1, "new": [1, 4], "imag": 1, "shell": 1, "html": 1, "favicon": 1, "js": [1, 2], "dear": [1, 4], "program": 1, "exampl": [1, 2, 3], "displai": [1, 4], "button": [1, 3, 4], "event": [1, 4], "guifunct": [1, 3, 4], "label": [1, 4], "imagefromasset": [1, 3], "static": [1, 2, 3], "bye": 1, "its": [1, 4], "action": 1, "getrunnerparam": [1, 3, 4], "appshallexit": [1, 4], "globe": 1, "return": [1, 3, 4], "0": [1, 3, 4], "manual": [1, 4], "great": 1, "learn": 1, "about": [1, 3, 4], "On": [2, 3], "almost": [2, 3], "compil": [2, 4], "command": [2, 4], "bash": 2, "cd": 2, "mkdir": 2, "make": [2, 3, 4], "j": 2, "bin": 2, "To": 2, "either": [2, 4], "insid": [2, 3, 4], "submodul": 2, "In": [2, 3, 4], "case": [2, 3, 4], "follow": 2, "given": [2, 3, 4], "starter": 2, "templat": 2, "document": [2, 4], "below": [2, 4], "combin": 2, "If": [2, 3, 4], "specifi": [2, 3, 4], "helloimgui_use_glfw_opengl3": 2, "helloimgui_use_sdl_opengl3": 2, "note": [2, 3, 4], "onli": [2, 3, 4], "mai": [2, 3, 4], "select": [2, 4], "both": [2, 4], "sdl": [2, 3, 4], "ar": [2, 3, 4], "easier": 2, "especi": 2, "beginn": 2, "standard": [2, 3, 4], "off": 2, "advanc": [2, 3, 4], "experienc": 2, "directx11": 2, "work": [2, 3, 4], "custom": [2, 4], "src": [2, 4], "intern": [2, 3, 4], "backend_impl": [2, 4], "rendering_xxxx": 2, "those": 2, "probabl": 2, "impli": 2, "want": [2, 4], "heavili": 2, "helloimgui_use_glfw_met": 2, "helloimgui_use_sdl_met": 2, "helloimgui_use_glfw_vulkan": 2, "helloimgui_use_sdl_vulkan": 2, "11": 2, "known": 2, "issu": 2, "rendering_dx11": [2, 4], "helloimgui_use_sdl_directx11": 2, "helloimgui_use_glfw_directx11": 2, "experiment": 2, "directx12": 2, "wa": [2, 3, 4], "doe": 2, "helloimgui_use_sdl_directx12": 2, "order": [2, 3, 4], "afor": 2, "mention": [2, 4], "ON": [2, 4], "freetyp": [2, 3], "helloimgui_use_freetyp": 2, "version": [2, 3], "conveni": [2, 3], "disabl": [2, 4], "prefer": [2, 3, 4], "system": [2, 3], "other": [2, 3, 4], "helloimgui_download_glfw_if_need": 2, "helloimgui_download_sdl_if_need": 2, "helloimgui_use_sdl_xxxx": 2, "helloimgui_use_glfw_xxxx": 2, "were": [2, 4], "glfw": [2, 3, 4], "find_packag": 2, "fail": 2, "cmake_prefix_path": 2, "instead": [2, 3, 4], "helloimgui_download_freetyp": 2, "also": [2, 4], "forcibl": 2, "helloimgui_freetype_stat": 2, "becaus": [2, 3], "ubuntu": 2, "instal": 2, "sudo": 2, "apt": 2, "libglfw3": 2, "dev": 2, "libsdl2": 2, "libfreetyp": 2, "cmake_system_nam": 2, "match": 2, "autodownload_default": 2, "els": 2, "helloimgui_download_freetype_if_need": 2, "forc": 2, "most": [2, 3, 4], "import": 2, "mingw": 2, "freetype_default": 2, "helloimgui_with_test_engin": [2, 4], "under": [2, 3, 4], "winmain": 2, "call": [2, 3, 4], "expect": 2, "signatur": [2, 3], "linker": 2, "error": [2, 3], "via": [2, 4], "pass": 2, "dhelloimgui_win32_auto_winmain": 2, "warn": [2, 4], "sdl_main_handl": 2, "befor": [2, 3, 4], "inclus": [2, 3], "refrain": 2, "sdl_main": 2, "es3": 2, "current": [2, 4], "toolchain": 2, "hello_imgui_cmak": 2, "asm": 2, "webassembl": 2, "llvm": 2, "let": [2, 3, 4], "web": 2, "nativ": [2, 3, 4], "speed": [2, 4], "without": 2, "plugin": 2, "server": 2, "basic": 2, "usen": 2, "launch": 2, "like": [2, 4], "build_emscripten": 2, "python3": 2, "m": 2, "browser": [2, 4], "navig": 2, "localhost": 2, "8000": 2, "regular": 2, "termin": [2, 4], "execut": [2, 4], "app": [2, 3, 4], "dhelloimgui_macos_no_bundl": 2, "opengles3": 2, "three": [3, 4], "overload": 3, "singl": 3, "runnerparam": 3, "whose": [3, 4], "gui": [3, 4], "const": [3, 4], "simplerunnerparam": [3, 4], "simpler": [3, 4], "windowtitl": [3, 4], "windows": [3, 4], "windowsizeauto": [3, 4], "fals": [3, 4], "restorelastwindowgeometri": 3, "fpsidl": [3, 4], "10": 3, "highli": 3, "mani": 3, "fill": [3, 4], "element": 3, "struct": [3, 4], "framer": 3, "durationformean": 3, "getio": 3, "sinc": [3, 4], "choos": [3, 4], "durat": 3, "calcul": 3, "valu": [3, 4], "imguitestengin": [3, 4], "getimguitestengin": 3, "pointer": 3, "global": 3, "instanc": [3, 4], "initi": [3, 4], "iif": 3, "activ": 3, "special": 3, "care": 3, "must": [3, 4], "taken": [3, 4], "correctli": 3, "recent": 3, "laptop": 3, "imvec2": [3, 4], "fix": 3, "alwai": [3, 4], "bad": 3, "idea": 3, "intend": [3, 4], "otherwis": 3, "might": [3, 4], "misplac": 3, "too": 3, "small": [3, 4], "done": 3, "em": 3, "css": 3, "unit": 3, "__helloimgui": 3, "emtovec2": 3, "__": 3, "independ": [3, 4], "i": [3, 4], "e": [3, 4], "float": [3, 4], "x": 3, "y": 3, "v": 3, "emsiz": 3, "visibl": [3, 4], "nbline": 3, "correspond": [3, 4], "hello_imgui_font": 3, "loadfont": 3, "fontloadingparam": 3, "addfontfromfilettf": 3, "adjust": 3, "account": [3, 4], "highdpi": 3, "spare": 3, "headach": 3, "try": [3, 4], "consist": 3, "across": 3, "paramet": 3, "merg": 3, "rang": 3, "bool": [3, 4], "adjustsizetodpi": 3, "glyph": 3, "usefullglyphrang": 3, "fontconfig": 3, "glyphrang": 3, "oversampleh": 3, "oversamplev": 3, "memori": [3, 4], "reducememoryusageiffullglyphrang": 3, "last": [3, 4], "mergetolastfont": 3, "imgui_enable_freetyp": 3, "loadcolor": 3, "filesystem": 3, "insideasset": 3, "empti": [3, 4], "interv": 3, "bound": 3, "translat": 3, "imwchar": 3, "std": [3, 4], "vector": [3, 4], "imwcharpair": 3, "config": [3, 4], "imfontconfig": 3, "deprec": 3, "two": [3, 4], "step": 3, "mergefontawesom": 3, "fontconfigfontawesom": 3, "imfont": 3, "string": [3, 4], "fontfilenam": 3, "fontsiz": 3, "hello_imgui_asset": 3, "assetfiledata": 3, "loadassetfiledata": 3, "assetpath": 3, "entir": 3, "void": [3, 4], "nullptr": [3, 4], "size_t": 3, "datas": 3, "freeassetfiledata": 3, "free": [3, 4], "addfontfrommemoryttf": 3, "take": 3, "ownership": 3, "assetfilefullpath": 3, "assetrelativefilenam": 3, "For": [3, 4], "compat": 3, "whenev": 3, "possibl": [3, 4], "give": [3, 4], "privat": 3, "xxx": 3, "virtual": 3, "implement": [3, 4], "throw": 3, "compress": 3, "cannot": [3, 4], "oper": 3, "image_from_asset": 3, "imagebuttonfromasset": 3, "imtextureid": 3, "imtextureidfromasset": 3, "textur": 3, "id": [3, 4], "imagesizefromasset": 3, "imageproportionals": 3, "askeds": 3, "images": 3, "Will": [3, 4], "dimens": 3, "comput": [3, 4], "keep": [3, 4], "aspect": 3, "ratio": [3, 4], "fit": 3, "exactli": 3, "thu": 3, "potenti": 3, "chang": [3, 4], "so": [3, 4], "don": 3, "t": 3, "directli": 3, "first": [3, 4], "cach": [3, 4], "thei": [3, 4], "freed": 3, "just": [3, 4], "exit": [3, 4], "structur": 3, "my_imag": 3, "my_app": 3, "demo": [3, 4], "hello_imgui_demodock": [3, 4], "switchlayout": 3, "layoutnam": [3, 4], "alternativedockinglayout": [3, 4], "currentlayoutnam": 3, "larg": 3, "quantiti": 3, "sparingli": 3, "saveuserpref": 3, "userprefnam": 3, "userprefcont": 3, "shall": [3, 4], "callback": 3, "beforeexit": [3, 4], "loaduserpref": 3, "postinit": [3, 4], "part": [3, 4], "relev": 3, "worri": 3, "consid": 3, "physic": 3, "pixel": [3, 4], "3600x2000": 3, "factor": 3, "200": 3, "look": 3, "depend": [3, 4], "seen": 3, "have": [3, 4], "1800x1000": 3, "itself": 3, "normal": 3, "howev": 3, "correct": 3, "thing": 3, "know": [3, 4], "fontglobalscal": 3, "rescal": 3, "bet": 3, "retina": 3, "imguidefaultfontglobalscal": 3, "dpifontloadingfactor": 3, "multipli": 3, "dpiwindowsizefactor": 3, "f": [3, 4], "where": [3, 4], "equal": 3, "currentscreenpixelperinch": 3, "96": [3, 4], "contain": 4, "diagram": 4, "summar": 4, "explain": 4, "detail": 4, "later": 4, "runner_param": 4, "adapt": 4, "member": 4, "voidfunct": 4, "windowrestorepreviousgeometri": 4, "between": 4, "screensiz": 4, "800": 4, "600": 4, "9": 4, "suffici": 4, "mygui": 4, "runner_callback": 4, "showgui": 4, "showmenu": 4, "menu": 4, "app_window_param": 4, "imgui_window_param": 4, "showmenubar": 4, "providefullscreenwindow": 4, "dockingparam": 4, "docking_param": 4, "content": 4, "layout": 4, "sever": 4, "rememberselectedalternativelayout": 4, "rememb": 4, "backendpoint": 4, "backend_point": 4, "These": 4, "backendtyp": 4, "enum": 4, "firstavail": 4, "enableidl": 4, "useimguitestengin": 4, "imgui_test_engin": 4, "pleas": 4, "read": 4, "inifoldertyp": 4, "currentfold": 4, "appuserconfigfold": 4, "documentsfold": 4, "homefold": 4, "tempfold": 4, "appexecutablefold": 4, "home": 4, "appdata": 4, "roam": 4, "inifilenam": 4, "ini": 4, "filenam": 4, "Its": 4, "deriv": 4, "inifilename_useappwindowtitl": 4, "ha": 4, "effect": 4, "devic": 4, "emscripten_fp": 4, "refresh": 4, "rate": 4, "stand": 4, "decid": 4, "dhelloimgui_with_test_engin": 4, "hello_imgui_demo": 4, "hello_imgui_demo_test_engin": 4, "subject": 4, "licens": 4, "tl": 4, "dr": 4, "individu": 4, "educ": 4, "busi": 4, "paid": 4, "larger": 4, "consum": 4, "updat": 4, "screen": 4, "veri": 4, "frequent": 4, "detect": 4, "ok": 4, "anim": 4, "live": 4, "ask": 4, "faster": 4, "increas": 4, "maximum": 4, "dynam": 4, "isidl": 4, "rememberenableidl": 4, "startup": 4, "runnercallback": 4, "beginmenu": 4, "menuitem": 4, "endmenu": 4, "beginmenubar": 4, "endmenubar": 4, "some": 4, "showmenu_app_quitabout": 4, "showmenu_view": 4, "showappmenuitem": 4, "item": 4, "quit": 4, "showmenu_app": 4, "showstatu": 4, "bar": 4, "height": 4, "30": 4, "samelin": 4, "onc": 4, "after": 4, "init": 4, "still": 4, "beforeexit_postcleanup": 4, "been": 4, "deinit": 4, "prenewfram": 4, "frame": 4, "newfram": 4, "good": 4, "beforeimguirend": 4, "endfram": 4, "afterswap": 4, "swap": 4, "custombackground": 4, "background": 4, "clear": 4, "backgroundcolor": 4, "control": 4, "over": 4, "drawn": 4, "behind": 4, "3d": 4, "mesh": 4, "game": 4, "anybackendeventcallback": 4, "anybackendcallback": 4, "sdl_event": 4, "process": 4, "further": 4, "regist": 4, "loadadditionalfont": 4, "_loaddefaultfont_withfontawesom": 4, "readi": 4, "loaddefaultfont_withfontawesom": 4, "copi": 4, "revert": 4, "embed": 4, "setupimguiconfig": 4, "_imguidefaultset": 4, "setupdefaultimguiconfig": 4, "gamepad": 4, "setupimguistyl": 4, "setup": 4, "style": 4, "registertest": 4, "definit": 4, "winrt": 4, "present": 4, "ifdef": 4, "helloimgui_mobiledevic": 4, "voidfunctionpoint": 4, "hold": 4, "anyeventcallback": 4, "design": 4, "backendev": 4, "appendcallback": 4, "compos": 4, "mayb": 4, "preexist": 4, "than": 4, "usual": 4, "often": 4, "os": 4, "immedi": 4, "respons": 4, "shortli": 4, "send": 4, "apprpriat": 4, "put": 4, "paus": 4, "ondestroi": 4, "onlowmemori": 4, "low": 4, "onpaus": 4, "enter": 4, "onresum": 4, "come": 4, "foreground": 4, "now": 4, "twice": 4, "consecut": 4, "doc_src": 4, "hello_imgui_diagram": 4, "precis": 4, "monitor": 4, "fake": 4, "restorepreviousgeometri": 4, "written": 4, "imgui_app_window": 4, "creation": 4, "hidden": 4, "hide": 4, "border": 4, "borderlessmov": 4, "drag": 4, "zone": 4, "mous": 4, "borderlessresiz": 4, "bottom": 4, "borderlessclos": 4, "close": 4, "borderlesshighlightcolor": 4, "imvec4": 4, "2f": 4, "4f": 4, "highlight": 4, "move": 4, "w": 4, "highlightcolor": 4, "getcoloru32": 4, "imguicol_titlebgact": 4, "6f": 4, "edgeinset": 4, "out": 4, "notch": 4, "iphon": 4, "inset": 4, "handleedgeinset": 4, "defaultimguiwindowtyp": 4, "nodefaultwindow": 4, "few": 4, "typic": 4, "fullscreenmod": 4, "nofullscreen": 4, "sizeauto": 4, "measur": 4, "As": 4, "consequ": 4, "vari": 4, "second": 4, "fullscreen": 4, "fullscreendesktopresolut": 4, "fullmonitorworkarea": 4, "maxim": 4, "positionmod": 4, "windowpositionmod": 4, "osdefault": 4, "monitorcent": 4, "fromcoord": 4, "monitoridx": 4, "windowsizest": 4, "state": 4, "windowsizemeasuremod": 4, "relativeto96ppi": 4, "densiti": 4, "express": 4, "800x600": 4, "coord": 4, "1600x120": 4, "192": 4, "screencoord": 4, "coordin": 4, "real": 4, "resizeappwindowatnextfram": 4, "flag": 4, "next": 4, "subsequ": 4, "inner": 4, "affect": 4, "appwindowsparam": 4, "z": 4, "45f": 4, "55f": 4, "60f": 4, "00f": 4, "clearcolor": 4, "altern": 4, "what": 4, "fulli": 4, "Then": 4, "showviewmenu": 4, "showappmenu": 4, "shown": 4, "showmenu_app_quit": 4, "confirm": 4, "view": 4, "showstatusbar": 4, "showstatus_fp": 4, "rememberstatusbarset": 4, "configwindowsmovefromtitlebaronli": 4, "enableviewport": 4, "viewport": 4, "outsid": 4, "menuapptitl": 4, "tweakedthem": 4, "imguithem": 4, "imguitweakedthem": 4, "theme": 4, "queri": 4, "availablethem": 4, "showmenu_view_them": 4, "rememberthem": 4, "class": 4, "whether": 4, "providefullscreendockspac": 4, "dockspac": 4, "No": 4, "debug": 4, "branch": 4, "switch": 4, "modif": 4, "explan": 4, "youtub": 4, "And": 4, "dockingsplit": 4, "space": 4, "dockablewindow": 4, "along": 4, "lambda": 4, "instanti": 4, "createdefaultdockingsplit": 4, "we": 4, "maindockspac": 4, "___________________________________________": 4, "miscspac": 4, "25": 4, "splitmainmisc": 4, "initialdock": 4, "newdock": 4, "direct": 4, "imguidir_down": 4, "25f": 4, "left": 4, "occupi": 4, "column": 4, "width": 4, "splitmaincommand": 4, "commandspac": 4, "imguidir_left": 4, "createdockablewindow": 4, "appstat": 4, "panel": 4, "commandgui": 4, "commandswindow": 4, "dockspacenam": 4, "log": 4, "logger": 4, "logswindow": 4, "loggui": 4, "final": 4, "wai": 4, "appli": 4, "partit": 4, "aka": 4, "At": 4, "imguidir_": 4, "imguidir_right": 4, "nodeflag": 4, "imguidocknodeflags_": 4, "tab": 4, "repres": 4, "isvis": 4, "indic": 4, "rememberisvis": 4, "canbeclos": 4, "callbeginend": 4, "begin": 4, "end": 4, "yourself": 4, "includeinviewmenu": 4, "imguiwindowflag": 4, "imguiwindowflags_": 4, "unus": 4, "windowsizecondit": 4, "imguicond": 4, "imguicond_firstuseev": 4, "windowpo": 4, "windowposcondit": 4, "focuswindowatnextfram": 4, "focus": 4, "concern": 4, "layoutcondit": 4, "dockinglayoutcondit": 4, "firstuseev": 4, "applicationstart": 4, "reappli": 4, "never": 4, "maindockspacenodeflag": 4, "imguidocknodeflag": 4, "imguidocknodeflags_passthrucentralnod": 4, "inherit": 4, "children": 4, "layoutreset": 4, "reset": 4, "drop": 4, "dockablewindowofnam": 4, "focusdockablewindow": 4, "focu": 4, "imguiid": 4, "dockspaceidfromnam": 4, "reliabl": 4, "himself": 4, "behavior": 4, "glfwwindow": 4, "sdlwindow": 4, "sdl_window": 4, "sdlglcontext": 4, "glcontext": 4, "sdl_glcontext": 4, "find": 4, "interest": 4, "rendering_met": 4, "rendering_vulkan": 4, "rendering_dx12": 4}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"hello": [0, 2], "imgui": [0, 2, 4], "featur": 0, "demo": [0, 2], "real": 0, "world": 0, "app": [0, 1], "advanc": 0, "layout": [0, 3], "custom": [0, 1], "3d": 0, "background": 0, "manual": 0, "rpn": 0, "calcul": 0, "starter": [0, 1], "templat": [0, 1], "dear": 0, "bundl": 0, "theme": 0, "tweak": 0, "get": [1, 3], "start": 1, "motto": 1, "cmake": [1, 2], "util": 1, "hello_imgui_add_app": 1, "asset": [1, 3], "immedi": 1, "gui": 1, "mode": 1, "build": 2, "instruct": 2, "its": 2, "your": 2, "applic": [2, 3, 4], "us": 2, "helloimgui": 2, "avail": 2, "backend": [2, 4], "depend": 2, "option": 2, "os": [2, 3], "specif": 2, "window": [2, 4], "io": 2, "emscripten": 2, "maco": 2, "android": 2, "api": 3, "run": 3, "current": 3, "runner": [3, 4], "param": [3, 4], "place": 3, "widget": 3, "dpi": 3, "awar": 3, "wai": 3, "load": 3, "font": 3, "data": 3, "buffer": 3, "path": 3, "displai": 3, "imag": 3, "from": 3, "switch": 3, "between": 3, "sever": 3, "store": 3, "user": 3, "set": 3, "ini": 3, "file": 3, "handl": 3, "screen": 3, "high": 3, "detail": 3, "differ": 3, "scale": 3, "paramet": 4, "runnerparam": 4, "simpl": 4, "full": 4, "fp": 4, "idl": 4, "callback": 4, "mobilecallback": 4, "appwindowparam": 4, "windowgeometri": 4, "imguiwindowparam": 4, "default": 4, "type": 4, "dock": 4, "exampl": 4, "usag": 4, "split": 4, "dockabl": 4, "pointer": 4}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1, "sphinx": 56}})
\ No newline at end of file
+Search.setIndex({"docnames": ["00_00_intro", "05_05_get_started", "60_05_build", "doc_api", "doc_params"], "filenames": ["00_00_intro.md", "05_05_get_started.md", "60_05_build.md", "doc_api.md", "doc_params.md"], "titles": ["Hello ImGui", "Get started", "Build instructions", "API", "Application parameters"], "terms": {"librari": [0, 1, 2, 4], "enabl": [0, 2, 3, 4], "quickli": [0, 4], "write": [0, 2], "multiplatform": [0, 1], "simplic": 0, "although": [0, 2, 3], "being": [0, 4], "extrem": [0, 3], "easi": [0, 2, 3, 4], "us": [0, 1, 3, 4], "can": [0, 1, 2, 3, 4], "creat": [0, 4], "complex": 0, "customiz": [0, 3], "applic": [0, 1], "It": [0, 1, 4], "base": [0, 1, 4], "util": 0, "truli": 0, "linux": [0, 2, 3, 4], "window": [0, 1, 3], "maco": [0, 1, 3, 4], "io": [0, 1, 3, 4], "android": [0, 1, 3, 4], "emscripten": [0, 1, 3, 4], "4": [0, 4], "line": [0, 1, 2, 3], "cmake": 0, "code": [0, 1, 2, 4], "easili": 0, "emb": [0, 1], "asset": [0, 4], "all": [0, 1, 2, 3, 4], "platform": [0, 1, 2, 3, 4], "requir": [0, 1, 3, 4], "set": [0, 1, 2, 4], "icon": [0, 1, 3], "name": [0, 1, 3, 4], "mobil": [0, 1, 4], "etc": [0, 1, 4], "includ": [0, 1, 3, 4], "power": 0, "save": [0, 3, 4], "mode": [0, 4], "reduc": [0, 4], "fp": [0, 3], "when": [0, 3, 4], "idl": 0, "high": [0, 4], "dpi": [0, 4], "support": [0, 4], "scale": 0, "ui": 0, "accord": 0, "whatev": 0, "handl": [0, 1, 4], "dockabl": 0, "multipl": [0, 2, 3, 4], "geometri": [0, 4], "autos": 0, "restor": [0, 4], "posit": [0, 4], "extens": 0, "list": [0, 4], "addit": [0, 1, 3, 4], "movabl": [0, 4], "resiz": [0, 3, 4], "borderless": [0, 4], "font": [0, 1, 2, 4], "emoji": 0, "color": [0, 3, 4], "integr": 0, "test": [0, 2, 3, 4], "engin": [0, 2, 3, 4], "autom": [0, 4], "your": [0, 1, 3, 4], "user": [0, 2, 4], "open": [0, 2, 4], "defin": [0, 2, 4], "add": [0, 1, 4], "backend": [0, 3], "avail": [0, 3, 4], "sdl2": [0, 2], "glfw3": [0, 2], "render": [0, 2, 4], "opengl3": [0, 2], "metal": [0, 2, 4], "vulkan": [0, 2, 4], "directx": [0, 2, 4], "The": [0, 1, 2, 3, 4], "dock": 0, "show": [0, 1, 4], "how": [0, 1, 4], "store": [0, 4], "cpu": [0, 4], "usag": [0, 1, 3], "load": [0, 4], "much": 0, "more": [0, 3], "onlin": 0, "sourc": [0, 4], "video": [0, 4], "tutori": 0, "an": [0, 1, 2, 3, 4], "interact": [0, 1, 4], "built": [0, 1, 2], "simpl": [0, 1, 2, 3], "demonstr": 0, "get": [0, 2], "you": [0, 1, 2, 3, 4], "start": [0, 4], "5": [0, 1, 3, 4], "minut": [0, 1, 4], "full": [0, 3], "fledg": 0, "top": [0, 4], "provid": [0, 1, 2, 3, 4], "lot": [0, 4], "widget": [0, 1, 4], "implot": 0, "node": 0, "editor": [0, 4], "imfiledialog": 0, "imguicolortextedit": 0, "imgui_md": 0, "well": 0, "complet": 0, "python": [0, 2], "bind": [0, 2], "c": [0, 1, 2], "minimum": 1, "develop": 1, "should": [1, 3, 4], "minim": [1, 4], "here": [1, 4], "hello": [1, 4], "world": [1, 4], "7": 1, "6": 1, "hello_imgui": [1, 2, 3, 4], "h": [1, 2, 3, 4], "int": [1, 2, 4], "main": [1, 2, 3, 4], "char": [1, 2, 3], "helloimgui": [1, 3, 4], "run": [1, 2, 4], "imgui": [1, 3], "text": [1, 2, 3, 4], "true": [1, 3, 4], "titl": [1, 4], "size": [1, 3, 4], "auto": [1, 4], "1": [1, 3, 4], "hello_world": 1, "cpp": [1, 2, 3], "recommend": [1, 2], "point": [1, 4], "own": [1, 2, 4], "project": [1, 2], "With": [1, 4], "thi": [1, 2, 3, 4], "do": [1, 2, 3, 4], "need": [1, 2, 3, 4], "clone": [1, 2], "option": [1, 3, 4], "download": [1, 2], "automat": [1, 2, 3, 4], "dure": [1, 4], "configur": 1, "time": [1, 2, 4], "see": [1, 2, 3, 4], "extract": [1, 2], "from": [1, 2, 4], "cmakelist": [1, 2, 3], "txt": [1, 2, 3], "file": [1, 2], "build": 1, "ad": [1, 2, 4], "subfold": [1, 4], "add_subdirectori": [1, 2], "extern": [1, 2], "2": [1, 4], "simpli": 1, "fetch": 1, "NOT": 1, "target": [1, 2, 4], "messag": 1, "statu": [1, 4], "fetchcont": 1, "fetchcontent_declar": 1, "git_repositori": 1, "http": [1, 2], "github": [1, 2], "com": [1, 2], "pthom": [1, 2], "git": [1, 2], "git_tag": 1, "master": 1, "fetchcontent_makeavail": 1, "endif": [1, 2], "helper": [1, 4], "function": [1, 2, 3, 4], "similar": 1, "s": [1, 3, 4], "add_execut": 1, "app_nam": 1, "file1": 1, "file2": 1, "Or": 1, "assets_loc": 1, "path": [1, 2, 4], "By": [1, 3, 4], "default": [1, 2, 3], "which": [1, 2, 3, 4], "mean": [1, 3], "search": 1, "folder": [1, 2, 4], "rel": [1, 3, 4], "locat": [1, 2, 4], "featur": 1, "link": [1, 2], "opengl": [1, 2, 4], "glad": 1, "desktop": [1, 4], "perform": 1, "anyth": 1, "besid": 1, "bundl": [1, 2, 3], "togeth": [1, 4], "app_set": 1, "gener": 1, "jpg": [1, 3], "A": [1, 4], "ani": [1, 2, 4], "deploi": 1, "droidsan": 1, "ttf": 1, "fontawesom": [1, 3], "webfont": 1, "found": [1, 2, 4], "png": [1, 4], "squar": 1, "least": [1, 2], "256x256": 1, "convert": 1, "right": [1, 4], "format": 1, "each": [1, 4], "except": [1, 2, 3, 4], "appl": [1, 2], "info": 1, "plist": 1, "resourc": 1, "specif": [1, 4], "storyboard": 1, "launchscreen": 1, "place": [1, 2, 4], "androidmanifest": 1, "xml": 1, "manifest": 1, "one": [1, 2, 3, 4], "miss": 1, "re": 1, "mipmap": 1, "xxxhdpi": 1, "differ": [1, 4], "resolut": [1, 3, 4], "studio": 1, "them": [1, 2, 3, 4], "click": 1, "new": [1, 4], "imag": 1, "shell": 1, "html": 1, "favicon": 1, "js": [1, 2], "dear": [1, 4], "program": 1, "exampl": [1, 2, 3], "displai": [1, 4], "button": [1, 3, 4], "event": [1, 4], "guifunct": [1, 3, 4], "label": [1, 4], "imagefromasset": [1, 3], "static": [1, 2, 3], "bye": 1, "its": [1, 4], "action": 1, "getrunnerparam": [1, 3, 4], "appshallexit": [1, 4], "globe": 1, "return": [1, 3, 4], "0": [1, 3, 4], "manual": [1, 4], "great": 1, "learn": 1, "about": [1, 3, 4], "On": [2, 3], "almost": [2, 3], "compil": [2, 4], "command": [2, 4], "bash": 2, "cd": 2, "mkdir": 2, "make": [2, 3, 4], "j": 2, "bin": 2, "To": 2, "either": [2, 4], "insid": [2, 3, 4], "submodul": 2, "In": [2, 3, 4], "case": [2, 3, 4], "follow": 2, "given": [2, 3, 4], "starter": 2, "templat": 2, "document": [2, 4], "below": [2, 4], "combin": 2, "If": [2, 3, 4], "specifi": [2, 3, 4], "helloimgui_use_glfw_opengl3": 2, "helloimgui_use_sdl_opengl3": 2, "note": [2, 3, 4], "onli": [2, 3, 4], "mai": [2, 3, 4], "select": [2, 4], "both": [2, 4], "sdl": [2, 3, 4], "ar": [2, 3, 4], "easier": 2, "especi": 2, "beginn": 2, "standard": [2, 3, 4], "off": 2, "advanc": [2, 3, 4], "experienc": 2, "directx11": 2, "work": [2, 3, 4], "custom": [2, 4], "src": [2, 4], "intern": [2, 3, 4], "backend_impl": [2, 4], "rendering_xxxx": 2, "those": 2, "probabl": 2, "impli": 2, "want": [2, 4], "heavili": 2, "helloimgui_use_glfw_met": 2, "helloimgui_use_sdl_met": 2, "helloimgui_use_glfw_vulkan": 2, "helloimgui_use_sdl_vulkan": 2, "11": 2, "known": 2, "issu": 2, "rendering_dx11": [2, 4], "helloimgui_use_sdl_directx11": 2, "helloimgui_use_glfw_directx11": 2, "experiment": 2, "directx12": 2, "wa": [2, 3, 4], "doe": 2, "helloimgui_use_sdl_directx12": 2, "order": [2, 3, 4], "afor": 2, "mention": [2, 4], "ON": [2, 4], "freetyp": [2, 3], "helloimgui_use_freetyp": 2, "version": [2, 3], "conveni": [2, 3], "disabl": [2, 4], "prefer": [2, 3, 4], "system": [2, 3], "other": [2, 3, 4], "helloimgui_download_glfw_if_need": 2, "helloimgui_download_sdl_if_need": 2, "helloimgui_use_sdl_xxxx": 2, "helloimgui_use_glfw_xxxx": 2, "were": [2, 4], "glfw": [2, 3, 4], "find_packag": 2, "fail": 2, "cmake_prefix_path": 2, "instead": [2, 3, 4], "helloimgui_download_freetyp": 2, "also": [2, 4], "forcibl": 2, "helloimgui_freetype_stat": 2, "becaus": [2, 3], "ubuntu": 2, "instal": 2, "sudo": 2, "apt": 2, "libglfw3": 2, "dev": 2, "libsdl2": 2, "libfreetyp": 2, "cmake_system_nam": 2, "match": 2, "autodownload_default": 2, "els": 2, "helloimgui_download_freetype_if_need": 2, "forc": 2, "most": [2, 3, 4], "import": 2, "mingw": 2, "freetype_default": 2, "helloimgui_with_test_engin": [2, 4], "under": [2, 3, 4], "winmain": 2, "call": [2, 3, 4], "expect": 2, "signatur": [2, 3], "linker": 2, "error": [2, 3], "via": [2, 4], "pass": 2, "dhelloimgui_win32_auto_winmain": 2, "warn": [2, 4], "sdl_main_handl": 2, "befor": [2, 3, 4], "inclus": [2, 3], "refrain": 2, "sdl_main": 2, "es3": 2, "current": [2, 4], "toolchain": 2, "hello_imgui_cmak": 2, "asm": 2, "webassembl": 2, "llvm": 2, "let": [2, 3, 4], "web": 2, "nativ": [2, 3, 4], "speed": [2, 4], "without": 2, "plugin": 2, "server": 2, "basic": 2, "usen": 2, "launch": 2, "like": [2, 4], "build_emscripten": 2, "python3": 2, "m": 2, "browser": [2, 4], "navig": 2, "localhost": 2, "8000": 2, "regular": 2, "termin": [2, 4], "execut": [2, 4], "app": [2, 3, 4], "dhelloimgui_macos_no_bundl": 2, "opengles3": 2, "three": [3, 4], "overload": 3, "singl": 3, "runnerparam": 3, "whose": [3, 4], "gui": [3, 4], "const": [3, 4], "simplerunnerparam": [3, 4], "simpler": [3, 4], "windowtitl": [3, 4], "windows": [3, 4], "windowsizeauto": [3, 4], "fals": [3, 4], "restorelastwindowgeometri": 3, "fpsidl": [3, 4], "10": 3, "highli": 3, "mani": 3, "fill": [3, 4], "element": 3, "struct": [3, 4], "framer": 3, "durationformean": 3, "getio": 3, "sinc": [3, 4], "choos": [3, 4], "durat": 3, "calcul": 3, "valu": [3, 4], "imguitestengin": [3, 4], "getimguitestengin": 3, "pointer": 3, "global": 3, "instanc": [3, 4], "initi": [3, 4], "iif": 3, "activ": 3, "special": 3, "care": 3, "must": [3, 4], "taken": [3, 4], "correctli": 3, "recent": 3, "laptop": 3, "imvec2": [3, 4], "fix": 3, "alwai": [3, 4], "bad": 3, "idea": 3, "intend": [3, 4], "otherwis": 3, "might": [3, 4], "misplac": 3, "too": 3, "small": [3, 4], "done": 3, "em": 3, "css": 3, "unit": 3, "__helloimgui": 3, "emtovec2": 3, "__": 3, "independ": [3, 4], "i": [3, 4], "e": [3, 4], "float": [3, 4], "x": 3, "y": 3, "v": 3, "emsiz": 3, "visibl": [3, 4], "nbline": 3, "correspond": [3, 4], "hello_imgui_font": 3, "loadfont": 3, "fontfilenam": 3, "fontsiz": 3, "fontloadingparam": 3, "paramet": 3, "merg": 3, "rang": 3, "adjust": 3, "account": [3, 4], "highdpi": 3, "bool": [3, 4], "adjustsizetodpi": 3, "glyph": 3, "usefullglyphrang": 3, "fontconfig": 3, "glyphrang": 3, "oversampleh": 3, "oversamplev": 3, "memori": [3, 4], "reducememoryusageiffullglyphrang": 3, "last": [3, 4], "mergetolastfont": 3, "imgui_enable_freetyp": 3, "loadcolor": 3, "filesystem": 3, "insideasset": 3, "empti": [3, 4], "interv": 3, "bound": 3, "translat": 3, "imwchar": 3, "std": [3, 4], "vector": [3, 4], "imwcharpair": 3, "config": [3, 4], "imfontconfig": 3, "deprec": 3, "two": [3, 4], "step": 3, "mergefontawesom": 3, "fontconfigfontawesom": 3, "addfontfromfilettf": 3, "spare": 3, "headach": 3, "try": [3, 4], "consist": 3, "across": 3, "imfont": 3, "string": [3, 4], "hello_imgui_asset": 3, "assetfiledata": 3, "loadassetfiledata": 3, "assetpath": 3, "entir": 3, "void": [3, 4], "nullptr": [3, 4], "size_t": 3, "datas": 3, "freeassetfiledata": 3, "free": [3, 4], "addfontfrommemoryttf": 3, "take": 3, "ownership": 3, "assetfilefullpath": 3, "assetrelativefilenam": 3, "For": [3, 4], "compat": 3, "whenev": 3, "possibl": [3, 4], "give": [3, 4], "privat": 3, "xxx": 3, "virtual": 3, "implement": [3, 4], "throw": 3, "compress": 3, "cannot": [3, 4], "oper": 3, "image_from_asset": 3, "imagebuttonfromasset": 3, "imtextureid": 3, "imtextureidfromasset": 3, "textur": 3, "id": [3, 4], "imagesizefromasset": 3, "imageproportionals": 3, "askeds": 3, "images": 3, "Will": [3, 4], "dimens": 3, "comput": [3, 4], "keep": [3, 4], "aspect": 3, "ratio": [3, 4], "fit": 3, "exactli": 3, "thu": 3, "potenti": 3, "chang": [3, 4], "so": [3, 4], "don": 3, "t": 3, "directli": 3, "first": [3, 4], "cach": [3, 4], "thei": [3, 4], "freed": 3, "just": [3, 4], "exit": [3, 4], "structur": 3, "my_imag": 3, "my_app": 3, "demo": [3, 4], "hello_imgui_demodock": [3, 4], "switchlayout": 3, "layoutnam": [3, 4], "alternativedockinglayout": [3, 4], "currentlayoutnam": 3, "larg": 3, "quantiti": 3, "sparingli": 3, "saveuserpref": 3, "userprefnam": 3, "userprefcont": 3, "shall": [3, 4], "callback": 3, "beforeexit": [3, 4], "loaduserpref": 3, "postinit": [3, 4], "part": [3, 4], "relev": 3, "worri": 3, "consid": 3, "physic": 3, "pixel": [3, 4], "3600x2000": 3, "factor": 3, "200": 3, "look": 3, "depend": [3, 4], "seen": 3, "have": [3, 4], "1800x1000": 3, "itself": 3, "normal": 3, "howev": 3, "correct": 3, "thing": 3, "know": [3, 4], "fontglobalscal": 3, "rescal": 3, "bet": 3, "retina": 3, "imguidefaultfontglobalscal": 3, "dpifontloadingfactor": 3, "multipli": 3, "dpiwindowsizefactor": 3, "f": [3, 4], "where": [3, 4], "equal": 3, "currentscreenpixelperinch": 3, "96": [3, 4], "contain": 4, "diagram": 4, "summar": 4, "explain": 4, "detail": 4, "later": 4, "runner_param": 4, "adapt": 4, "member": 4, "voidfunct": 4, "windowrestorepreviousgeometri": 4, "between": 4, "screensiz": 4, "800": 4, "600": 4, "9": 4, "suffici": 4, "mygui": 4, "runner_callback": 4, "showgui": 4, "showmenu": 4, "menu": 4, "app_window_param": 4, "imgui_window_param": 4, "showmenubar": 4, "providefullscreenwindow": 4, "dockingparam": 4, "docking_param": 4, "content": 4, "layout": 4, "sever": 4, "rememberselectedalternativelayout": 4, "rememb": 4, "backendpoint": 4, "backend_point": 4, "These": 4, "backendtyp": 4, "enum": 4, "firstavail": 4, "enableidl": 4, "useimguitestengin": 4, "imgui_test_engin": 4, "pleas": 4, "read": 4, "inifoldertyp": 4, "currentfold": 4, "appuserconfigfold": 4, "documentsfold": 4, "homefold": 4, "tempfold": 4, "appexecutablefold": 4, "home": 4, "appdata": 4, "roam": 4, "inifilenam": 4, "ini": 4, "filenam": 4, "Its": 4, "deriv": 4, "inifilename_useappwindowtitl": 4, "ha": 4, "effect": 4, "devic": 4, "emscripten_fp": 4, "refresh": 4, "rate": 4, "stand": 4, "decid": 4, "dhelloimgui_with_test_engin": 4, "hello_imgui_demo": 4, "hello_imgui_demo_test_engin": 4, "subject": 4, "licens": 4, "tl": 4, "dr": 4, "individu": 4, "educ": 4, "busi": 4, "paid": 4, "larger": 4, "consum": 4, "updat": 4, "screen": 4, "veri": 4, "frequent": 4, "detect": 4, "ok": 4, "anim": 4, "live": 4, "ask": 4, "faster": 4, "increas": 4, "maximum": 4, "dynam": 4, "isidl": 4, "rememberenableidl": 4, "startup": 4, "runnercallback": 4, "beginmenu": 4, "menuitem": 4, "endmenu": 4, "beginmenubar": 4, "endmenubar": 4, "some": 4, "showmenu_app_quitabout": 4, "showmenu_view": 4, "showappmenuitem": 4, "item": 4, "quit": 4, "showmenu_app": 4, "showstatu": 4, "bar": 4, "height": 4, "30": 4, "samelin": 4, "onc": 4, "after": 4, "init": 4, "still": 4, "beforeexit_postcleanup": 4, "been": 4, "deinit": 4, "prenewfram": 4, "frame": 4, "newfram": 4, "good": 4, "beforeimguirend": 4, "endfram": 4, "afterswap": 4, "swap": 4, "custombackground": 4, "background": 4, "clear": 4, "backgroundcolor": 4, "control": 4, "over": 4, "drawn": 4, "behind": 4, "3d": 4, "mesh": 4, "game": 4, "anybackendeventcallback": 4, "anybackendcallback": 4, "sdl_event": 4, "process": 4, "further": 4, "regist": 4, "loadadditionalfont": 4, "_loaddefaultfont_withfontawesom": 4, "readi": 4, "loaddefaultfont_withfontawesom": 4, "copi": 4, "revert": 4, "embed": 4, "setupimguiconfig": 4, "_imguidefaultset": 4, "setupdefaultimguiconfig": 4, "gamepad": 4, "setupimguistyl": 4, "setup": 4, "style": 4, "registertest": 4, "definit": 4, "winrt": 4, "present": 4, "ifdef": 4, "helloimgui_mobiledevic": 4, "voidfunctionpoint": 4, "hold": 4, "anyeventcallback": 4, "design": 4, "backendev": 4, "appendcallback": 4, "compos": 4, "mayb": 4, "preexist": 4, "than": 4, "usual": 4, "often": 4, "os": 4, "immedi": 4, "respons": 4, "shortli": 4, "send": 4, "apprpriat": 4, "put": 4, "paus": 4, "ondestroi": 4, "onlowmemori": 4, "low": 4, "onpaus": 4, "enter": 4, "onresum": 4, "come": 4, "foreground": 4, "now": 4, "twice": 4, "consecut": 4, "doc_src": 4, "hello_imgui_diagram": 4, "precis": 4, "monitor": 4, "fake": 4, "restorepreviousgeometri": 4, "written": 4, "imgui_app_window": 4, "creation": 4, "hidden": 4, "hide": 4, "border": 4, "borderlessmov": 4, "drag": 4, "zone": 4, "mous": 4, "borderlessresiz": 4, "bottom": 4, "borderlessclos": 4, "close": 4, "borderlesshighlightcolor": 4, "imvec4": 4, "2f": 4, "4f": 4, "highlight": 4, "move": 4, "w": 4, "highlightcolor": 4, "getcoloru32": 4, "imguicol_titlebgact": 4, "6f": 4, "edgeinset": 4, "out": 4, "notch": 4, "iphon": 4, "inset": 4, "handleedgeinset": 4, "defaultimguiwindowtyp": 4, "nodefaultwindow": 4, "few": 4, "typic": 4, "fullscreenmod": 4, "nofullscreen": 4, "sizeauto": 4, "measur": 4, "As": 4, "consequ": 4, "vari": 4, "second": 4, "fullscreen": 4, "fullscreendesktopresolut": 4, "fullmonitorworkarea": 4, "maxim": 4, "positionmod": 4, "windowpositionmod": 4, "osdefault": 4, "monitorcent": 4, "fromcoord": 4, "monitoridx": 4, "windowsizest": 4, "state": 4, "windowsizemeasuremod": 4, "relativeto96ppi": 4, "densiti": 4, "express": 4, "800x600": 4, "coord": 4, "1600x120": 4, "192": 4, "screencoord": 4, "coordin": 4, "real": 4, "resizeappwindowatnextfram": 4, "flag": 4, "next": 4, "subsequ": 4, "inner": 4, "affect": 4, "appwindowsparam": 4, "z": 4, "45f": 4, "55f": 4, "60f": 4, "00f": 4, "clearcolor": 4, "altern": 4, "what": 4, "fulli": 4, "Then": 4, "showviewmenu": 4, "showappmenu": 4, "shown": 4, "showmenu_app_quit": 4, "confirm": 4, "view": 4, "showstatusbar": 4, "showstatus_fp": 4, "rememberstatusbarset": 4, "configwindowsmovefromtitlebaronli": 4, "enableviewport": 4, "viewport": 4, "outsid": 4, "menuapptitl": 4, "tweakedthem": 4, "imguithem": 4, "imguitweakedthem": 4, "theme": 4, "queri": 4, "availablethem": 4, "showmenu_view_them": 4, "rememberthem": 4, "class": 4, "whether": 4, "providefullscreendockspac": 4, "dockspac": 4, "No": 4, "debug": 4, "branch": 4, "switch": 4, "modif": 4, "explan": 4, "youtub": 4, "And": 4, "dockingsplit": 4, "space": 4, "dockablewindow": 4, "along": 4, "lambda": 4, "instanti": 4, "createdefaultdockingsplit": 4, "we": 4, "maindockspac": 4, "___________________________________________": 4, "miscspac": 4, "25": 4, "splitmainmisc": 4, "initialdock": 4, "newdock": 4, "direct": 4, "imguidir_down": 4, "25f": 4, "left": 4, "occupi": 4, "column": 4, "width": 4, "splitmaincommand": 4, "commandspac": 4, "imguidir_left": 4, "createdockablewindow": 4, "appstat": 4, "panel": 4, "commandgui": 4, "commandswindow": 4, "dockspacenam": 4, "log": 4, "logger": 4, "logswindow": 4, "loggui": 4, "final": 4, "wai": 4, "appli": 4, "partit": 4, "aka": 4, "At": 4, "imguidir_": 4, "imguidir_right": 4, "nodeflag": 4, "imguidocknodeflags_": 4, "tab": 4, "repres": 4, "isvis": 4, "indic": 4, "rememberisvis": 4, "canbeclos": 4, "callbeginend": 4, "begin": 4, "end": 4, "yourself": 4, "includeinviewmenu": 4, "imguiwindowflag": 4, "imguiwindowflags_": 4, "unus": 4, "windowsizecondit": 4, "imguicond": 4, "imguicond_firstuseev": 4, "windowpo": 4, "windowposcondit": 4, "focuswindowatnextfram": 4, "focus": 4, "concern": 4, "layoutcondit": 4, "dockinglayoutcondit": 4, "firstuseev": 4, "applicationstart": 4, "reappli": 4, "never": 4, "maindockspacenodeflag": 4, "imguidocknodeflag": 4, "imguidocknodeflags_passthrucentralnod": 4, "inherit": 4, "children": 4, "layoutreset": 4, "reset": 4, "drop": 4, "dockablewindowofnam": 4, "focusdockablewindow": 4, "focu": 4, "imguiid": 4, "dockspaceidfromnam": 4, "reliabl": 4, "himself": 4, "behavior": 4, "glfwwindow": 4, "sdlwindow": 4, "sdl_window": 4, "sdlglcontext": 4, "glcontext": 4, "sdl_glcontext": 4, "find": 4, "interest": 4, "rendering_met": 4, "rendering_vulkan": 4, "rendering_dx12": 4}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"hello": [0, 2], "imgui": [0, 2, 4], "featur": 0, "demo": [0, 2], "real": 0, "world": 0, "app": [0, 1], "advanc": 0, "layout": [0, 3], "custom": [0, 1], "3d": 0, "background": 0, "manual": 0, "rpn": 0, "calcul": 0, "starter": [0, 1], "templat": [0, 1], "dear": 0, "bundl": 0, "theme": 0, "tweak": 0, "get": [1, 3], "start": 1, "motto": 1, "cmake": [1, 2], "util": 1, "hello_imgui_add_app": 1, "asset": [1, 3], "immedi": 1, "gui": 1, "mode": 1, "build": 2, "instruct": 2, "its": 2, "your": 2, "applic": [2, 3, 4], "us": 2, "helloimgui": 2, "avail": 2, "backend": [2, 4], "depend": 2, "option": 2, "os": [2, 3], "specif": 2, "window": [2, 4], "io": 2, "emscripten": 2, "maco": 2, "android": 2, "api": 3, "run": 3, "current": 3, "runner": [3, 4], "param": [3, 4], "place": 3, "widget": 3, "dpi": 3, "awar": 3, "wai": 3, "load": 3, "font": 3, "data": 3, "buffer": 3, "path": 3, "displai": 3, "imag": 3, "from": 3, "switch": 3, "between": 3, "sever": 3, "store": 3, "user": 3, "set": 3, "ini": 3, "file": 3, "handl": 3, "screen": 3, "high": 3, "detail": 3, "differ": 3, "scale": 3, "paramet": 4, "runnerparam": 4, "simpl": 4, "full": 4, "fp": 4, "idl": 4, "callback": 4, "mobilecallback": 4, "appwindowparam": 4, "windowgeometri": 4, "imguiwindowparam": 4, "default": 4, "type": 4, "dock": 4, "exampl": 4, "usag": 4, "split": 4, "dockabl": 4, "pointer": 4}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1, "sphinx": 56}})
\ No newline at end of file
diff --git a/src/hello_imgui/doc_api.md b/src/hello_imgui/doc_api.md
index 884d93e9..326b2280 100644
--- a/src/hello_imgui/doc_api.md
+++ b/src/hello_imgui/doc_api.md
@@ -61,11 +61,7 @@ float EmSize(float nbLines);
 See [hello_imgui_font.h](https://github.com/pthom/hello_imgui/blob/master/src/hello_imgui/hello_imgui_font.h).
 ```cpp
     //
-    // When loading fonts, use HelloImGui::LoadFont(FontLoadingParams)
-    // ===============================================================
-    // instead of ImGui::GetIO().Fonts->AddFontFromFileTTF(), because it will
-    // automatically adjust the font size to account for HighDPI, and will spare
-    // you headaches when trying to get consistent font size across different OSes.
+    // When loading fonts, use HelloImGui::LoadFont(fontFilename, fontSize, fontLoadingParams)
     //
     // Font loading parameters: several options are available (color, merging, range, ...)
     struct FontLoadingParams
@@ -107,7 +103,12 @@ See [hello_imgui_font.h](https://github.com/pthom/hello_imgui/blob/master/src/he
         ImFontConfig fontConfigFontAwesome = ImFontConfig();
     };
 
-    // Generic font loading function, with many options:
+    // When loading fonts, use HelloImGui::LoadFont(FontLoadingParams)
+    // ===============================================================
+    // instead of ImGui::GetIO().Fonts->AddFontFromFileTTF(), because it will
+    // automatically adjust the font size to account for HighDPI, and will spare
+    // you headaches when trying to get consistent font size across different OSes.
+    //
     // see FontLoadingParams and ImFontConfig
     ImFont* LoadFont(const std::string & fontFilename, float fontSize,
                      const FontLoadingParams & params = {});
diff --git a/src/hello_imgui/hello_imgui_font.h b/src/hello_imgui/hello_imgui_font.h
index db8ace00..2ab1c95f 100644
--- a/src/hello_imgui/hello_imgui_font.h
+++ b/src/hello_imgui/hello_imgui_font.h
@@ -10,11 +10,7 @@ namespace HelloImGui
 
     // @@md#Fonts
     //
-    // When loading fonts, use HelloImGui::LoadFont(FontLoadingParams)
-    // ===============================================================
-    // instead of ImGui::GetIO().Fonts->AddFontFromFileTTF(), because it will
-    // automatically adjust the font size to account for HighDPI, and will spare
-    // you headaches when trying to get consistent font size across different OSes.
+    // When loading fonts, use HelloImGui::LoadFont(fontFilename, fontSize, fontLoadingParams)
     //
     // Font loading parameters: several options are available (color, merging, range, ...)
     struct FontLoadingParams
@@ -56,7 +52,12 @@ namespace HelloImGui
         ImFontConfig fontConfigFontAwesome = ImFontConfig();
     };
 
-    // Generic font loading function, with many options:
+    // When loading fonts, use HelloImGui::LoadFont(FontLoadingParams)
+    // ===============================================================
+    // instead of ImGui::GetIO().Fonts->AddFontFromFileTTF(), because it will
+    // automatically adjust the font size to account for HighDPI, and will spare
+    // you headaches when trying to get consistent font size across different OSes.
+    //
     // see FontLoadingParams and ImFontConfig
     ImFont* LoadFont(const std::string & fontFilename, float fontSize,
                      const FontLoadingParams & params = {});