Implement runtime UI workflow and editor integration

Resources/Editor/Shaders/Gizmo.ovfx

@@ -21,7 +21,9 @@ out VS_OUT
 
 uniform bool u_IsBall;
 uniform bool u_IsPickable;
+uniform int u_VisibleAxes;
 uniform int u_HighlightedAxis;
+uniform float u_GizmoScale;
 
 mat4 rotationMatrix(vec3 axis, float angle)
 {
@@ -41,6 +43,17 @@ mat4 rotationMatrix(vec3 axis, float angle)
 
 void main()
 {
+	/* Instances are ordered Z, X, Y, while axis bits are ordered X, Y, Z */
+	int axisBit = gl_InstanceID == 1 ? 1 : (gl_InstanceID == 2 ? 2 : 4);
+
+	/* The ball is drawn with a single instance and isn't tied to an axis */
+	if (!u_IsBall && (u_VisibleAxes & axisBit) == 0)
+	{
+		vs_out.Color = vec3(0.0f);
+		gl_Position = vec4(2.0f, 2.0f, 2.0f, 1.0f);
+		return;
+	}
+
     mat4 instanceModel = ubo_Model;
 
     if (gl_InstanceID == 1) 
@@ -49,10 +62,11 @@ void main()
         instanceModel *= rotationMatrix(vec3(1, 0, 0), radians(90)); /* Y axis */
 
     float distanceToCamera = distance(ubo_ViewPos, instanceModel[3].xyz);
+	float gizmoScale = u_GizmoScale > 0.0 ? u_GizmoScale : distanceToCamera * 0.1f;
 
 	vec3 pos = geo_Pos;
 
-    vec3 fragPos = vec3(instanceModel * vec4(pos * distanceToCamera * 0.1f, 1.0));
+    vec3 fragPos = vec3(instanceModel * vec4(pos * gizmoScale, 1.0));
 
 	if (u_IsPickable)
 	{
@@ -110,4 +124,4 @@ uniform bool u_IsPickable;
 void main()
 {
 	FRAGMENT_COLOR = vec4(fs_in.Color, 1.0f);
-}
+}

Resources/Engine/Lua/Components/Canvas.lua

@@ -0,0 +1,63 @@
+---@meta
+
+--- Defines how a Canvas scales UI elements
+---@enum CanvasScalerMode
+CanvasScalerMode = {
+	CONSTANT_PIXEL_SIZE = 0,
+	SCALE_WITH_SCREEN_SIZE = 1
+}
+
+---@enum CanvasScreenMatchMode
+CanvasScreenMatchMode = {
+	MATCH_WIDTH_OR_HEIGHT = 0,
+	EXPAND = 1,
+	SHRINK = 2
+}
+
+--- Represents a root canvas for in-game user interface elements
+---@class Canvas : Component
+Canvas = {}
+
+--- Returns the actor that owns this component
+---@return Actor
+function Canvas:GetOwner() end
+
+--- Returns the reference resolution used by the canvas
+---@return Vector2
+function Canvas:GetReferenceResolution() end
+
+--- Defines the reference resolution used by the canvas
+---@param referenceResolution Vector2
+function Canvas:SetReferenceResolution(referenceResolution) end
+
+--- Returns the canvas scale factor
+---@return number
+function Canvas:GetScaleFactor() end
+
+--- Defines the canvas scale factor
+---@param scaleFactor number
+function Canvas:SetScaleFactor(scaleFactor) end
+
+--- Returns the canvas scaler mode
+---@return CanvasScalerMode
+function Canvas:GetScalerMode() end
+
+--- Defines the canvas scaler mode
+---@param scalerMode CanvasScalerMode
+function Canvas:SetScalerMode(scalerMode) end
+
+--- Returns the screen match mode used with SCALE_WITH_SCREEN_SIZE
+---@return CanvasScreenMatchMode
+function Canvas:GetScreenMatchMode() end
+
+--- Defines the screen match mode used with SCALE_WITH_SCREEN_SIZE
+---@param screenMatchMode CanvasScreenMatchMode
+function Canvas:SetScreenMatchMode(screenMatchMode) end
+
+--- Returns the match width/height factor in range [0, 1]
+---@return number
+function Canvas:GetMatchWidthOrHeight() end
+
+--- Defines the match width/height factor in range [0, 1]
+---@param value number
+function Canvas:SetMatchWidthOrHeight(value) end

Resources/Engine/Lua/Components/HorizontalLayout.lua

@@ -0,0 +1,9 @@
+---@meta
+
+--- Arranges direct user interface children horizontally
+---@class HorizontalLayout : LayoutGroup
+HorizontalLayout = {}
+
+--- Returns the actor that owns this component
+---@return Actor
+function HorizontalLayout:GetOwner() end

Resources/Engine/Lua/Components/Image.lua

@@ -0,0 +1,41 @@
+---@meta
+
+--- Represents a renderable user interface image
+---@class Image : Component
+Image = {}
+
+--- Returns the actor that owns this component
+---@return Actor
+function Image:GetOwner() end
+
+--- Returns the texture rendered by the image
+---@return Texture|nil
+function Image:GetTexture() end
+
+--- Defines the texture rendered by the image
+---@param texture Texture|nil
+function Image:SetTexture(texture) end
+
+--- Returns the image display size stored by Transform UI data
+---@return Vector2
+function Image:GetSize() end
+
+--- Defines the image display size stored by Transform UI data
+---@param size Vector2
+function Image:SetSize(size) end
+
+--- Returns the image tint
+---@return Vector4
+function Image:GetTint() end
+
+--- Defines the image tint
+---@param tint Vector4
+function Image:SetTint(tint) end
+
+--- Returns whether the image keeps its intrinsic aspect ratio when resized
+---@return boolean
+function Image:GetPreserveAspect() end
+
+--- Defines whether the image keeps its intrinsic aspect ratio when resized
+---@param preserveAspect boolean
+function Image:SetPreserveAspect(preserveAspect) end

Resources/Engine/Lua/Components/LayoutGroup.lua

@@ -0,0 +1,102 @@
+---@meta
+
+--- Defines how a LayoutGroup arranges direct UI children
+---@enum LayoutDirection
+LayoutDirection = {
+	HORIZONTAL = 0,
+	VERTICAL = 1
+}
+
+---@enum LayoutHorizontalAlignment
+LayoutHorizontalAlignment = {
+	LEFT = 0,
+	CENTER = 1,
+	RIGHT = 2
+}
+
+---@enum LayoutVerticalAlignment
+LayoutVerticalAlignment = {
+	TOP = 0,
+	CENTER = 1,
+	BOTTOM = 2
+}
+
+--- Arranges direct user interface children along an axis
+---@class LayoutGroup : Component
+LayoutGroup = {}
+
+--- Returns the actor that owns this component
+---@return Actor
+function LayoutGroup:GetOwner() end
+
+--- Returns the layout direction
+---@return LayoutDirection
+function LayoutGroup:GetDirection() end
+
+--- Defines the layout direction
+---@param direction LayoutDirection
+function LayoutGroup:SetDirection(direction) end
+
+--- Returns the spacing between children
+---@return number
+function LayoutGroup:GetSpacing() end
+
+--- Defines the non-negative spacing between children
+---@param spacing number
+function LayoutGroup:SetSpacing(spacing) end
+
+--- Returns the layout padding as left, right, top, bottom
+---@return Vector4
+function LayoutGroup:GetPadding() end
+
+--- Defines the layout padding as left, right, top, bottom
+---@param padding Vector4
+function LayoutGroup:SetPadding(padding) end
+
+--- Returns the horizontal children alignment
+---@return LayoutHorizontalAlignment
+function LayoutGroup:GetHorizontalAlignment() end
+
+--- Defines the horizontal children alignment
+---@param alignment LayoutHorizontalAlignment
+function LayoutGroup:SetHorizontalAlignment(alignment) end
+
+--- Returns the vertical children alignment
+---@return LayoutVerticalAlignment
+function LayoutGroup:GetVerticalAlignment() end
+
+--- Defines the vertical children alignment
+---@param alignment LayoutVerticalAlignment
+function LayoutGroup:SetVerticalAlignment(alignment) end
+
+--- Returns whether the layout controls children width
+---@return boolean
+function LayoutGroup:GetControlChildrenWidth() end
+
+--- Defines whether the layout controls children width
+---@param value boolean
+function LayoutGroup:SetControlChildrenWidth(value) end
+
+--- Returns whether the layout controls children height
+---@return boolean
+function LayoutGroup:GetControlChildrenHeight() end
+
+--- Defines whether the layout controls children height
+---@param value boolean
+function LayoutGroup:SetControlChildrenHeight(value) end
+
+--- Returns whether child layout slots expand to use all available width
+---@return boolean
+function LayoutGroup:GetForceExpandWidth() end
+
+--- Defines whether child layout slots expand to use all available width
+---@param value boolean
+function LayoutGroup:SetForceExpandWidth(value) end
+
+--- Returns whether child layout slots expand to use all available height
+---@return boolean
+function LayoutGroup:GetForceExpandHeight() end
+
+--- Defines whether child layout slots expand to use all available height
+---@param value boolean
+function LayoutGroup:SetForceExpandHeight(value) end

Resources/Engine/Lua/Components/Text.lua

@@ -0,0 +1,71 @@
+---@meta
+
+---@enum TextHorizontalAlignment
+TextHorizontalAlignment = {
+	LEFT = 0,
+	CENTER = 1,
+	RIGHT = 2
+}
+
+---@enum TextVerticalAlignment
+TextVerticalAlignment = {
+	TOP = 0,
+	CENTER = 1,
+	BOTTOM = 2
+}
+
+--- Represents a renderable user interface text
+---@class Text : Component
+Text = {}
+
+--- Returns the actor that owns this component
+---@return Actor
+function Text:GetOwner() end
+
+--- Returns the text content
+---@return string
+function Text:GetText() end
+
+--- Defines the text content
+---@param text string
+function Text:SetText(text) end
+
+--- Returns the font resource path
+---@return string
+function Text:GetFontPath() end
+
+--- Defines the font resource path
+---@param fontPath string
+function Text:SetFontPath(fontPath) end
+
+--- Returns the font size in canvas pixels
+---@return number
+function Text:GetFontSize() end
+
+--- Defines the font size in canvas pixels
+---@param fontSize number
+function Text:SetFontSize(fontSize) end
+
+--- Returns the text color
+---@return Vector4
+function Text:GetColor() end
+
+--- Defines the text color
+---@param color Vector4
+function Text:SetColor(color) end
+
+--- Returns the horizontal text alignment
+---@return TextHorizontalAlignment
+function Text:GetHorizontalAlignment() end
+
+--- Defines the horizontal text alignment
+---@param alignment TextHorizontalAlignment
+function Text:SetHorizontalAlignment(alignment) end
+
+--- Returns the vertical text alignment
+---@return TextVerticalAlignment
+function Text:GetVerticalAlignment() end
+
+--- Defines the vertical text alignment
+---@param alignment TextVerticalAlignment
+function Text:SetVerticalAlignment(alignment) end