Dear ImGui 字體系統(tǒng)完全指南從內(nèi)置字體、TTF 加載到 1.92 動態(tài)字體機制【免費下載鏈接】imguiDear ImGui: Bloat-free Graphical User interface for C with minimal dependencies項目地址: https://gitcode.com/GitHub_Trending/im/imgui本文基于 Dear ImGui 官方文檔 docs/FONTS.md 編寫覆蓋字體嵌入與加載、多字體合并、圖標(biāo)字體、FreeType 光柵化、彩色 Emoji、字形范圍、UTF-8 與文件名兩大經(jīng)典陷阱并結(jié)合當(dāng)前倉庫源碼imgui.h、imconfig.h、misc/freetype/imgui_freetype.h補充實現(xiàn)細(xì)節(jié)。讀完后你將能夠獨立完成從嵌入式默認(rèn)字體到外部 .TTF/.OTF 字體的全部加載場景理解 1.92 版本引入的動態(tài)字體圖集機制并掌握字體問題的系統(tǒng)排錯方法。一、內(nèi)置字體為什么 ImGui 不需要文件系統(tǒng)Dear ImGui 的源碼內(nèi)嵌了一份 ProggyClean.ttfTristan Grimmer 出品的拷貝這是一款 13 像素高、像素級精確的默認(rèn)字體但它不太適合縮放。倉庫同時內(nèi)嵌了一份 ProggyForever.ttfDisco Hello 與 Tristan Grimmer 出品的部分拷貝——這是模仿 ProggyClean 風(fēng)格、可以良好縮放的新字體。字體直接嵌入代碼的目的是讓 Dear ImGui 無需任何文件系統(tǒng)訪問即可工作。如果項目中不用內(nèi)置字體可以在 imconfig.h 中定義IMGUI_DISABLE_DEFAULT_FONT發(fā)布不含字體的二進(jìn)制文件節(jié)省約 26 KB。從源碼可以確認(rèn)該開關(guān)的三種粒度imconfig.h//#define IMGUI_DISABLE_DEFAULT_FONT // 禁用全部默認(rèn)字體約 -9KB -14KBAddFontDefaultXXX() 將斷言 //#define IMGUI_DISABLE_DEFAULT_FONT_BITMAP // 僅禁用位圖字體 ProggyClean約 -9KB //#define IMGUI_DISABLE_DEFAULT_FONT_VECTOR // 僅禁用矢量字體 ProggyForever約 -14KB三個入口函數(shù)的分工在 imgui.h 中有明確注釋io.Fonts-AddFontDefaultVector(); // 加載內(nèi)嵌的可縮放字體ProggyForever任意較大字號下推薦 io.Fonts-AddFontDefaultBitmap(); // 加載內(nèi)嵌位圖字體ProggyCleanlegacy推薦 Size 13px 且無縮放 io.Fonts-AddFontDefault(); // legacy按預(yù)期默認(rèn)字號自動二選一自動選擇的規(guī)則是當(dāng)style.FontSizeBase * style.FontScaleMain * style.FontSizeDpi 15時使用 ProggyForever否則使用 ProggyClean。除內(nèi)置字體外還可以加載外部 .TTF/.OTF 文件見下文。倉庫的 misc/fonts/ 目錄隨附了幾個推薦字體作為便利資源Cousine-Regular.ttf、DroidSans.ttf、Karla-Regular.ttf、ProggyClean.ttf、ProggyTiny.ttf、Roboto-Medium.ttf。官方文檔同時提醒相比 2014 年最初引入時如今的字體支持已經(jīng)更好ProggyForever 已內(nèi)嵌這些文件現(xiàn)在已非必要未來可能移除。二、排錯字體問題 90% 來自 5 個原因官方文檔指出絕大多數(shù)字體與文本相關(guān)問題來自以下 41 件事逐一排查即可定位。原因 1文件名錯誤反斜杠或工作目錄不對AddFontXXX()系列函數(shù)在文件名錯誤時會觸發(fā)斷言Could not load font file!。詳見本文文件名注意事項與UTF-8 編碼兩節(jié)。原因 2非 ASCII 字符串的 UTF-8 編碼不正確見UTF-8 編碼注意事項一節(jié)可用編碼查看器確認(rèn)源碼中字符串字面量的編碼是否正確。原因 3缺少字形范圍自 1.92 起只要后端是最新的不再需要指定字形范圍。1.92 之前若要使用非 ASCII 字符必須顯式傳入 glyph ranges 加載字體。這曾是 Dear ImGui 的一項約束加載字體時需指定要加載哪些字符的字形所有已加載字形會被預(yù)先渲染進(jìn)單一紋理圖集調(diào)用io.Fonts-GetTexDataAsAlpha8()、io.Fonts-GetTexDataAsRGBA32()或io.Fonts-Build()任一都會構(gòu)建圖集這通常由渲染后端完成例如ImGui_ImplDX11_NewFrame()會調(diào)用。如果使用自定義字形范圍必須保證數(shù)組是持久persistent的在GetTexDataAsAlpha8()/GetTexDataAsRGBA32()/Build()調(diào)用期間依然可用。原因 4字體圖集紋理無法上傳到 GPU自 1.92 起配合最新后端圖集是增量構(gòu)建并動態(tài)調(diào)整大小的這種情況會少很多。1.92 之前若字形數(shù)量巨大或使用了多字體紋理可能超出圖形 API 的紋理尺寸限制。從源碼結(jié)構(gòu)看一些顯卡驅(qū)動存在紋理尺寸上限開發(fā) PC 應(yīng)用時需注意用戶的硬件限制可能低于開發(fā)機。紋理上傳失敗的典型表現(xiàn)是所有字形甚至整個界面顯示為空白白色矩形?？尚械木徑馐侄谓档瓦^采樣例如font_config.OversampleH 1紋理尺寸減半但畫質(zhì)損失明顯OversampleH 2 視覺上與 3 非常接近而 1 的畫質(zhì)下降肉眼可辨基于本地化源數(shù)據(jù)計算字形范圍來縮小范圍用ImFontGlyphRangesBuilder實現(xiàn)并在需要新字符的幀之間重建圖集——這是收益最大的一項設(shè)置io.Fonts.Flags | ImFontAtlasFlags_NoPowerOfTwoHeight;關(guān)閉紋理高度向上取整到 2 的冪的處理。源碼中該標(biāo)志定義見 imgui.h。原因 5減少啟動時的紋理重建/拷貝自 1.92 起ImFontAtlas 初始創(chuàng)建時使用 512x128 的紋理然后隨著字形和字體的使用逐漸增大。圖集增長伴隨 alloccopy新舊兩個尺寸的紋理會在短時間內(nèi)通常一幀同時存在于內(nèi)存。如果使用已知字體、希望減少初始增長可以在初始化階段設(shè)置TexMinWidth和TexMinHeight源碼定義見 imgui.h均要求為 2 的冪默認(rèn) 512/128ImFontAtlas* atlas io.Fonts; atlas-TexMinWidth 1024; atlas-TexMinHeight 1024; atlas-AddFont(...);三、1.92 新動態(tài)字體系統(tǒng)2025 年 6 月v1.92 引入了新的動態(tài)字體系統(tǒng)要求后端支持ImGuiBackendFlags_HasTextures特性帶來以下改變使用圖標(biāo)、亞洲語言和非英文語言的用戶不再需要預(yù)構(gòu)建全部字形——節(jié)省加載時間和內(nèi)存也減少了缺字問題無需再指定字形范圍可以隨時調(diào)用PushFont(nullptr, new_size)改變字體大小打包自定義矩形更方便像素可以立即寫入以往任何字體更新都需要后端特定的調(diào)用重新上傳紋理且這些調(diào)用不跨后端可移植?，F(xiàn)在可以縮放字體而無需任何后端特定調(diào)用可以把自定義 loader/后端插接到任意字體來源上。四、DPI 處理自 1.92 起配合更新的后端設(shè)置style.FontScaleDpi your_content_scale;即可縮放所有字體可在初始化時或每幀主循環(huán)開頭調(diào)用style.ScaleAllSizes(xxx)縮放尺寸/內(nèi)邊距macOS 風(fēng)格的像素/backing 縮放自 1.92 起由更新的后端自動處理。五、字體加載指令選擇基礎(chǔ)字號ImGuiStyle style ImGui::GetStyle(); style.FontSizeBase 20.0f;加載默認(rèn)字體ImGuiIO io ImGui::GetIO(); io.Fonts-AddFontDefaultVector(); // 加載內(nèi)嵌可縮放字體io.Fonts-AddFontDefaultBitmap(); // 加載內(nèi)嵌位圖字體legacyio.Fonts-AddFontDefault(); // 加載內(nèi)嵌字體legacy自動二選一加載 .TTF/.OTF 文件自 1.92 起配合最新后端不再需要傳 size 參數(shù)ImGuiIO io ImGui::GetIO(); io.Fonts-AddFontFromFileTTF(font.ttf);1.92 之前或后端未更新時ImGuiIO io ImGui::GetIO(); io.Fonts-AddFontFromFileTTF(font.ttf, size_pixels);如果出現(xiàn) Could not load font file! 斷言字體文件名大概率不正確請仔細(xì)核對文件名注意事項。加載多個字體// Init ImGuiIO io ImGui::GetIO(); ImFont* font1 io.Fonts-AddFontFromFileTTF(font.ttf); ImFont* font2 io.Fonts-AddFontFromFileTTF(anotherfont.otf);在應(yīng)用主循環(huán)中切換字體ImGui::Text(Hello); // 使用默認(rèn)字體即第一個加載的字體 ImGui::PushFont(font2, 0.0f); // 切換字體保持當(dāng)前大小 ImGui::Text(Hello with another font); ImGui::PopFont();高級選項ImFontConfigImFontConfig config; config.OversampleH 1.0f; ImFont* font io.Fonts-AddFontFromFileTTF(font.ttf, size_pixels, config);注意ImFontConfig會被內(nèi)部拷貝可以放心使用局部變量。合并多個字體為一個自 1.92 起配合最新后端無需指定字形范圍// 先加載一個字體 ImFont* font io.Fonts-AddFontDefaultVector(); ImFontConfig config; config.MergeMode true; io.Fonts-AddFontFromFileTTF(DroidSans.ttf, 0.0f, config); // 合并進(jìn)第一個字體例如添加亞洲字符 io.Fonts-AddFontFromFileTTF(fontawesome-webfont.ttf, 0.0f, config); // 合并進(jìn)第一個字體添加圖標(biāo)1.92 之前或后端未更新時// 先加載一個字體 ImFont* font io.Fonts-AddFontDefault(); // 添加字符范圍并合并進(jìn)上一個字體 // 注意ranges 數(shù)組不會被 AddFont* 函數(shù)拷貝且是惰性使用的 // 因此必須保證在 Build 或調(diào)用 GetTexDataAsRGBA32() 時它仍然可用。 static const ImWchar icons_ranges[] { 0xf000, 0xf3ff, 0 }; // 不會被拷貝保持在作用域內(nèi) ImFontConfig config; config.MergeMode true; io.Fonts-AddFontFromFileTTF(DroidSans.ttf, 18.0f, config, io.Fonts-GetGlyphRangesJapanese()); // 合并進(jìn)第一個字體 io.Fonts-AddFontFromFileTTF(fontawesome-webfont.ttf, 18.0f, config, icons_ranges); // 合并進(jìn)第一個字體 io.Fonts-Build();通過第四個參數(shù)僅烘焙特定字體范圍自 1.92 起配合最新后端無需指定字形范圍所有GetGlyphRangesXXX()函數(shù)均已被標(biāo)記過時。1.92 之前的典型用法// Basic Latin, Extended Latin io.Fonts-AddFontFromFileTTF(font.ttf, size_pixels, nullptr, io.Fonts-GetGlyphRangesDefault()); // Default 簡體中文常用 2500 個漢字 io.Fonts-AddFontFromFileTTF(font.ttf, size_pixels, nullptr, io.Fonts-GetGlyphRangesChineseSimplifiedCommon()); // Default 平假名、片假名、半角、1946 個常用漢字 io.Fonts-AddFontFromFileTTF(font.ttf, size_pixels, nullptr, io.Fonts-GetGlyphRangesJapanese());加載并使用日文字體示例自 1.92 起配合最新后端ImGuiIO io ImGui::GetIO(); io.Fonts-AddFontFromFileTTF(NotoSansCJKjp-Medium.otf);1.92 之前或后端未更新時ImGuiIO io ImGui::GetIO(); io.Fonts-AddFontFromFileTTF(NotoSansCJKjp-Medium.otf, 20.0f, nullptr, io.Fonts-GetGlyphRangesJapanese());界面代碼ImGui::Text(u8こんにちはテスト %d, 123); if (ImGui::Button(u8ロード)) { // do stuff } ImGui::InputText(string, buf, IM_COUNTOF(buf)); ImGui::SliderFloat(float, f, 0.0f, 1.0f);官方示例效果深色/淺色樣式NotoSansCJKjp-Medium 字體 20px圓角 5。六、從內(nèi)存加載字體數(shù)據(jù)ImFont* font io.Fonts-AddFontFromMemoryTTF(data, data_size, size_pixels, ...);重要AddFontFromMemoryTTF()默認(rèn)將數(shù)據(jù)緩沖區(qū)的所有權(quán)轉(zhuǎn)移給字體圖集銷毀時圖集會嘗試釋放它。這是為了避免不必要的拷貝但官方文檔認(rèn)為這或許不是個好 API未來版本會重新設(shè)計。如果想保留數(shù)據(jù)所有權(quán)并自行釋放需要清除FontDataOwnedByAtlas字段該字段定義見 imgui.hAddFontFromMemoryTTF的注釋見 imgui.hImFontConfig font_cfg; font_cfg.FontDataOwnedByAtlas false; ImFont* font io.Fonts-AddFontFromMemoryTTF(data, data_size, size_pixels, font_cfg);重要自 1.92 起當(dāng)使用FontDataOwnedByAtlas false時字體數(shù)據(jù)必須保持可用直到atlas-RemoveFont()更常見地是直到擁有該上下文或字體圖集的程序關(guān)閉。1.92.0 中由于處理FontDataOwnedByAtlas false存在 bug 這一事實尚未暴露該 bug 已在 1.92.6 修復(fù)。七、將字體數(shù)據(jù)嵌入源代碼編譯并使用 misc/fonts/binary_to_compressed_c.cpp生成可嵌入源碼的壓縮 C 風(fēng)格數(shù)組該工具文件內(nèi)自帶使用說明文檔Windows 下的預(yù)編譯版本 binary_to_compressed_c.exe 可在 demo 二進(jìn)制發(fā)布包中找到參見 docs/README.md該工具可選輸出 Base85 編碼以縮小源碼體積但實際二進(jìn)制中的只讀數(shù)組會大約增大 20%。然后加載字體ImFont* font io.Fonts-AddFontFromMemoryCompressedTTF(compressed_data, compressed_data_size, size_pixels, ...);或ImFont* font io.Fonts-AddFontFromMemoryCompressedBase85TTF(compressed_data_base85, size_pixels, ...);八、圖標(biāo)字體使用圖標(biāo)字體如 FontAwesome 或 OpenFontIcons是在 Dear ImGui 應(yīng)用中使用圖標(biāo)的簡單實用方式。常見模式是把圖標(biāo)字體合并進(jìn)主字體從而可以直接在字符串中嵌入圖標(biāo)無需來回切換字體。在 C 代碼中引用圖標(biāo)的 UTF-8 碼點可以使用社區(qū)維護的 IconFontCppHeaders 頭文件提供形如ICON_FA_SEARCH的宏這樣ICON_FA_SEARCH就會渲染為一個搜索圖標(biāo)。自 1.92 起配合最新后端無需指定字形范圍可以省略該參數(shù)。示例設(shè)置// 將圖標(biāo)合并進(jìn)默認(rèn)工具字體 #include IconsFontAwesome.h ImGuiIO io ImGui::GetIO(); io.Fonts-AddFontDefaultVector(); ImFontConfig config; config.MergeMode true; config.GlyphMinAdvanceX 13.0f; // 若希望圖標(biāo)等寬可設(shè)置此項 io.Fonts-AddFontFromFileTTF(fonts/fontawesome-webfont.ttf, 13.0f, config);1.92 之前// 將圖標(biāo)合并進(jìn)默認(rèn)工具字體 #include IconsFontAwesome.h ImGuiIO io ImGui::GetIO(); io.Fonts-AddFontDefault(); ImFontConfig config; config.MergeMode true; config.GlyphMinAdvanceX 13.0f; // 若希望圖標(biāo)等寬可設(shè)置此項 static const ImWchar icon_ranges[] { ICON_MIN_FA, ICON_MAX_FA, 0 }; io.Fonts-AddFontFromFileTTF(fonts/fontawesome-webfont.ttf, 13.0f, config, icon_ranges);使用示例// 用法示例 ImGui::Text(%s among %d items, ICON_FA_SEARCH, count); ImGui::Button(ICON_FA_SEARCH Search); // C 字符串_字面量_可以在編譯期拼接例如 hello world // ICON_FA_SEARCH 定義為字符串字面量所以這與 A B 拼成 AB 是同一機制等寬圖標(biāo)若想讓圖標(biāo)更像等寬、便于對齊可以在加載圖標(biāo)字體時設(shè)置ImFontConfig::GlyphMinAdvanceX。注意如果設(shè)置了GlyphMinAdvanceX就必須在AddFontXXX()調(diào)用中傳入font_size因為 MinAdvanceX 值是針對給定字號指定的否則會按比例縮放。排除重疊范圍自 1.92 起配合最新后端字形范圍被忽略——加載字形時合并列表中的輸入字體按順序查詢第一個擁有該字形的字體負(fù)責(zé)加載它。但若合并了多個字體可能出現(xiàn)不期望的范圍重疊。可以用ImFontConfig::GlyphExcludeRanges[]指定某個輸入要忽略的范圍// 添加字體源 1但忽略 ICON_MIN_FA..ICON_MAX_FA 范圍 static ImWchar exclude_ranges[] { ICON_MIN_FA, ICON_MAX_FA, 0 }; ImFontConfig cfg1; cfg1.GlyphExcludeRanges exclude_ranges; io.Fonts-AddFontFromFileTTF(segoeui.ttf, 0.0f, cfg1); // 添加字體源 2它期望使用上面讓出的范圍 ImFontConfig cfg2; cfg2.MergeMode true; io.Fonts-AddFontFromFileTTF(FontAwesome4.ttf, 0.0f, cfg2);另一個玩具示例// 從第一個字體中移除 A-Z static ImWchar exclude_ranges[] { A, Z, 0 }; ImFontConfig cfg1; cfg1.GlyphExcludeRanges exclude_ranges; io.Fonts-AddFontFromFileTTF(segoeui.ttf, 0.0f, cfg1); // 再加載另一個字體來填補空缺 ImFontConfig cfg2; cfg2.MergeMode true; io.Fonts-AddFontFromFileTTF(Roboto-Medium.ttf, 0.0f, cfg2);可以用Metrics/Debugger-Fonts-Font-Input Glyphs Overlap Detection Tool查看在多個字體源中均可用字形列表幫助理解哪個字體輸入提供了哪個字形。九、FreeType 光柵化器imgui_freetypeDear ImGui 默認(rèn)使用 imstb_truetype.hstb_truetype光柵化字體支持可選過采樣。這種技術(shù)及其實現(xiàn)并不適合小字號渲染小字可能略顯模糊、難以閱讀可以使用 misc/freetype/ 目錄下的imgui_freetype.cpp。編譯時加入該文件并在 imconfig.h 或構(gòu)建系統(tǒng)中添加#define IMGUI_ENABLE_FREETYPE即可自動激活開關(guān)定義見 imconfig.hFreeType 支持自動提示auto-hinting通常能改善小字號的可讀性在小分辨率下差別尤為明顯misc/freetype/ 目錄內(nèi)有更詳細(xì)的使用文檔正確的 sRGB 空間混合會對字體渲染質(zhì)量產(chǎn)生重要影響。從源碼看#define IMGUI_ENABLE_FREETYPE等價于手動調(diào)用io.Fonts-SetFontLoader(ImGuiFreeType::GetFontLoader())見 misc/freetype/imgui_freetype.h。FreeType 后端還提供了一組可全局ImFontAtlas::FontLoaderFlags或按字體ImFontConfig::FontLoaderFlags字段定義見 imgui.h設(shè)置的標(biāo)志misc/freetype/imgui_freetype.h標(biāo)志含義ImGuiFreeTypeLoaderFlags_NoHinting禁用 hinting字形通常更模糊ImGuiFreeTypeLoaderFlags_NoAutoHint禁用自動 hinterImGuiFreeTypeLoaderFlags_ForceAutoHint優(yōu)先使用自動 hinter 而非字體自帶 hinterImGuiFreeTypeLoaderFlags_LightHinting輕量 hinting僅沿 Y 軸吸附像素網(wǎng)格字形更模糊但更接近原始形狀I(lǐng)mGuiFreeTypeLoaderFlags_MonoHinting強 hinting僅適合單色輸出ImGuiFreeTypeLoaderFlags_Bold/Oblique人工加粗 / 仿斜體ImGuiFreeTypeLoaderFlags_Monochrome禁用抗鋸齒與 MonoHinting 組合效果最佳ImGuiFreeTypeLoaderFlags_LoadColor啟用 FreeType 彩色分層字形ImGuiFreeTypeLoaderFlags_Bitmap啟用 FreeType 位圖字形默認(rèn) hinting 是開啟的且優(yōu)先使用字體原生 hinter關(guān)閉 FreeType 生成的字形會更模糊接近 stb_truetype 的效果。十、彩色字形 / Emoji彩色 Emoji 渲染由 imgui_freetype 在 FreeType 2.10 下支持加載字體時需要ImGuiFreeTypeBuilderFlags_LoadColor標(biāo)志即上表的ImGuiFreeTypeLoaderFlags_LoadColorEmoji 經(jīng)常編碼在 Unicode 高層碼點 0x10000需要將 Dear ImGui 以IMGUI_USE_WCHAR32編譯開關(guān)見 imconfig.hFreeType 目前并非支持所有類型的彩色字體皮膚色調(diào)修飾符skin tone modifiers等有狀態(tài) Unicode 特性不受文本渲染器支持。示例將 Windows Emoji 字體 seguemj 合并進(jìn)常規(guī)字體io.Fonts-AddFontFromFileTTF(../../../imgui_dev/data/fonts/NotoSans-Regular.ttf, 16.0f); static ImWchar ranges[] { 0x1, 0x1FFFF, 0 }; static ImFontConfig cfg; cfg.MergeMode true; cfg.FontLoaderFlags | ImGuiFreeTypeLoaderFlags_LoadColor; io.Fonts-AddFontFromFileTTF(C:\\Windows\\Fonts\\seguiemj.ttf, 16.0f, cfg);十一、自定義字形范圍自 1.92 起配合最新后端無需指定字形范圍此節(jié)實用性大降。1.92 之前可以使用ImFontGlyphRangesBuilder輔助類基于文本輸入創(chuàng)建字形范圍。例如對于劇本內(nèi)容已知的游戲可以把整個劇本喂給它只構(gòu)建游戲?qū)嶋H用到的字符ImVectorImWchar ranges; ImFontGlyphRangesBuilder builder; builder.AddText(Hello world); // 添加字符串Hello world 含 7 個不同字符 builder.AddChar(0x7262); // 添加特定字符 builder.AddRanges(io.Fonts-GetGlyphRangesJapanese()); // 添加一組默認(rèn)范圍 builder.BuildRanges(ranges); // 構(gòu)建最終結(jié)果有序、去重 io.Fonts-AddFontFromFileTTF(myfontfile.ttf, size_in_pixels, nullptr, ranges.Data); io.Fonts-Build(); // 在 ranges 仍在作用域、未刪除時構(gòu)建圖集十二、自定義彩色圖標(biāo)自 1.92 起配合最新后端該系統(tǒng)已被重構(gòu)。建議做法是創(chuàng)建自定義ImFontLoader并用它注冊字體。AddCustomRectFontGlyph()已被廢棄因為其 API 在可縮放字體下不太合理。1.92 之前的做法BETA API需要熟悉 dear imgui 和渲染后端使用ImFontAtlas::AddCustomRect()和ImFontAtlas::AddCustomRectFontGlyph()API 注冊會被打包進(jìn)字體圖集紋理的矩形。在構(gòu)建圖集之前注冊然后調(diào)用Build()然后用ImFontAtlas::GetCustomRect(int)查詢矩形在紋理中的位置/尺寸把任意圖形數(shù)據(jù) blit/copy 進(jìn)去該 API 是 beta 狀態(tài)因為很可能為支持多 DPI多個不同 DPI 縮放的視口而改變。偽代碼// 添加字體然后為字形 a 和 b 注冊兩個 13x13 自定義矩形 ImFont* font io.Fonts-AddFontDefaultVector(); int rect_ids[2]; rect_ids[0] io.Fonts-AddCustomRectFontGlyph(font, a, 13, 13, 131); rect_ids[1] io.Fonts-AddCustomRectFontGlyph(font, b, 13, 13, 131); // 構(gòu)建圖集 io.Fonts-Build(); // 以 RGBA 格式獲取紋理 unsigned char* tex_pixels nullptr; int tex_width, tex_height; io.Fonts-GetTexDataAsRGBA32(tex_pixels, tex_width, tex_height); for (int rect_n 0; rect_n IM_COUNTOF(rect_ids); rect_n) if (const ImTextureRect* rect io.Fonts-GetCustomRect(rect_ids[rect_n])) { // 用紅色像素填充自定義矩形實際中應(yīng)在此繪制/拷貝你的位圖數(shù)據(jù) for (int y 0; y rect-Height; y) { ImU32* p (ImU32*)tex_pixels (rect-Y y) * tex_width (rect-X); for (int x rect-Width; x 0; x--) *p IM_COL32(255, 0, 0, 255); } }十三、關(guān)于文件名大量新 C/C 用戶在加載字體時遇到問題根源在于文件名錯誤——對當(dāng)前目錄的假設(shè)不對。兩點需要特別注意(1) C/C 及大多數(shù)編程語言中字符串字面量里要用反斜杠\必須寫成雙反斜杠\\。而 Windows 恰好使用反斜杠作為路徑分隔符務(wù)必留意io.Fonts-AddFontFromFileTTF(MyFiles\MyImage01.jpg, ...); // 錯誤!! io.Fonts-AddFontFromFileTTF(MyFiles\\MyImage01.jpg, ...); // 正確在 Windows 下某些情況也可以用/作為路徑分隔符。(2) 確保 IDE/調(diào)試器設(shè)置讓可執(zhí)行文件從正確的工作當(dāng)前目錄啟動。Visual Studio 中可以在項目Properties General Debugging Working Directory更改工作目錄。人們常假設(shè)程序從項目根目錄啟動而實際上默認(rèn)通常從存放目標(biāo)文件或可執(zhí)行文件的目錄啟動io.Fonts-AddFontFromFileTTF(MyImage01.jpg, ...); // 相對文件名取決于運行時的 Working Directory io.Fonts-AddFontFromFileTTF(../MyImage01.jpg, ...); // 從 Working Directory 的父目錄加載十四、關(guān)于 UTF-8 編碼對于非 ASCII 字符顯示一個常見的用戶問題是沒有傳入正確 UTF-8 編碼的字符串。(1) 提供函數(shù)ImGui::DebugTextEncoding(const char* text)可驗證 UTF-8 字符串內(nèi)容是確認(rèn)編碼正確的便捷手段ImGui::SeparatorText(CORRECT); ImGui::DebugTextEncoding(u8こんにちは); ImGui::SeparatorText(INCORRECT); ImGui::DebugTextEncoding(こんにちは);也可以在Metrics/Debuggers-Tools-UTF-8 Encoding viewer找到同樣工具從剪貼板粘貼驗證但這無法驗證你的編譯器所做的 UTF-8 編碼。(2) 編譯器層面強制 UTF-8 的方式Visual Studio 編譯器/utf-8命令行標(biāo)志Visual Studio 編譯器代碼內(nèi)#pragma execution_character_set(utf-8)自 2023 年 5 月起倉庫中所有示例的 Visual Studio 項目已改用/utf-8?；蛘咦?C11 起可以使用u8my text語法將字面量編碼為 UTF-8ImGui::Text(u8hello); ImGui::Text(u8こんにちは); // 總是編碼為 UTF-8 ImGui::Text(こんにちは); // 編碼取決于編譯器設(shè)置/標(biāo)志可能不正確自 C20 起u8的返回類型從const char*變?yōu)閏onst char8_t*不能直接轉(zhuǎn)換為const char*使用稍顯繁瑣ImGui::Text((const char*)u8こんにちは);也可以用編譯器選項關(guān)閉這一行為MSVC 使用/Zc:char8_t-Clang 和 GCC 使用-fno-char8_t。十五、調(diào)試工具M(jìn)etrics/Debugger - Fonts可以使用Metrics/Debugger窗口位于DemoTools瀏覽字體出問題時有用也可以通過Demo-Tools-Style Editor-Fonts進(jìn)入Style Editor 的 Fonts 部分提供相同信息。UTF-8 Encoding Viewer可以使用Metrics/Debugger中的UTF-8 Encoding viewer驗證 UTF-8 字符串內(nèi)容。從 C/C 代碼中可以調(diào)用ImGui::DebugTextEncoding(my string);驗證編碼是否正確。十六、倉庫內(nèi)置字體的版權(quán)與許可證嵌入源碼的字體ProggyClean.ttfTristan Grimmer 出品MIT License。推薦加載設(shè)置Size 13.0、GlyphOffset.y 1、PixelSnapH trueProggyForever.ttfDisco Hello 與 Tristan Grimmer 出品MIT License。misc/fonts/ 目錄下的額外字體文件Roboto-Medium.ttfChristian Robetson 出品Apache License 2.0Cousine-Regular.ttfSteve Matteson 出品數(shù)字?jǐn)?shù)據(jù)版權(quán)歸 Google Corporation (2010)SIL Open Font License 1.1DroidSans.ttfSteve Matteson 出品Apache License 2.0ProggyTiny.ttfTristan Grimmer 出品MIT License。推薦加載設(shè)置Size 10.0、GlyphOffset.y 1Karla-Regular.ttfJonathan Pinhorn 出品SIL OPEN FONT LICENSE 1.1。官方文檔說明這些字體文件在 2014 年引入時是有用的如今隨著字體支持改善ProggyForever 內(nèi)嵌已大多不再必要可能會最終移除。十七、常用字體資源方向圖標(biāo)字體FontAwesome、OpenFontIcons、Google Icon Fonts、IcoMoon 定制圖標(biāo)字體構(gòu)建器、IconFontCppHeaders 頭文件生成等常規(guī)字體Google Noto Fonts全球語言、Open Sans、日文字體 M 等等寬字體Proggy Fonts、Sweet16、Noto Mono、Adobe Source Code Pro、Inconsolata 等以及 Windows 自帶的 Arial Unicode 等 Unicode 字體全字符覆蓋但許可情況需自行確認(rèn)。小結(jié)一張速查表場景推薦做法快速上手、無文件系統(tǒng)AddFontDefaultVector()1.92 起推薦像素風(fēng) UI、13px 不縮放AddFontDefaultBitmap()需要任意字號/縮放1.92 動態(tài)系統(tǒng) AddFontFromFileTTF()免 size 參數(shù)縮小二進(jìn)制體積imconfig.h 中IMGUI_DISABLE_DEFAULT_FONT約省 26 KB小字號更清晰misc/freetype/ IMGUI_ENABLE_FREETYPE圖標(biāo)圖標(biāo)字體 MergeMode合并GlyphMinAdvanceX等寬全字符覆蓋、無范圍指定1.92 動態(tài)字體最新后端否則ImFontGlyphRangesBuilder無文件部署binary_to_compressed_c.cpp 生成壓縮數(shù)組 AddFontFromMemoryCompressedTTF()排錯依次檢查文件名/工作目錄、UTF-8 編碼、字形范圍、圖集紋理大小【免費下載鏈接】imguiDear ImGui: Bloat-free Graphical User interface for C with minimal dependencies項目地址: https://gitcode.com/GitHub_Trending/im/imgui創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考