类参考
FDreamTextStyle
FDreamTextStyle
声明于 Public/Core/DreamUITextData.h。
内置着色器如何在普通字形面之外绘制文本的字形:描边、底层(投影)、发光,以及歌词行中未填充部分的外观。长度单位为 em,因此样式在任何字体大小下读起来都一致。只有距离场字体(MTSDF)才能渲染这些效果;位图字体只绘制字形面。
样式按控件存储在画布的控件属性纹理中,因此不同样式的文本仍能合批到一次绘制中。
属性
| 名称 | 类型 | 分类 | 在细节面板中 | 可从蓝图访问 | 描述 |
|---|---|---|---|---|---|
FaceSoftness | float | 字形面 | 是 | 读 / 写 | 以 em 为单位的额外边缘柔和度(模糊)。0 绘制出锐利的边缘。每个字形各自柔化,因此超过约 0.05 em 后,相邻字形的光晕会明显融合;整行的真正模糊属于后处理工作,而非样式。 |
FaceDilate | float | 字形面 | 是 | 读 / 写 | 以 em 为单位放大(正值)或收缩(负值)字形面。 |
OutlineColor | FColor | 描边 | 是 | 读 / 写 | 描边颜色;alpha 为 0 表示无描边。 |
OutlineWidth | float | 描边 | 是 | 读 / 写 | 字形面外侧的描边宽度,以 em 为单位。 |
OutlineSoftness | float | 描边 | 是 | 读 / 写 | 描边边缘柔和度,以 em 为单位。 |
UnderlayColor | FColor | 底层 | 是 | 读 / 写 | 底层(投影)颜色;alpha 为 0 表示无底层。 |
UnderlayOffset | FVector2f | 底层 | 是 | 读 / 写 | 以 em 为单位的底层偏移;+Y 向下。 |
UnderlaySoftness | float | 底层 | 是 | 读 / 写 | 底层边缘柔和度,以 em 为单位。 |
UnderlayDilate | float | 底层 | 是 | 读 / 写 | 以 em 为单位将底层扩展到字形面之外。 |
GlowColor | FColor | 发光 | 是 | 读 / 写 | 发光颜色;alpha 缩放发光的强度,0 表示无发光。 |
GlowWidth | float | 发光 | 是 | 读 / 写 | 发光延伸到字形面之外的距离,以 em 为单位。每个延伸距离都被限制在字体的场所能容纳的范围内(SDFRadius / SampleFontSize em),因此更宽的发光需要具有更大扩散范围的字体。 |
GlowPower | float | 发光 | 是 | 读 / 写 | 发光衰减指数;越高则发光越贴近字形面。 |
FillDimAlpha | float | 填充 | 是 | 读 / 写 | 字形串中填充进度尚未到达的部分的 alpha(歌词)。 |
FillFadeWidth | float | 填充 | 是 | 读 / 写 | 点亮/未点亮过渡的宽度,作为整个串的比例,0..1。 |
FacePaint | FDreamTextPaint | 绘制 | 是 | 读 / 写 | 用渐变而非文本颜色填充字形面,如同 CSS 的 background-clip: text 搭配 color: transparent 那样:字形面是渐变乘以内容着色(自定义样式的 Multiply 和 TextAnimation 的颜色),并且不使用文本自身的 Color。其中 串保持实心,悬停的链接也是如此。Emoji 保留其颜色。适用于各种字形——距离场、小文本覆盖、位图——以及下划线和删除线;由内置着色器和基于 MF_DreamUI_Shade 构建的材质绘制,对于任何其他材质则在顶点颜色中近似。 |
OutlinePaint | FDreamTextPaint | 绘制 | 是 | 读 / 写 | 用渐变填充描边,乘以 OutlineColor(白色则原样显示渐变)。需要描边:OutlineColor 的 alpha 和 OutlineWidth。 |
OverlayPaint | FDreamTextPaint | 绘制 | 是 | 读 / 写 | 一个混合到字形面上的渐变,实心或绘制,如 OverlayBlend 所述:一条高光带,UDreamText::SetOverlayPaintPhase 使其在文本上移动。 |
OverlayBlend | EDreamTextOverlayBlend | 绘制 | 是 | 读 / 写 | |
PaintBoxHorizontal | EDreamTextPaintBox | 绘制 | 是 | 读 / 写 | 文本的绘制是以什么为基准测量的,横向和纵向;两者都以文本作为块,即 CSS 的 background box,为默认值。 |
PaintBoxVertical | EDreamTextPaintBox | 绘制 | 是 | 读 / 写 |