DreamGUI
类参考

FDreamTextStyle

FDreamTextStyle

声明于 Public/Core/DreamUITextData.h。

内置着色器如何在普通字形面之外绘制文本的字形:描边、底层(投影)、发光,以及歌词行中未填充部分的外观。长度单位为 em,因此样式在任何字体大小下读起来都一致。只有距离场字体(MTSDF)才能渲染这些效果;位图字体只绘制字形面。

样式按控件存储在画布的控件属性纹理中,因此不同样式的文本仍能合批到一次绘制中。

属性

名称类型分类在细节面板中可从蓝图访问描述
FaceSoftnessfloat字形面是读 / 写以 em 为单位的额外边缘柔和度(模糊)。0 绘制出锐利的边缘。每个字形各自柔化,因此超过约 0.05 em 后,相邻字形的光晕会明显融合;整行的真正模糊属于后处理工作,而非样式。
FaceDilatefloat字形面是读 / 写以 em 为单位放大(正值)或收缩(负值)字形面。
OutlineColorFColor描边是读 / 写描边颜色;alpha 为 0 表示无描边。
OutlineWidthfloat描边是读 / 写字形面外侧的描边宽度,以 em 为单位。
OutlineSoftnessfloat描边是读 / 写描边边缘柔和度,以 em 为单位。
UnderlayColorFColor底层是读 / 写底层(投影)颜色;alpha 为 0 表示无底层。
UnderlayOffsetFVector2f底层是读 / 写以 em 为单位的底层偏移;+Y 向下。
UnderlaySoftnessfloat底层是读 / 写底层边缘柔和度,以 em 为单位。
UnderlayDilatefloat底层是读 / 写以 em 为单位将底层扩展到字形面之外。
GlowColorFColor发光是读 / 写发光颜色;alpha 缩放发光的强度,0 表示无发光。
GlowWidthfloat发光是读 / 写发光延伸到字形面之外的距离,以 em 为单位。每个延伸距离都被限制在字体的场所能容纳的范围内(SDFRadius / SampleFontSize em),因此更宽的发光需要具有更大扩散范围的字体。
GlowPowerfloat发光是读 / 写发光衰减指数;越高则发光越贴近字形面。
FillDimAlphafloat填充是读 / 写字形串中填充进度尚未到达的部分的 alpha(歌词)。
FillFadeWidthfloat填充是读 / 写点亮/未点亮过渡的宽度,作为整个串的比例,0..1。
FacePaintFDreamTextPaint绘制是读 / 写用渐变而非文本颜色填充字形面,如同 CSS 的 background-clip: text 搭配 color: transparent 那样:字形面是渐变乘以内容着色(自定义样式的 Multiply 和 TextAnimation 的颜色),并且不使用文本自身的 Color。其中 串保持实心,悬停的链接也是如此。Emoji 保留其颜色。适用于各种字形——距离场、小文本覆盖、位图——以及下划线和删除线;由内置着色器和基于 MF_DreamUI_Shade 构建的材质绘制,对于任何其他材质则在顶点颜色中近似。
OutlinePaintFDreamTextPaint绘制是读 / 写用渐变填充描边,乘以 OutlineColor(白色则原样显示渐变)。需要描边:OutlineColor 的 alpha 和 OutlineWidth。
OverlayPaintFDreamTextPaint绘制是读 / 写一个混合到字形面上的渐变,实心或绘制,如 OverlayBlend 所述:一条高光带,UDreamText::SetOverlayPaintPhase 使其在文本上移动。
OverlayBlendEDreamTextOverlayBlend绘制是读 / 写
PaintBoxHorizontalEDreamTextPaintBox绘制是读 / 写文本的绘制是以什么为基准测量的,横向和纵向;两者都以文本作为块,即 CSS 的 background box,为默认值。
PaintBoxVerticalEDreamTextPaintBox绘制是读 / 写

本页目录