191 lines
6.0 KiB
ReStructuredText
Executable File
191 lines
6.0 KiB
ReStructuredText
Executable File
字库生成
|
||
=================================
|
||
|
||
:link_to_translation:`en:[English]`
|
||
|
||
1、功能概述
|
||
--------------------
|
||
|
||
本文档主要介绍OSD中所用到的字库生成以及在代码中的适配。
|
||
|
||
2、参考路径
|
||
--------------------
|
||
|
||
OSD参考代码在 ``components/bk_draw_blend`` 和 ``components/display_service/src/lcd_draw_blend.c``
|
||
|
||
|
||
3、字库生成
|
||
--------------------
|
||
|
||
1) 字库定义路径在 ``../components/bk_draw_blend/string.c``
|
||
|
||
::
|
||
|
||
#if FONT_ANTI4BPP_BLACK24
|
||
………
|
||
#endif
|
||
|
||
2) 字库的头文件声明路径 ``../bk_idk/include/modules/lcd_font.h``
|
||
|
||
3) 字库生成的工具：FontCvt.exe
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-exe.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
|
||
4) 双击打开FomtCvt.exe，出现下面界面：默认选择Extended，antialiased，4bpp，点击OK
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-1.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
|
||
5) 出现下面的弹框，根据自己需求去修改字体、字形或者字体大小。
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-2.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
|
||
6) 选择菜单栏的edit选项，选择展开的“Disable all characters”选项
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-3.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
|
||
7) 选择“enable range of characters”选项,选择特定的汉字
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-4.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-5.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
|
||
8) 或者将第7步使用下面的方式，这种方式更加便捷简单
|
||
打开记事本将所需的字另存为unicode编码格式：
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-6.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
然后读入刚才的temp.txt文件
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-7.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-8.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
|
||
9) 选择菜单栏的File选项，选择展开的“Save AS”选项, 把生成的c文另存为，注意文件名字改成英文
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-9.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
10) 用编译器打开该C文件，去掉下图的部分
|
||
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-10.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
将剩余的拷贝到string.c中
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-11.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
11) 参考其他的字体，将文件修改完善
|
||
|
||
::
|
||
|
||
GUI_CONST_STORAGE gui_font_digit_struct GUI_Fontnoanti_newsong48_CharInfo[95] = {
|
||
|
||
{1, 1, 24, 34, 0, 0, 24, NULL} //the first must 1.
|
||
|
||
,{ 0x002E, 1, 6, 6, 3, 35, 24, acGUI_Fontnoanti_newsong48_002E } /* code 002E, FULL STOP */
|
||
,{ 0x0030, 1,20, 33, 2, 8, 24, acGUI_Fontnoanti_newsong48_0030 } /* code 0030, DIGIT ZERO */
|
||
,{ 0x0031, 1,13, 33, 6, 8, 24, acGUI_Fontnoanti_newsong48_0031 } /* code 0031, DIGIT ONE */
|
||
,{ 0x0032, 1,19, 33, 2, 8, 24, acGUI_Fontnoanti_newsong48_0032 } /* code 0032, DIGIT TWO */
|
||
,{ 0x0033, 1,18, 33, 3, 8, 24, acGUI_Fontnoanti_newsong48_0033 } /* code 0033, DIGIT THREE */
|
||
,{ 0x0034, 1,20, 33, 2, 8, 24, acGUI_Fontnoanti_newsong48_0034 } /* code 0034, DIGIT FOUR */
|
||
,{ 0x0035, 1,18, 33, 3, 8, 24, acGUI_Fontnoanti_newsong48_0035 } /* code 0035, DIGIT FIVE */
|
||
,{ 0x0036, 1,20, 33, 2, 8, 24, acGUI_Fontnoanti_newsong48_0036 } /* code 0036, DIGIT SIX */
|
||
,{ 0x0037, 1,18, 33, 3, 8, 24, acGUI_Fontnoanti_newsong48_0037 } /* code 0037, DIGIT SEVEN */
|
||
,{ 0x0038, 1,19, 33, 2, 8, 24, acGUI_Fontnoanti_newsong48_0038 } /* code 0038, DIGIT EIGHT */
|
||
,{ 0x0039, 1,19, 33, 2, 8, 24, acGUI_Fontnoanti_newsong48_0039 } /* code 0039, DIGIT NINE */
|
||
,{ 0x003A, 1, 5, 23, 9, 18, 24, acGUI_Fontnoanti_newsong48_003A } /* code 003A, COLON */
|
||
|
||
,{ 0x0056, 1,22, 33, 1, 8, 24, acGUI_Fontnoanti_newsong48_0056 } /* code 0056, LATIN CAPITAL LETTER V */
|
||
,{ 0x004C, 1,20, 33, 2, 8, 24, acGUI_Fontnoanti_newsong48_004C } /* code 004C, LATIN CAPITAL LETTER L */
|
||
|
||
,{0, 1, 24, 34, 0, 0, 24, NULL} //the end must 0.
|
||
};
|
||
|
||
在刚才的字体文件中补全数组的第一行和最后一行，注意补全下方红色边框框出的逗号
|
||
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-12.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
|
||
需要对文件进行如下的替换操作，下图中指向部分填充4个空格，选全部替换。
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-13.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
在将下图中红色框2中所有选择部分填充到前面红色框1处，可用Alt+左键，进行竖向选择。
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-14.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
替换操作后，需要去掉下图中圈出的参数。
|
||
|
||
.. figure:: ../../../../common/_static/osd/fontcvt-15.png
|
||
:align: center
|
||
:figclass: align-center
|
||
|
||
12) 最后，声明字库
|
||
|
||
::
|
||
|
||
#if FONT_NOANTI_NEWSONG42
|
||
extern const gui_font_digit_struct *const font_noanti_newsong42;
|
||
#endif
|
||
|
||
.. note::
|
||
|
||
如何确认生成字库的尺寸?
|
||
字库的结构体中是如下定义的：
|
||
|
||
::
|
||
|
||
typedef struct
|
||
{
|
||
const unsigned short value;
|
||
const unsigned char bit_point; //every point user bit.
|
||
const unsigned char x_size;
|
||
const unsigned char y_size;
|
||
const signed char x_pos;
|
||
const signed char y_pos;
|
||
const unsigned char width;
|
||
const unsigned char *const data;
|
||
}gui_font_digit_struct;
|
||
|
||
|
||
所以，字符的高度最大是用工具生成的最大像素，比如按48pixel生成的汉字，最大高度为48，实际是字符高度加上y_pos, 但是结构体中没有字符高度的表示，用户只能在工具中看到。
|
||
每个字符的宽度是结构体中的width，但是还需要加上x_pos。
|
||
所以，在做OSD中确定字符串的长宽一般是(最大宽度，最大高度), 但是可能以适当减小，只要满足实际长宽加坐标偏移量即可。
|
||
|