mengzhengjie
mengzhengjie

MiniGUI.cfg 文件详解

http://blog.csdn.net/yuanbinquan/article/details/43019129


前两天在360图书管上发现了一篇介绍minigui3.0 的配置文件非常详细的帖子，本着分类归档的思想，把它搬到了CSDN上，供大家学习参考：


5、MiniGUI V3.0 配置详解

  • 5 MiniGUI V3.0 的运行
    • 5.1 建立 MiniGUI V3.0 运行环境的前提
    • 5.2 MiniGUI.cfg说明
      • 5.2.1 配置文件MiniGUI.cfg格式简介
      • 5.2.2 system段
      • 5.2.3 图形引擎配置段
        • fbcon段
        • qvfb段
        • pc_xvfb 段
        • rtos_xvfb 段
        • shadow 段
        • mlshadow 段
      • 5.2.4 字体配置段
        • systemfont 段
        • rawbitmapfonts、varbitmapfonts、upf、qpf、truetypefonts段
      • 5.2.5 mouse段
      • 5.2.6 event段
      • 5.2.7 cursorinfo段
      • 5.2.8 resinfo段
      • 5.2.9 渲染器的设置
        • classic/flat/fashion 渲染器
        • skin 渲染器
      • 5.2.10 默认的MiniGUI.cfg文件内容
    • 5.3 环境变量

本章介绍 MiniGUI 3.0 的运行时配置选项，包括运行时配置文件、环境变量等。

5.1 建立 MiniGUI V3.0 运行环境的前提

运行 MiniGUI 3.0 的操作系统需要满足一些前提条件：

  • 支持 POSIX1.X 的 UNIX 系统。这包括 Linux 2.4 和 2.6 等，也包括 uClinux 等非标准 Linux 系统。
  • MiniGUI-Process 的运行需要系统提供 System V 的如下进程间通讯机制：共享内存和信号量。
  • 运行 MiniGUI-Processes 需要 UNIX 域套接字机制的支持。
  • 运行 MiniGUI-Threads 需要 POSIX 兼容线程库的支持。

5.2 MiniGUI.cfg说明

运行时配置选项影响 MiniGUI 的一些运行行为，比如要使用的图形引擎或者输入引擎；要装载的设备字体；要装载的位图、光标资源等等。我们已经了解到，MiniGUI 的运行时配置一般是通过配置文件（MiniGUI.cfg）指定的，但在使用内建资源方式配置并编译 MiniGUI 后，运行时配置选项将直接编译到函数库中，配置文件 MiniGUI.cfg 文件将不起作用。在 MiniGUI 应用程序启动时，MiniGUI 优先查找当前目录下的 MiniGUI.cfg 文件、用户主目录下的 .MiniGUI.cfg 文件，其次是 /usr/local/etc/MiniGUI.cfg，最后是 /etc/MiniGUI.cfg 文件。如果用户没有在当前目录及自己的主目录下建立对应的 MiniGUI.cfg 文件，则通常情况下，/usr/local/etc/MiniGUI.cfg 文件就是 MiniGUI 所使用的默认运行时配置文件。下边章节会先描述使用配置文件时的运行时配置选项，之后描述如何在内建资源方式下指定运行时配置选项。

5.2.1 配置文件MiniGUI.cfg格式简介

配置文件采用了非常简洁的格式，所以修改起来也很容易。其格式如下：

[section-name1]
key-name1=key-value1
key-name2=key-value2

[section-name2]
key-name3=key-value3
key-name4=key-value4
配置文件中由注释（#）、段（section）、键（key）和键值（Key Value）四部分组成，注释是以“#”为第一个字符开始的行，段是由[section-name]形式给出，包含若干键和键值对组合，用 key=key_value 的形式指定键和键值。下面按段介绍配置文件内容。

5.2.2 system段

该段指定了MiniGUI 运行时使用的输入输出引擎以及鼠标设备和协议类型。指定的输入输出引擎必须是编译配置MiniGUI库时多个引擎中的一个。

该段定义如下键：

  • gal_engine：指定使用的图形引擎
  • defaultmode：指定图形引擎的显示模式，格式为：宽x高-显示位数(bpp)
  • ial_engine：指定使用的输入引擎
  • mdev：指定鼠标设备文件
  • mtype：指定鼠标协议类型

MiniGUI.cfg文件system段内容如下：

[system]
# GAL engine and default options
gal_engine=qvfb
defaultmode=800x600-16bpp

