mirror of
https://github.com/unanmed/HumanBreak.git
synced 2025-10-31 04:02:59 +08:00
158 lines
3.7 KiB
Markdown
158 lines
3.7 KiB
Markdown
# TextContentParser API 文档
|
||
|
||
本文档由 `DeepSeek R1` 模型生成并微调。
|
||
|
||
## 类描述
|
||
|
||
`TextContentParser` 是文字解析核心工具，用于处理文本排版、转义字符解析及动态样式管理。支持自动分词换行、图标嵌入和样式栈控制。
|
||
|
||
---
|
||
|
||
## 方法说明
|
||
|
||
### `parse`
|
||
|
||
```typescript
|
||
function parse(text: string, width: number): ITextContentRenderObject;
|
||
```
|
||
|
||
解析文本并生成渲染数据对象：
|
||
|
||
```typescript
|
||
interface ITextContentRenderObject {
|
||
lineHeights: number[]; // 每行高度
|
||
lineWidths: number[]; // 每行宽度
|
||
data: ITextContentRenderable[]; // 渲染元素集合
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 转义字符语法说明
|
||
|
||
### 1. 颜色控制 `\r[color]`
|
||
|
||
- **语法**：`\r[颜色值]`
|
||
- **栈模式**：支持嵌套，用`\r`恢复上一级颜色
|
||
- **颜色格式**：支持 CSS 颜色字符串
|
||
|
||
```typescript
|
||
// 示例：红→黄→红→默认
|
||
'\\r[red]危险！\\r[yellow]警告\\r恢复红色\\r默认';
|
||
```
|
||
|
||
### 2. 字号控制 `\c[size]`
|
||
|
||
- **语法**：`\c[字号(px)]`
|
||
- **栈模式**：用`\c`恢复上一级字号
|
||
|
||
```typescript
|
||
// 示例：24px→32px→24px
|
||
'普通\\c[24]标题\\c[32]超大标题\\c恢复';
|
||
```
|
||
|
||
### 3. 字体家族 `\g[family]`
|
||
|
||
- **语法**：`\g[字体名称]`
|
||
- **栈模式**：用`\g`恢复上一级字体
|
||
|
||
```typescript
|
||
'默认\\g[黑体]中文黑体\\g恢复默认';
|
||
```
|
||
|
||
### 4. 粗体切换 `\d`
|
||
|
||
- **语法**：`\d`（开关模式）
|
||
|
||
```typescript
|
||
'正常\\d粗体\\d正常';
|
||
```
|
||
|
||
### 5. 斜体切换 `\e`
|
||
|
||
- **语法**：`\e`（开关模式）
|
||
|
||
```typescript
|
||
'正常\\e斜体\\e正常';
|
||
```
|
||
|
||
### 6. 等待间隔 `\z[wait]`
|
||
|
||
- **语法**：`\z[等待字符数]`
|
||
- **计算规则**：`间隔时间 = 字符数 * 当前interval配置`
|
||
|
||
```typescript
|
||
'开始对话\\z[10]（暂停500ms）继续';
|
||
```
|
||
|
||
### 7. 图标嵌入 `\i[icon]`
|
||
|
||
- **语法**：`\i[图标ID]`
|
||
- **图标规范**：需预加载到资源管理器
|
||
|
||
```typescript
|
||
'攻击\\i[sword]造成伤害';
|
||
```
|
||
|
||
### 8. 表达式 `${}`
|
||
|
||
- **语法**：与模板字符串语法一致，不过是在渲染的时候实时计算，而非字符串声明时计算
|
||
|
||
```typescript
|
||
'${core.status.hero.atk * 10}'; // 显示勇士攻击乘 10
|
||
'${core.status.hero.atk > 100 ? "高攻击" : "低攻击"}'; // 条件表达式
|
||
'${(() => { if (a > 10) return 100; else return 10; })()}'; // 嵌入函数
|
||
```
|
||
|
||
---
|
||
|
||
## 综合使用示例
|
||
|
||
### 战斗伤害提示
|
||
|
||
```typescript
|
||
const text =
|
||
'\\r[#ff0000]\\c[24]\\d敌人\\i[monster]对你造成\\c[32]\\r[yellow]500\\c\\r伤害！\\z[5]\\d\\e（按空格跳过）';
|
||
|
||
const result = parser.parse(text, 400);
|
||
|
||
/* 解析结果：
|
||
[
|
||
{ type: 'text', color: '#ff0000', size:24, bold:true, text:'敌人' },
|
||
{ type: 'icon', id:'monster' },
|
||
{ type: 'text', color:'#ff0000', size:24, text:'对你造成' },
|
||
{ type: 'text', color:'yellow', size:32, text:'500' },
|
||
{ type: 'text', color:'#ff0000', size:24, text:'伤害！' },
|
||
{ type: 'wait', duration:250 }, // 假设 interval=50
|
||
{ type: 'text', bold:false, italic:true, text:'（按空格跳过）' }
|
||
]
|
||
*/
|
||
```
|
||
|
||
### 多语言混合排版
|
||
|
||
```typescript
|
||
const multiLangText =
|
||
'\\g[Times New Roman]Hello\\g[宋体]你好\\i[globe]\\z[3]\\g切换为\\r[blue]Français';
|
||
|
||
// 效果：英文→中文+地球图标→等待→蓝色法文
|
||
```
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
1. **转义字符格式**
|
||
|
||
- 必须使用 **双反斜杠**（`\\`）表示转义
|
||
- 错误示例：`\r[red]`（单反斜杠 `\r` 可能会被识别为换行）
|
||
- 正确示例：`\\r[red]`
|
||
|
||
2. **栈操作规则**
|
||
|
||
```typescript
|
||
// 颜色栈示例
|
||
'默认\\r[red]红\\r[blue]蓝\\r恢复红\\r恢复默认';
|
||
// 等效于：push(默认)→push(红)→push(蓝)→pop→pop
|
||
```
|