# Deshab Bitmap Font (.dbf)
`CODE/font` 包含 Deshab 自研位图字体工具和规范。
## 文件格式
```text
Offset Size Field
0 4 magic "DBF\x10" (version 16)
4 4 u32 glyph_count
8 2 u16 default_width
10 2 u16 default_height
12 2 u16 bits_per_pixel (8=grayscale)
14 N×12 index table (N entries)
... ... glyph bitmap data
```
每条索引：
```text
[0..1] u16 codepoint (Unicode BMP)
[2..3] u16 actual_width (pixels)
[4..7] u32 data_offset
[8..11] u32 data_size
```
索引按 codepoint 升序排列，可用二分查找。
## 字体文件
| 文件 | 大小 | 字形数 | 精度 |
|------|------|--------|------|
| [simhei_16.dbf](file:///d:/Code/Deshab/SYSTEM/system/font/simhei_16.dbf) | 1.8MB | 6858 | 16×16 8bpp |
| [simhei_24.dbf](file:///d:/Code/Deshab/SYSTEM/system/font/simhei_24.dbf) | 3.9MB | 6858 | 24×24 8bpp |
| [simhei_32.dbf](file:///d:/Code/Deshab/SYSTEM/system/font/simhei_32.dbf) | 6.9MB | 6858 | 32×32 8bpp |
字形覆盖：GB2312 全部 6763 个简体汉字 + ASCII 32–126 可打印字符。
## 生成工具
```bash
python CODE/font/mkfont.py <ttf_path> <pixel_size> <output.dbf>
```
依赖：Python 3 + Pillow (`pip install Pillow`)
## C 头文件
[dbf.h](file:///d:/Code/Deshab/CODE/font/dbf.h) 定义数据结构和二分查找函数：
```c
#include "dbf.h"
const u8 *font = ...; // 加载 .dbf 到内存
dbf_header *hdr = (dbf_header *)font;
dbf_index_entry *idx = (dbf_index_entry *)(font + 14);
int entry = dbf_lookup(idx, hdr->count, codepoint);
if (entry >= 0) {
u8 *glyph = font + idx[entry].offset;
u16 w = idx[entry].width;
u16 h = hdr->height;
// 逐行渲染 8bpp 灰度位图
}
```
## 使用方式
1. 启动时将 `.dbf` 文件通过 boot module 或 FAT32 加载到内存
2. GBK/GB2312 双字节序列转为 Unicode codepoint 后查表
3. 8bpp 灰度可直接 alpha-blend 到 framebuffer
xyou
efa626ed17