# IAL engine
ial_engine=qvfb

mdev=/dev/input/mice
mtype=IMPS2

5.2.3 图形引擎配置段

fbcon段

该段是在[system]段gal_engine的键值指定为fbcon时使用，表示运行fbcon时使用的显示模式。若该段未定义或键值为空，则使用[system]段定义的键值。该段只包含一个defaultmode键，具体含义和[system]段相同：defaultmode：指定图形引擎的显示模式，格式为：宽x高-显示位数(bpp)

[fbcon]
defaultmode=1024x768-16bpp

qvfb段

该段是在[system]段 gal_engine 的键值指定为 qvfb 时使用，表示运行 qvfb 时使用了XWindow 的哪个 display 及显示模式。

该段定义如下键，具体含义如下：

  • defaultmode：指定图形引擎的显示模式，格式为：宽x高-显示位数(bpp)
  • display：运行 qvfb 时使用 X Window 的哪个 display，一般取 0。

MiniGUI.cfg 文件 qvfb 段内容如下：

[qvfb]
defaultmode=640x480-16bpp
display=0

pc_xvfb 段

该段是在 [system] 段 gal_engine 的键值指定为 pc_qvfb 时使用，表示 pc_xvfb 的程序路径、显示模式以及窗口标题栏文字。Pc_xvfb 是在 PC 机上使用的一种图形引擎模式。该段定义如下键，具体含义如下：

  • Defaultmode：指定图形引擎的显示模式，格式为：宽x高-显示位数(bpp)
  • window_caption：标题栏文字
  • exec_file：图形引擎程序的安装路径

MiniGUI.cfg文件pc_xvfb段内容如下：

[pc_xvfb]
defaultmode=1024x768-16bpp
window_caption=XVFB-for-MiniGUI-3.0-(Qt-Version)
exec_file=/usr/local/bin/qvfb2

rtos_xvfb 段

该段是在 [system] 段 gal_engine 的键值指定为 rtos_qvfb 时使用，表示 rtos_xvfb 的显示模式。rtos_xvfb 是在嵌入式系统上使用的一种图形引擎模式。

该段定义如下键，具体含义如下：

  • Defaultmode：指定图形引擎的显示模式，格式为：宽x高-显示位数(bpp)

MiniGUI.cfg 文件 rtos_xvfb 段内容如下：

[rtos_xvfb]
defaultmode=800x600-16bpp

shadow 段

该段是在 [system] 段 gal_engine 的键值指定为 shadow 时使用，表示 shadow 的真实引擎、默认模式以及屏幕旋转模式。

该段定义如下键，具体含义如下：

  • real_engine： 真实图形引擎，可为: pc_xvfb ， qvfb
  • defaultmode：指定图形引擎的显示模式，格式为：宽x高-显示位数(bpp)
  • rotate_screen： 指定屏幕是否旋转，值可为： normal ，cw ， ccw ， hflip ， vflip 。

MiniGUI.cfg 文件 shadow 段内容如下：

[shadow]
real_engine=pc_xvfb
defaultmode=800x600-16bpp
rotate_screen=normal

mlshadow 段

该段是在 [system] 段 gal_engine 的键值指定为 mlshadow 时使用，表示 mlshadow 的真实引擎、默认模式、屏幕背景颜色以及刷屏时是否使用双缓冲。

该段定义如下键，具体含义如下：

  • real_engine：真实图形引擎，可为: pc_xvfb ， qvfb
  • defaultmode：指定图形引擎的显示模式，格式为：宽x高-显示位数(bpp)
  • def_bgcolor： 指定背景颜色，如：0x00FF00
  • double_buffer： 刷屏时是否使用双缓冲，值可为enable ， disable 。

MiniGUI.cfg文件mlshadow段内容如下：

[mlshadow]
real_engine=qvfb
defaultmode=800x600-16bpp
def_bgcolor=0x00FF00
double_buffer=enable

5.2.4 字体配置段

systemfont 段

该段定义了  MiniGUI 的系统字体和字体个数。并定义了系统默认使用的字体，用于  MiniGUI 的标题、菜单、控件的显示。

系统字体是 MiniGUI 装载了由 rawbitmapfonts、 varbitmapfonts、 qpf、 upf、 truetypefonts 等段定义的设备字体之后，根据上述字体名称调用 CreateLogFontByName 函数建立的逻辑字体。

逻辑字体名称的格式如下：

--