插件参考Guides
常见陷阱
那些看起来像 bug 其实并不是、或者能白白耗掉一下午的问题——同一属性上的补间、角度约定、射线检测目标、颜色字面量、样式覆盖、字体、世界空间控件、组内的效果、像素化强度、离屏录制,以及 UMG 命名不同之处——每项都附有讲解它的页面。
每条都说明你看到的现象、原因以及该怎么做;它链接到的页面有详细说明。
动画
- 先淡入,再反向淡出,结果闪烁或结束得不对。 同一属性上的两个补间过去会同时运行。现在补间启动时会停止同一属性上更早的补间;
SetReplacesEarlierTweens(false)可以让某个补间不受此限(例如一个应与悬停共存的循环呼吸效果)。序列中的补间永远不会被停止。每个属性一个补间。 - 面板中的控件不会停留在
AnchoredPositionTo设置的位置。 面板会把位置写回去。请移动绘制内容:RenderOffsetTo、RenderScaleTo、RenderRotationTo、RenderPoseTo。面板内的控件。 - 正的 roll 会让控件顺时针旋转。
RenderRotation.Roll、SetRenderTransformAngle和RenderAngleTo会让控件在屏幕上顺时针旋转(其右边缘向下),与 UMG 的角度一致。
角度
- 各角度属性的零点并不相同。
Ring从三点钟方向起算,逆时针;Native.RingMenu、Native.ProgressBar以及路径上的文本从十二点钟方向起算,顺时针。Ring上的进度环是StartAngle = 90、EndAngle = 90 - 360 * progress。角度约定。
输入
- 按钮上的标签不接收悬停或点击。 没错:
UDreamText默认不是射线检测目标。如果文本本身就是要按的东西,请设置bRaycastTarget = true。视觉内容。 - 在
Widget节点上使用bRaycastTarget是错误的。 它属于视觉内容。请在控件上写Raycastable = Disabled。属性与值。 - 手柄选中的按钮什么都不显示。 可选中控件在拥有焦点时会穿上其 Hovered 外观作为过渡,除非 Use Focused Visuals 为焦点提供了单独的外观。由你自己的代码从
OnSelectionStateChanged绘制的外观收到的是Focused,而不是Hovered:在那里请把两者画得一样。 - 由代码驱动的导航不产生移动。 在同一帧内给出的按下和松开永远不会经历方向按下的那一帧。请调用
TapNavigation,它会在下一帧走一步;对于逐帧录制的录像,请打开事件系统的 Navigation Repeat In Game Time,否则按住的方向会按真实时间重复并跑在前面。 - 在控件的 construct 中请求焦点。 该帧才显示的控件要到下一帧才获得焦点;在此期间
SetKeyboardFocus返回 false,所以不要把该返回值当作最终结果。
.dui 语言
Style.X = v不起任何作用。 只有当StyleSource为Inline(或没有样式表)时,才会使用实例的Style,或者在使用ProjectStyleSheetOverride且勾选了该字段的bOverride_X时。.dui从不改动这些位,而它们初始就是勾选状态。在 .dui 中与运行时。: A : B会在A之上应用B,同一个名称出现两次是一条警告。 样式从左到右应用,先应用基样式,每个样式只在其首次出现时应用一次;节点自身的行最后应用。命名一个更早的样式已经应用过的样式不会有任何改变,只会产生 DUI3025。多个样式。@slot Size <- F()是错误。Size是MinDesiredSize与MaxDesiredSize取同一个值时的简写,因此它只接受=;请分别绑定这两个属性(DUI4001)。@slot Size。@tag Trim是标签,@tag Trim { }是节点。@tag之后的名称是标签行,除非其后跟着一个块、一个:或一个(was: …),此时它就成为旧式@Name形式的节点,其类型由名为tag的资源指定。在style中或直接位于for主体中的标签行是 DUI2024。标签。- 本应溢出其卡片的辉光在声明之前仍然是 DUI8008。
layout会报告绘制超出其面板的内容,以及绘制在文本之上的内容。有意执行其中任一行为的装饰采用@tag Bleed;并非有意为之的装饰则放在内部,或放在文件中的文本之前。越过边框。 - 环形菜单的项写在
.dui中。Items = [{ "Lamp", Tag: Lamp }, …]:每个项一个映射,标签放在最前面且不带其键。在其他任何地方、或在不带主字段的结构体上书写不带键的映射,都是 DUI4009。作为字段映射的结构体。 - 环形菜单的模板内容居中于其扇区,而不是拉伸铺满它。 它采用其类的根节点在创作时设定的大小,或者当根节点拉伸时,采用样式在
ContentRadius处的ContentWidth方形大小。要让根节点拥有自己的大小,请为其设置固定锚点。环形菜单。 #8C8C94比看起来更暗。 颜色字面量采用 sRGB 编码,而着色是在线性空间中相乘的。值。AnchoredPosition的正 Y 值会让节点向上移动,而(0, 0)锚点位于左下角。 Y 向上为正,与 Unity 一致。在RenderTranslation中 X 表示深度:(-40, 0, 0)让节点更靠近并绘制得更大;(0, -40, 0)将它向左移动。RenderRotation是(Pitch, Yaw, Roll)。位置、尺寸和轴。- 在文本上写
VAlign = Center是错误,写@slot VerticalAlignment = Middle同样是错误。 文本自身的对齐写Middle(Top、Middle、Bottom);槽位的对齐写Center(Top、Center、Bottom、Fill)。错误信息会指出正确的那个。 CornerRadius = (24, 24, 24, 24)绘制的是胶囊形,而不是 24 px 的圆角。 半径默认是分数(CornerRadiusUnitMode = Percentage,1 表示将圆角完全圆化);要按像素表示则写CornerRadiusUnitMode = Value。- 矩形块的圆角会出现在错误的位置。 它的
CornerRadius顺序是右下、右上、左上、左下(与ClippingCornerRadius相同),而不是从左上角开始顺时针:一个底部为圆角的盾形应写作(22, 6, 6, 22)。 - 将
Text = "Hello" @slot HorizontalAlignment = Fill写在一行内会得到 DUI2001。 紧跟在值后面的@会被当作该值的注解(@key、@note、@max、@noloc)。请用;结束该值,或者另起一行:Text = "Hello"; @slot HorizontalAlignment = Fill。 Padding = (@Gap, 0, @Gap, 0)会得到 DUI4003。 资源代表的是整个值,绝不能代表元组中的某一部分。请写出数值,或者为整个值命名。- 一个
Color属性无法驱动BodyColor(DUI5004)。props颜色是线性颜色,而视觉元素的Color和矩形块的BodyColor则不是;二者都不能绑定到它。改为显示正确的部分:每种颜色一个节点,每个节点在Integer属性上使用Shown <- Rarity == 2,或在String属性上使用Shown <- Kind == "Rare"。
文本与字体
- 本应显示中文、日文或韩文的地方出现方框,或者什么都不显示。 字体没有该字符的字形,DreamGUI 会记录一次警告来指出它。默认字体通过
/DreamGUI/DefaultFont_DistanceField_CJK覆盖这些字符;自己的字体需要提供回退字体。字体。 - 字形笔画交叉处出现缺口或接缝。 字体文件会将这些笔画保留为相互重叠的轮廓——从可变字体裁剪出的静态实例也是如此,除非已移除其重叠部分——而 DreamGUI 曾记录过一次警告并指出了该字形。用 fontTools 的
removeOverlaps处理该文件并使用处理后的结果。Fonts。 - 控件的文本字体不对。 带有
Font字段的样式:文本输入框、数值微调框、富文本、可展开区域、环形菜单。样式。
布局与世界空间
- 在 1280 x 720 下,整个屏幕被绘制得大了好几倍,或者超出屏幕。 围绕 1920 x 1080 设计画布的
ScaleBox会按其中的内容来测量画布,而不是按其SizeDelta,再把该结果放大。请同时给画布设置@slot Size = (1920, 1080)。屏幕的根节点。 - 一个短标签、一个 chip 或一个键帽宽 100 px。 每个节点初始都是 100 x 100(
AnchorData.SizeDelta),而按子节点调整自身大小的 box 或 overlay 会把这个尺寸计算在内——包括填充 overlay 的背景。请给应按内容测量尺寸的节点设置AnchorData.SizeDelta = (0, 0);预设中的ui.FillSlot正是这样做的。 - 宿主放入组件槽位的内容会溢出槽位。 没有布局盒的槽位(
slot Badge { })会按自身尺寸、用锚点来放置放入其中的内容。请给该控件设置ui.FillParent(锚点位于四个角)。 - 垂直框中某一行的文本会每行只显示一个字母。 垂直框会按子节点自身测量的宽度为其分配宽度,而
SizeDelta宽度为 0 的节点测量结果就是 0,因此它的文本会在每个字符之后换行。在该行上(或它的样式中)写@slot HorizontalAlignment = Fill,或者给它指定一个宽度。位置、尺寸和轴。 - 展开或增长的列表绘制到面板之外。 面板不会裁剪。请使用
ScrollBox,或Clipping = ClipToBounds。面板。 - 世界空间面板偏离了它的 actor。 组件的
Pivot和尺寸应设置在用户控件上;给该类的根节点设置从(0, 0)到(1, 1)的锚点,并且不要给它自身的尺寸。世界空间 UI。 - **本应朝向屏幕中央的面板却背向中央。**正的 Yaw 会使节点的右边缘更近,正的 Pitch 会使节点的上边缘更近,因此符号方向与第一直觉相反:左侧的面板用负 Yaw 朝向中央,右侧的面板用正 Yaw 朝向中央;像桌面一样后仰的平面使用负 Pitch;一排朝玩家弯曲的卡片,其 Yaw 从左侧的负值过渡到右侧的正值,两端处最大。
layout和preview说明每个旋转后的面在绘制时朝向哪边(Panel RosterLeft, on the left: turned 14 degrees: faces toward the screen centre (right edge farther));每次旋转后都要读取该行。在 3D 中旋转。
// DUI/Pitfalls/Facing.dui
class /Game/UI/Pitfalls/WBP_Facing
use "Theme.dui" as ui
// The three turns, with their signs: a positive Yaw brings a node's right edge nearer, a positive Pitch its top edge.
style Side {
AnchorData.AnchorMin = (0.5, 0.5)
AnchorData.AnchorMax = (0.5, 0.5)
AnchorData.Pivot = (0.5, 0.5)
AnchorData.SizeDelta = (360, 280)
}
style ArcCard : ui.Card {
@slot Size = (100, 150)
}
Widget Root : ui.FillParent {
RectBlock Backdrop : ui.ScreenBackdrop : ui.FillParent
// Two panels that face the middle: on the left a negative Yaw, on the right a positive one.
RectBlock FacingLeft : ui.Panel : Side {
AnchorData.AnchoredPosition = (-620, 160)
RenderRotation = (0, -16, 0)
}
RectBlock FacingRight : ui.Panel : Side {
AnchorData.AnchoredPosition = (620, 160)
RenderRotation = (0, 16, 0)
}
// A plane laid back, its far (top) edge narrower: a negative Pitch.
RectBlock Table : ui.Panel : Side {
AnchorData.AnchoredPosition = (0, -250)
AnchorData.SizeDelta = (720, 300)
RenderRotation = (-35, 0, 0)
}
// Cards that curve toward the player: negative left of the middle, positive right of it, the ends turned most.
HorizontalBox Arc : Side {
Spacing = 20
AnchorData.AnchoredPosition = (0, 160)
AnchorData.SizeDelta = (580, 150)
RectBlock CardA : ArcCard { RenderRotation = (0, -24, 0) }
RectBlock CardB : ArcCard { RenderRotation = (0, -12, 0) }
RectBlock CardC : ArcCard { RenderTranslation = (-20, 0, 0) }
RectBlock CardD : ArcCard { RenderRotation = (0, 12, 0) }
RectBlock CardE : ArcCard { RenderRotation = (0, 24, 0) }
}
}渲染
- 位于淡出或遮罩容器内的模糊会变成一片平灰。 组(
GroupOpacity、GroupMask……)会单独绘制,其中的背景效果只能看到该组。请把模糊放到外面,并用StrengthMap塑造它。在图层组内。 - 我自己的材质忽略了裁剪或遮罩过渡。 请通过
MF_DreamUI_Shade着色。裁剪遮罩。 - 像素化淡出先是很快,然后变得很慢。 强度并不是块大小。像素化强度。
代码
- 用
NativeOnDestruct,而不是NativeDestruct。 用户控件的 C++ 虚函数有自己的名字,而且GetWorld()在NativeOnInitialized中可能为 null;请使用NativeOnConstruct。实例的生命周期。