欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

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

程序员文章站 2022-05-30 14:17:45
...

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

新版本 MiniGUI 3.2.0

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

参见《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》

文章很简单,一看就明白,就是在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

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

也就是说至少一个月前就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》几分钟就能搞定了。
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。

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

找一个TrueType 字库试试

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

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

将字体复制到你的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]太像了)
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)

注意:

  1. name0-N是每个字体的名字,这可不是随便命名的,命名规则参见《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.
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)

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

miniStudio 选择TrueType字体

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

打开菜单File->New创建一个新的模板:
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)

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

直到目前,都很顺序,然后选择字体 ,问题了来了。。。怎么没有我们刚刚安装的TrueType字体?
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)

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

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

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

so,我想明白了。miniStudio这个开发工具的图形界面(guibuilder)的当前文件夹是/usr/local/etc/guibuilder/,在这里找到了它的MiniGUI.cfg
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)

打开/usr/local/etc/guibuilder/MiniGUI.cfg,果然,这里还是默认的设置,
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)
如前面修改/usr/local/etc/MiniGUI.cfg一样,添加TrueType字体。
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)
再次打开miniStudio终于看到了
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)
选择一个楷体试试,呵呵,TrueType字体加载成功
minigui 3.2.0:基于miniStudio应用TrueType字体的过程(1)

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

参考资料

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