工程级表达式设置｜全局 VAL / GEN / BRE 默认值
什么是工程级表达式
OpenUtau 里表达式有三层：
- 偏好设置级（Preferences）→ 所有新建工程的默认值
- 工程级（Tools → Expressions）→ 当前工程的默认值
- 音符级（Piano Roll 每个音符）→ 单个音符的实际值
优先级：音符级 > 工程级 > 偏好设置级。改工程级值会影响所有没手动改过表达式的音符，已经手动改过的音符不受影响。
打开表达式管理
Tools → Expressions 打开表达式管理窗口。里面可以：
- 查看当前工程所有表达式列表
- 添加 / 删除表达式
- 修改表达式属性（名称、缩写、flags、范围、默认值）
- 设置工程级默认值
齿轮图标 = 整体工程设置
Piano Roll 底部表达式面板旁边有个齿轮图标（或 Tools → Expressions 里的每个表达式条目），点开能设工程默认值。
比如把 BRE（气声）的工程默认值设为 +10——新建的所有音符都会自动有 +10 的气声，不用手动调。已经写好的音符如果之前没手动改过 BRE，也会跟着变成 +10。
添加自定义表达式
除了 OpenUtau 内置的表达式（VEL / VOL / GENC / BREC 等），还可以加自定义表达式：
- Tools → Expressions → 左下角 +
- 填表达式属性：
- Name：显示名称（如 "Custom Flag 1"）
- Abbr：缩写（如 "CF1"，Piano Roll 里显示）
- Flag：对应的重采样器 flag（如
C，重采样器渲染时识别） - Min / Max：最小值 / 最大值
- Default：默认值
- 点 Add
加完后新表达式会出现在 Piano Roll 底部的表达式切换列表里。
两种表达式类型
| 类型 | 说明 | 适合场景 |
|---|---|---|
| 数值型（Numerical） | 有 min / max / default，每个音符一个数值 | GENC / VOL / VEL 这种连续值参数 |
| 选项型（Options） | 有勾选框和选项值，用于不带数字的 flags | 比如 e 这种只能 on/off 的 flag |
选项型表达式示例：Name "Legato"、Abbr "LG"、Checkbox 勾选、Option Values ,e（空 = 不选，选了 = 加 e flag）。
多 resampler 的 ENG 表达式
ENG（Resampler Engine）表达式可以让你在 Piano Roll 里按音符切换重采样器——这是非常强大的功能。
设置步骤：
- Tools → Expressions → 选 ENG
- Options 字段里填：
,重采样器1.exe,重采样器2.exe,重采样器3.exe
- 第一个空 = 回退到齿轮图标选的默认重采样器
- 后面逗号分隔每个重采样器的文件名（不是路径）
- 重采样器文件必须已经在 Resamplers 文件夹里
- 保存
然后在 Piano Roll 里：
- ENG 表达式的值 0 = 空（回退默认）
- 值 1 = 重采样器1.exe
- 值 2 = 重采样器2.exe
- 值 3 = 重采样器3.exe
工程级表达式常见用法
用法一：全工程统一 BRE / GENC 默认
新建工程后，想让所有音符默认带一点气声（BRE +5），去 Tools → Expressions → BRE → Default 值设 5。新建音符自动继承，已写音符如果之前没调过 BRE 也会一起变。
用法二：加一个自定义 flag
你用的重采样器（比如 moresampler）支持一个 OpenUtau 默认没有的 flag Mt（massage time），想加进来：
- Tools → Expressions → +
- Name = "Massage Time"、Abbr = "Mt"、Flag = "Mt"、Min = 0、Max = 100、Default = 0
- 加完就能在 Piano Roll 里调这个 flag 了
用法三：多个重采样器快速切换
ENG 表达式 Options 里填多个重采样器文件名，Piano Roll 里改 ENG 值就能切——比如主旋律用 moresampler、低音部用 worldline64，同一个轨道里不同音符用不同重采样器。
常见问题
问题：工程级默认值改了，已写音符不变
只有没手动改过的音符才会被工程级默认值覆盖。如果你之前手动把某个音符的 BRE 调成 +20，那改工程级 BRE 默认值不会影响那个音符。这是"手动值 > 工程级值"的设计。
想让手动改过的音符也跟着工程级变：选中那些音符 → 在 Piano Roll 里右键该表达式 → Reset to Project Default。
问题：加的表达式在 Piano Roll 里没有
加完表达式后，可能需要关掉再打开 Piano Roll 才能看到新表达式出现在底部的切换列表里。或者在表达式面板里手动添加 renderer 建议的表达式（特别是 DiffSinger 引擎的 VELC / ENE / PEXP 等曲线）。
问题：ENG 表达式里的重采样器文件名写错了
重采样器文件名必须完全匹配（大小写、扩展名、路径子文件夹）：
- 正确：
,moresampler.exe,strashkat-rs.exe - 错误：
,moresampler,resampler.exe（拼写错误，没 .exe 后缀） - 带子文件夹：
,clean\moresampler.exe（如果重采样器在 Resamplers/clean/ 子目录里）
ENG 表达式解析不会自动找文件，你填什么它就用什么——填错了重采样器找不到就静音或报错。