哇酷®开发者社区(WhyCan® Forum)

# MSDF字体生成工具

这是一个用于生成MSDF（多通道有符号距离场）字体的工具集，包含字体纹理生成和C代码转换功能。

## 使用方法

### 1. 生成MSDF字体纹理

使用 `msdf-atlas-gen.exe` 从TTF字体文件生成MSDF纹理：

#### Windows环境：
```bash
# 生成PNG格式纹理
.\msdf-atlas-gen.exe -font Roboto-Regular.ttf -type mtsdf -minsize 24 -emrange 0.2 -yorigin top -format png -imageout roboto_regular.png -json roboto_regular.json
```

#### Linux环境（使用Wine）：
```bash
# 生成PNG格式纹理
wine msdf-atlas-gen.exe -font Roboto-Regular.ttf -type mtsdf -minsize 24 -emrange 0.2 -yorigin top -format png -imageout roboto_regular.png -json roboto_regular.json
```

#### 备注：
- **Kerning 支持**：如果TTF字体未能导出kerning信息，需要通过FontForge重新导出支持kern的字体。使用FontForge打开字体文件，确保包含kerning表，然后重新导出为TTF格式。

- **字体规范**：字体必须满足OpenType规范，无异常交集（overlapping contours）。可以使用FontForge检查和修复字体中的轮廓交集问题，确保字形路径正确且无自交。

- **字符集**：如果需要按需来生成字符，请使用-charset参数，所需字体存储在一个txt文本里，用双引号括起来，也在文件里指定unicode范围，用方括号描述，具体请参考chinese目录的中文字符集。

### 2. 转换为C头文件

使用Python脚本将生成的纹理和元数据转换为C头文件：

```bash
python3 msdfgenc.py <png_file> <json_file> <font_name>
```

#### 参数说明：
- `png_file`: 输入的PNG纹理文件
- `json_file`: 输入的JSON元数据文件
- `font_name`: 输出字体名称（用于生成的文件名和变量名）

#### 示例：
```bash
python3 msdfgenc.py roboto_regular.png roboto_regular.json roboto
```

## 依赖要求

- msdf-atlas-gen.exe
- Python 3.x
- wine (Linux平台)

void printer_print(struct printer_t * p, unsigned char * buf, unsigned int len);
void printer_feed(struct printer_t * p, int lines);
void printer_cut(struct printer_t * p);
void printer_standby(struct printer_t * p);

void printer_print_hr(struct printer_t * p, int black, int white);
void printer_print_text(struct printer_t * p, enum printer_align_t align, const char * family, enum font_style_t style, int size, const char * fmt, ...);
void printer_print_qrcode(struct printer_t * p, enum printer_align_t align, int pixsz, const char * fmt, ...);
void printer_print_vision(struct printer_t * p, enum printer_align_t align, struct vision_t * v);
void printer_print_surface(struct printer_t * p, enum printer_align_t align, struct surface_t * s);

/*
 * start = 0x88f8cf69, crc= 0xbc1eee5a
 */
static int do_test(int argc, char ** argv)
{
	uint8_t buf = 0x01;

	for(uint32_t start = 0; start < 0xffffffff; start++)
	{
		uint32_t crc = xcrc32_sum(start, &buf, 1);
		if((crc == 0xbc1eee5a)/* || (crc == 0x5aee1ebc)*/)
		{
			shell_printf("start = 0x%08x, crc= 0x%08x\r\n", start, crc);
		}
		else
		{
			if((start & 0xffff) == 0xffff)
			{
				//shell_printf("not found start = 0x%08x\r\n", start);
			}
		}
	}
	return 0;
}