DreamGUI
类参考

FDreamUIWidgetGeometry

FDreamUIWidgetGeometry

声明于 Public/DreamUIWidgetGeometryLibrary.h。

控件的测量矩形,也是下文所有坐标转换都要经由的句柄——本框架对 Slate 的 FGeometry 给出的答案。

FGeometry 在这里派不上用场:它描述的是 SWidget 在 Slate 窗口中的位置,而 DreamGUI 控件是场景中的一个网格体,未必位于窗口上。调用者真正想从中得到的是下面保存的两样东西——控件以其自身单位表示的大小,以及它的矩形落在视口像素中的位置——再加上一种在这些空间之间移动点的方式,这正是该库所做的事。

三个空间,命名方式与 UMG 相同:

  • LOCAL:控件自身的 2D 空间,原点在其左下角,X 向右,Y 向上,单位为控件单位。之所以采用左下角而非 Slate 的左上角,是因为本框架中所有其他归一化坐标(AnchorData.Pivot、RenderTransformPivot、画布自身的转换)都已将零点放在左下角,在分支内保持一致胜过在某一轴上与另一个引擎保持一致。
  • ABSOLUTE:视口像素,原点为左上角——与鼠标位置传入时所用的数值相同,也与 UDreamCanvas::ConvertPositionFromCanvasToViewport 生成的坐标空间相同。Slate 的“absolute”是桌面像素;在游戏视口中,两者仅相差窗口自身的位置,本框架中没有任何东西会用到它。
  • VIEWPORT:absolute 除以 DPI 缩放,也就是 UMG 的 LocalToViewport 连同像素位置一并返回的值。

对于矩形完全无法放置在视口中的控件,bHasAbsolute 为 false——例如没有玩家相机可投射的世界空间画布、尚未位于画布下的控件、位于视点之后的点。在所有相同的情况下,每个转换都会返回 false,而不是从错误的空间返回一个看似合理的数值。

Properties

NameTypeCategoryIn the details panelFrom BlueprintDescription
WidgetTWeakObjectPtr<UDreamWidget>DreamGUIGeometry-read only
LocalSizeFVector2DDreamGUIGeometry-read only
AbsolutePositionFVector2DDreamGUIGeometry-read only
AbsoluteSizeFVector2DDreamGUIGeometry-read only
bHasAbsoluteboolDreamGUIGeometry-read only

本页目录