minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)

怼烎@ 2022-05-19 01:52 404阅读 0赞

学习[MiniGUI][]上使用TrueType字体时，在网上找了好多文章，总算是搞定了。不过话说这世界变化快,minigui也在更新迭代，这些文章大都是2年前写的，看这些文章对我入门有帮助，不过也被一些过时的内容坑了不次。在这里将我的过程做一个记录以备用。

# 新版本 MiniGUI 3.2.0 #

目前网上关于minigui的文章都是针对经典版本`MiniGUI 3.0.12`的，如果你现在访问MiniGUI的官网([http://www.minigui.org/zhcn][MiniGUI])你会发现MiniGUI就在最近已经悄悄正式发布了`MiniGUI 3.2.0`，这个新一个主要的改进就是提供了64位版本和对触屏设备的支持(mGNCS4Touch),后面这个新的特性我还没有进一步了解，不过提供64位版本，对我来说，可是大大方便了我的开发。  
因为现在多数人和我一样已经很少用32位的系统，为了在MiniGUI框架下开发就得多装一个32位的ubuntu系统。现在有了64位的版本，就不用频繁切换开发环境了。

> 参见[《MiniGUI 3.2.0 Released(2018/07/12)》][MiniGUI 3.2.0 Released_2018_07_12]

如果你是新入手学习MiniGUI框架，强烈建议你使用`MiniGUI 3.2.0`，因为它使用更方便。如果你的项目已经在`MiniGUI 3.0.12`开发一阵子了，也可以直接升级到3.2.0。为什么我敢这么说呢？唉，说说自己的经历吧。  
大概一个多月前我开发入门做嵌入式开发，找到MiniGUI这个框架。开始也是照着网上的教程，自己编译手工MiniGUI代码，又是手工安装miniStudio，好一阵折腾，等折腾好了，然后发现在MiniGUI官网上有这一篇文章：

> [《Setting up Development Environment on Ubuntu Linux》][Setting up Development Environment on Ubuntu Linux]

文章很简单，一看就明白，就是在Ubuntu 16.04下设置`MiniGUI`开发环境的步骤。我才明白 `MiniGUI`官方已经提供了`MiniGUI`的package,可以直接用`apt-get`方式安装`MiniGUI`以及`miniStudio`。这比自己编译安装省太多事儿啦，几条`apt-get`执行完就搞定了。早知道就这个，我还浪费那么多时间手工编译干嘛(学会手工编译MiniGUI也是必要的，因为后面向开发板移植的阶段要用到)

然后我就在这个环境下开始了项目开发，边看着`MiniGUI 3.0.12`的文档([MiniGUI 3.0.12][])，边摸索就算入了门，这一个多月进展顺利。

今天我发现`MiniGUI`正式升级了，想到`apt-get`升级一下MiniGUI的版本，查看版本时发现，我一个月前安装的`libminigui_ths`版本号已经是`3.2.0` ！

![这里写图片描述][70]

也就是说至少一个月前就MiniGU官网的服务器上就已经提示了`3.2.0`的二进制版本，7月12日才正式发布，靠,还有这波操作？  
我不知不觉已经照着`3.0.12`的文档在`3.2.0`上工作了这么长时间，目前没发现API接口与`3.0.12`有什么不同或不兼容。也就是说基于`3.0.12`版本开发的项目可以直接升级到`3.2.0`。

# 搭建MiniGUI 3.2.0 开发环境 #

安装`MiniGUI 3.2.0`很简单前一节已经讲了参照这篇官方说明:[《Setting up Development Environment on Ubuntu Linux》][Setting up Development Environment on Ubuntu Linux]几分钟就能搞定了。  
minigui提供了[miniStudio][]这个所见即所得的界面开发工具可以大大提高开发效率，建议使用，`miniStudio`是基于eclipse的开发工具，所以要安装eclipse。  
如果你还不会安装用eclipse，那可能要多花些时间安装eclipse。

# TrueType字体支持 #

`MiniGUI 3.2.0`默认已经基于freetype2提供了对TrueType字体的支持。  
打开`/usr/local/include/minigui/mgconfig.h`,就能看到`_MGFONT_FT2`已经打开，说明`MiniGUI 3.2.0`基于freetype2提供了对TrueType字体的支持(`_MGFONT_TTF`代表基于freetype1支持TrueType，在这里是关闭的)。

所以我们不必像`MiniGUI 3.0.12`那样为了支持TrueType而专门编译MiniGUI。

![这里写图片描述][70 1]

# 找一个TrueType 字库试试 #

TrueType 字库好找，你的`C:\Windows\Fonts`下面就有很多后缀为`ttf`的字体文件，如下图：比如黑体(simhei.ttf),楷体(simkai.ttf),幼圆(SIMYOU.TTF),仿宋(simfang.ttf),英文字体(times.ttf),英文字体(arial.ttf)。

![这里写图片描述][70 2]

将字体复制到你的ubuntu开发环境中(注意大小写)。你可以将字体直接复制到MiniGUI的系统字体目录下(`/usr/local/share/minigui/res/font`)，也可以复制到你的项目字体资源文件夹下(`/you/minigui/project/path/res/font`),

> 如果你是用在eclipse中创建的MiniGUI项目，就会有一个`res`资源文件夹，默认res下是没有font文件夹的你要手工建一个。
> 
> **NOTE:**如果你是在ubuntu虚拟机下开发，复制字体文件到虚拟机后，最好执行chmod命令修改一下文件权限：  
> chmod 664 your\_font\_file

# 修改MiniGUI.cfg #

有了ttf字体文件，MiniGUI并不会自动就知道的，你需要告诉它有哪些字体可用，这就需要修改MiniGUI的系统配置参数`/usr/local/etc/MiniGUI.cfg`:

> (要管理员权限才能编辑 )  
> sudo gedit /usr/local/etc/MiniGUI.cfg

如下图打开系统配置文件,如下格式将ttf的位置和字体类型写入配置文件。本例中加了5种字体arial,times,msyh(微软雅黑),simyou(幼圆),simkai(楷体)，（千万注意不要眼花修改到`[type1fonts]`下，否则就找不到字体了,我就干过好几次，看起来和`[truetypefonts]`太像了）  
![这里写图片描述][70 3]

注意:

1.  `name0-N`是每个字体的名字，这可不是随便命名的，命名规则参见[《MINIGUI-USER-MANUAL-V3.0》][MINIGUI-USER-MANUAL-V3.0]，`3.1.5 小节`。
2.  `fontfile0~N`在指定字体文件位置时，可以用绝对路径，也可以如上图使用相对路径，如果使用相对路径，这个相对路径是基于minigui系统的资源文件夹(`/usr/local/share/minigui/res`)，或项目的资源文件夹(`/you/minigui/project/path`)\[创建eclipse创建的MiniGUI project才有这个文件夹结构\]

## MiniGUI搜索资源的方式 ##

为什么放在项目的资源文件夹下,MiniGUI也能找到字体？  
因为miniStudio生成的main代码中，已经调用`SetResPath`将当前文件夹加入资源搜索路径，你去查查你的main入口函数

int MiniGUIMain(int argc, const char* argv[])
    {
    
    #ifdef ntStartWindowEx
        MSG Msg;
        mMainWnd *mWin;
    
    #ifdef _MGNCS_INCORE_RES
        ncsSetEtcHandle(ncsGetIncoreEtc());
        ncsInitialize();
    
        hPackage = ncsLoadIncoreResPackage();
    #else
        char f_package[MAX_PATH];
    
        ncsInitialize();
        sprintf(f_package, "%s", "res/facelock.res");
        // 将当前文件夹加入资源搜索路径
        SetResPath("./");
    
        hPackage = ncsLoadResPackage (f_package);
    #endif
    
    。。。
    
    }

# miniStudio #

好了，经过上一步，我们已经在MiniGUI的系统配置中加入了TrueType字体，下面我们可以试试在miniStudio中使用增加的矢量字体了

## 创建一个MiniGUI Project ##

首先我们 需要用于测试的MiniGUI项目，如下图打开系统菜单`File->New->Other`,如下图找到`MiniGUI Project`.就可以创建一个简单的MiniGUI Project.  
![这里写图片描述][70 4]

![这里写图片描述][70 5]

## miniStudio 选择TrueType字体 ##

![这里写图片描述][70 6]

打开菜单`File->New`创建一个新的模板：  
![这里写图片描述][70 7]  
![这里写图片描述][70 8]

![这里写图片描述][70 9]

直到目前，都很顺序，然后选择字体 ,问题了来了。。。怎么没有我们刚刚安装的TrueType字体?  
![这里写图片描述][70 10]

遇到这个问题时，我内心是崩溃的，miniStudio不是开源的，用户手册也没讲到这么细。然后我想到之前在[《MINIGUI-USER-MANUAL-V3.0》][MINIGUI-USER-MANUAL-V3.0]看到的关于MiniGUI.cfg的内容（第3章），PDF文件截图如下：

![这里写图片描述][70 11]

如上图红框标的文字，应用程序首先是找当前文件夹下的`MiniGUI.cfg`,miniStudio这个开发工具的图形界面(guibuilder)应该也是一个基于于MiniGUI框架开发的GUI应用。所以它应该是有一个自己的`MiniGUI.cfg`。

so，我想明白了。miniStudio这个开发工具的图形界面(guibuilder)的当前文件夹是`/usr/local/etc/guibuilder/`，在这里找到了它的`MiniGUI.cfg`  
![这里写图片描述][70 12]

打开`/usr/local/etc/guibuilder/MiniGUI.cfg`，果然，这里还是默认的设置，  
![这里写图片描述][70 13]  
如前面修改`/usr/local/etc/MiniGUI.cfg`一样，添加TrueType字体。  
![这里写图片描述][70 14]  
再次打开miniStudio终于看到了  
![这里写图片描述][70 15]  
选择一个楷体试试，呵呵，TrueType字体加载成功  
![这里写图片描述][70 16]

本文未完，下半部分请看  
[《minigui 3.2.0:基于miniStudio应用TrueType字体的过程(2)》][minigui 3.2.0_miniStudio_TrueType_2]

# 参考资料 #

[《Setting up Development Environment on Ubuntu Linux》][Setting up Development Environment on Ubuntu Linux]  
[《14.7 字体的渲染特效》][14.7]

[MiniGUI]: http://www.minigui.org/zhcn
[MiniGUI 3.2.0 Released_2018_07_12]: http://www.minigui.org/blog/minigui-3.2.0-released/
[Setting up Development Environment on Ubuntu Linux]: http://wiki.minigui.com/twiki/bin/view/Products/MiniGUIUMV32P01
[MiniGUI 3.0.12]: http://wiki.minigui.com/twiki/bin/view/Products/WebHome#MiniGUI_3_0
[70]: /images/20220519/780ffae20f1a449b93e6acb338628560.png
[miniStudio]: http://www.minigui.org/zhcn/ministudio/
[70 1]: /images/20220519/f729392282934e9c879d316ed864e61f.png
[70 2]: /images/20220519/1066155323ea483e87b03033a7951c08.png
[70 3]: /images/20220519/d608dd0fdb68401c83ca1516b61daad0.png
[MINIGUI-USER-MANUAL-V3.0]: http://www.minigui.com/docs/MINIGUI-USER-MANUAL-V3.0-5C.pdf
[70 4]: /images/20220519/d79bfc77964c4ac38ce8148c24f2abcf.png
[70 5]: /images/20220519/44b3f906685e4146a61b23cd02a62c17.png
[70 6]: /images/20220519/e68c9cad80824f34ab64c4f5e1e9de1e.png
[70 7]: /images/20220519/59a61b91258a41ec8bf7d08791250b46.png
[70 8]: /images/20220519/a47d9db0230f4ba897f7a044e46aede7.png
[70 9]: /images/20220519/f69c2d1d1b4a4093963873696aedfabe.png
[70 10]: /images/20220519/0fc42c222729441790de6b34940d9e2d.png
[70 11]: /images/20220519/99d6aedd9d7244798bb484f86ddeb304.png
[70 12]: /images/20220519/5f382653c8ec48778b9b93a87d93042c.png
[70 13]: /images/20220519/10ecc241c20f40a182694a1cd8e2982c.png
[70 14]: /images/20220519/7dfb4c9299f349c48c3ff40872209194.png
[70 15]: /images/20220519/a6ba0892c5454d64811c78b6e2165ab0.png
[70 16]: /images/20220519/a23e6fb581624c56a15122c33edcf36e.png
[minigui 3.2.0_miniStudio_TrueType_2]: https://blog.csdn.net/10km/article/details/81114067
[14.7]: http://wiki.minigui.com/twiki/bin/view/Products/MiniGUIPGV301Chapter13#14_7_%E5%AD%97%E4%BD%93%E7%9A%84%E6%B8%B2%E6%9F%93%E7%89%B9%E6%95%88