IMGUI 中文支持方案

Time published: July 1, 2020

没学过 c++，单纯想头铁汉化个东西，就查资料折腾了一下，这里做一个小的总结。如果有更好的方案请指正。

加载字体

首先需要加载支持中文的字体。网上最多的解决方案是读取外部的.ttf/.otf字体，亲测可用。但需要用户的目录读取权限，而且可能出现字体不存在的情况。

对于源码内嵌字体，IMGUI 的作者其实也给出了一个解决方案：将 binary 转换为 C array 的工具。如果软件只是使用拉丁字集的话，文件不大应该也没什么问题，我打算汉化的软件本身用的也是这个解决方案，但将中文字集转换为 C Array 的话大小至少是西文字集的几千倍吧。

ImGuiIO& io = ImGui::GetIO();
IMFont* ttf_font = io.Fonts->AddFontFromFileTTF("res/simhei.ttf", 16.0f, Null, io.Fonts->GetGlyphRangesChinese());
IMFont* compressed_font = io.Fonts->AddFontFromMemoryCompressedTTF(SimHei_compressed_data,SimHei_compressed_size, 16.f, Null, io.Fonts->GetGlyphRangesChinese());

这里解释一下，GetGlyphRangesChinese() 用来指定加载字符集，我需要改动的软件基于 IMGUI 1.4，所以只有这个方法，在更新的版本中，这个被加载常用汉字的GetGlyphRangesChineseSimplifiedCommon()和加载所有汉字的GetGlyphRangesChineseFull()所取代。

汉字编码

如果是 c++11，直接给中文字符串添加u8前缀就可以了，源代码本身应该也是UTF-8。之前的版本可以上网找个转换函数复制下来用。

调整 OverSampling 配置

参考 Github 上的这个 Issue。之前提到过中文字集特别占内存，而 IMGUI 的字体基于 FontAlas，至少在我这个版本（1.4）中不能动态加载，所以可能编译跑起来之后发现满屏黑白方块。

在作者提供的解决办法中，其中看起来最简单粗暴的方法是减少 OverSampling。

ImFontConfig config_words;
config_words.OversampleV = 1;
config_words.OversampleH = 1; // 默认为3
font_14 = io.Fonts->AddFontFromMemoryCompressedTTF(SimHei_compressed_data,SimHei_compressed_size, 16.f, &config_words, io.Fonts->GetGlyphRangesChinese());

除此之外还可以请求 Alpha Texture （超出我能力范围了 QvQ）或者手动缩小glyphRange，只保留自己用到的字符。

Tags:

折腾记录