null
nil
-
0
0
0
1
0
0
0
1
0
0
0
1
UIEditor
[null]
-
false
main
{34A19B7D-1583-4262-A391-F01E3CD7D973}
0) and
(objectsAtPoint[1]:IsA("TextLabel") or
objectsAtPoint[1]:IsA("TextButton") or
objectsAtPoint[1]:IsA("TextBox")) then
TextEditor:startEditingInstance(objectsAtPoint[1])
Resize:hide()
return true
end
return false
end
local function onInstanceChanged(instance, property)
Resize:updatePosition()
if FFlagStudioUIEditorV2Alpha then
DistanceLinesManager:update()
DistanceLinesManager:setVisible(true)
Rotate:update()
SizeBox:update()
end
end
local function onInputBegan(inputObject)
if (TextEditor:isCurrentlyEditing()) then
return
end
if (inputObject.UserInputType == Enum.UserInputType.MouseButton1) then
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or
UserInputService:IsKeyDown(Enum.KeyCode.RightShift)) then
m_previousSelection = SelectionManager:getRawSelection()
end
selectedInstancesPropertyChangedEvent = SelectionManager:disconnectSelectionInstancesChanged(selectedInstancesPropertyChangedEvent)
m_mouseDown = true
local location = Vector2.new(inputObject.Position.X, inputObject.Position.Y)
if FFlagStudioUIEditorV2Alpha then
if Resize:isOverAHandle() then
Resize:startDrag(location)
return
elseif Rotate:isOverAHandle() then
Rotate:onMouseDown(location)
return
end
else
if (Resize:DEPRECATED_isOverHandle(location)) then
Resize:startDrag(location)
return
end
end
local item = Select:selectTopLevelItemAtPoint(location)
Move:startDrag(location)
if not FFlagStudioUIEditorV2Alpha then
--Double click to activate text editor
if (DoubleClickDetector:isDoubleClick() and not (UserInputService:IsKeyDown(Enum.KeyCode.LeftAlt) or UserInputService:IsKeyDown(Enum.KeyCode.RightAlt))) then
if (onDoubleClick(inputObject)) then
return
end
end
end
if (not item) then
Rubberband:startRubberbandDrag(location)
else
InstanceInfo:isVisible(item, true)
end
--
elseif (inputObject.UserInputType == Enum.UserInputType.Keyboard) then
--[[
if (inputObject.KeyCode == Enum.KeyCode.Left) then
Move:bump(Move.LEFT)
elseif (inputObject.KeyCode == Enum.KeyCode.Right) then
Move:bump(Move.RIGHT)
elseif (inputObject.KeyCode == Enum.KeyCode.Up) then
Move:bump(Move.UP)
elseif (inputObject.KeyCode == Enum.KeyCode.Down) then
Move:bump(Move.DOWN)
else--]]
if (inputObject.KeyCode == Enum.KeyCode.U and
(UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or
UserInputService:IsKeyDown(Enum.KeyCode.RightShift))) then
GlobalValues:toggleGridType()
elseif (inputObject.KeyCode == Enum.KeyCode.A and UserInputService:IsKeyDown(Enum.KeyCode.LeftControl)) then
--We will eventually want an action overriding system
--Select all action has already been fired
SelectionManager:setSelection(Select:getGuiObjects())
end
end
end
local function onInputEnded(inputObject)
if (inputObject.UserInputType == Enum.UserInputType.MouseButton1) then
m_mouseDown = false
local location = Vector2.new(inputObject.Position.X, inputObject.Position.Y)
if (Resize:isDragInProgress()) then
Resize:finishDrag()
end
if (Rubberband:isDragInProgress()) then
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or
UserInputService:IsKeyDown(Enum.KeyCode.RightShift)) then
Select:toggleSelectionOfAllObjectsInBounds(m_previousSelection, Rubberband:getBounds())
else
Select:selectAllObjectsInBounds(Rubberband:getBounds())
end
if (#SelectionManager:getRawSelection() > 0) then
Analytics:reportEvent("DragSelect")
end
Rubberband:finishRubberbandDrag()
m_previousSelection = {}
end
if Move:isDragInProgress() then
Move:finishDrag(location)
end
if not FFlagStudioUIEditorV2Alpha then
if (not TextEditor:isCurrentlyEditing()) then
Resize:show()
Resize:updatePosition()
end
end
if FFlagStudioUIEditorV2Alpha then
-- Double click to activate text editor. This check should happen onInputEnded instead
-- of onInputBegan because otherwise the move will end after text editing has begun. Ending
-- a move will show the resize handles (and size box and distance lines if there's one object).
if (DoubleClickDetector:isDoubleClick() and not (UserInputService:IsKeyDown(Enum.KeyCode.LeftAlt) or UserInputService:IsKeyDown(Enum.KeyCode.RightAlt))) then
if (onDoubleClick(inputObject)) then
return
end
end
end
if not selectedInstancesPropertyChangedEvent then
selectedInstancesPropertyChangedEvent = SelectionManager:connectSelectionInstancesChanged(onInstanceChanged)
end
if FFlagStudioUIEditorV2Alpha then
Rotate:onMouseUp(location)
if Resize:isOverAHandle() then
Resize:updateMouseIcon()
elseif Rotate:isOverAHandle() then
Rotate:updateMouseIcon()
else
MouseIconManager:setToDefaultIcon()
end
Resize:updateHandleHighlight()
end
end
end
local function onInputChanged(inputObject)
if (TextEditor:isCurrentlyEditing()) then return end
if (inputObject.UserInputType == Enum.UserInputType.MouseMovement) then
local location = Vector2.new(inputObject.Position.x, inputObject.Position.y)
local actionPerformed = false
if (Resize:isDragInProgress()) then
Resize:updateDrag(location)
return
end
if (Rubberband:isDragInProgress()) then
Rubberband:updateRubberband(location)
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or
UserInputService:IsKeyDown(Enum.KeyCode.RightShift)) then
Select:toggleSelectionOfAllObjectsInBounds(m_previousSelection, Rubberband:getBounds())
else
Select:selectAllObjectsInBounds(Rubberband:getBounds())
end
if not FFlagStudioUIEditorV2Alpha then
Resize:hide()
end
return
end
if (Move:isDragInProgress()) then
Move:updateDrag(location)
return
end
if FFlagStudioUIEditorV2Alpha then
Rotate:onMouseMove(location)
-- Handle mouse icon updates. Resize takes precedence over rotate.
if Resize:isOverAHandle() and not Rotate:isRotating() then
Resize:updateMouseIcon()
elseif Rotate:isOverAHandle() then
Rotate:updateMouseIcon()
elseif not Rotate:isRotating() then
MouseIconManager:setToDefaultIcon()
end
Resize:updateHandleHighlight(Rotate:isRotating())
else
Resize:DEPRECATED_highlightHandles(location)
end
end
end
local function onSelectionChanged()
SelectionManager:onSelectionChanged()
if not FFlagStudioUIEditorV2Alpha then
Resize:onSelectionChanged()
Resize:updatePosition()
end
if FFlagStudioUIEditorV2Alpha then
if not Rubberband:isDragInProgress() then
Resize:onSelectionChanged()
SizeBox:onSelectionChanged()
DistanceLinesManager:onSelectionChanged()
Rotate:onSelectionChanged()
end
end
SnappingPointManager:generateSnappingLines()
end
function onDragEnter(instances)
m_mouseDown = true
local location = Vector2.new(plugin:GetMouse().X, plugin:GetMouse().Y)
SelectionManager:setSelection(instances)
SelectionManager:onSelectionChanged()
Move:startDrag(location)
end
local function onUndo(waypoint)
Resize:updatePosition()
end
local function onRedo(waypoint)
Resize:updatePosition()
end
-----------------------------------
---------PLUGIN BOILERPLATE--------
-----------------------------------
local loaded = false
local on = false
local toolbar = plugin and plugin:CreateToolbar("RobloxUIEditor")
local toolbarButton = toolbar and toolbar:CreateButton("RobloxUIEditor", "RobloxUIEditor", "")
function Off()
if not on then return end
on = false
Analytics:reportEvent("Disabled")
inputBeganEvent:disconnect()
inputChangedEvent:disconnect()
inputEndedEvent:disconnect()
selectionChangedEvent:disconnect()
deactivationEvent:disconnect()
dragEnterEvent:disconnect()
selectedInstancesPropertyChangedEvent = SelectionManager:disconnectSelectionInstancesChanged(selectedInstancesPropertyChangedEvent)
if not FFlagStudioUIEditorV2Alpha then
Resize:DEPRECATED_clearAdornments()
end
if FFlagStudioUIEditorV2Alpha then
SizeBox:Off()
DistanceLinesManager:Off()
MouseIconManager:Off()
Resize:Off()
Rotate:Off()
RotationBox:Off()
end
toolbarButton:SetActive(false)
end
function On()
if on then return end
Analytics:reportEvent("Enabled")
plugin:Activate(true)
toolbarButton:SetActive(true)
inputBeganEvent = UserInputService.InputBegan:connect(onInputBegan)
inputChangedEvent = UserInputService.InputChanged:connect(onInputChanged)
inputEndedEvent = UserInputService.InputEnded:connect(onInputEnded)
selectionChangedEvent = SelectionService.SelectionChanged:connect(onSelectionChanged)
dragEnterEvent = plugin:GetMouse().DragEnter:connect(onDragEnter)
deactivationEvent = plugin.Deactivation:connect(Off)
selectedInstancesPropertyChangedEvent = SelectionManager:connectSelectionInstancesChanged(onInstanceChanged)
undoEvent = ChangeHistoryService.OnUndo:connect(onUndo)
redoEvent = ChangeHistoryService.OnRedo:connect(onRedo)
SnappingPointManager:setThreshold(5)
if not FFlagStudioUIEditorV2Alpha then
Resize:DEPRECATED_showResizeAdorns()
end
if FFlagStudioUIEditorV2Alpha then
SizeBox:On()
DistanceLinesManager:On()
MouseIconManager:On(plugin:GetMouse())
Resize:On()
Rotate:On()
RotationBox:On()
-- Must do onSelectionChanged, otherwise you can select an object before
-- the UI Editor is turned on and it won't be registered.
onSelectionChanged()
configureActionMediator()
end
on = true
end
if toolbarButton then
toolbarButton.Click:connect(function()
if on then
Off()
else
On()
end
end)
end
loaded = true]]>
-
Rubberband
{E5C0F730-A606-4984-B9E0-5BD9342AC9BA}
-
CoreGuiManager
{AE0B6978-A31E-4841-8C29-B9D825E9FF12}
-
Utility
{B09747B4-F704-498A-B54F-A300C0E8CD2A}
0) then
table.remove(t, index)
return true
end
return false
end
-- int Utility:mathattanDistance(Vector2 v)
function Utility:manhattanDistance(v)
return math.abs(v.X) + math.abs(v.Y)
end
-- Returns the cross product between two vectors.
--
-- double Utility:crossVector2(Vector2 v1, Vector2 v2)
function Utility:crossVector2(v1, v2)
return v1.X*v2.Y - v1.Y*v2.X
end
-- Returns the angle in radians between two vectors.
--
-- double Utility:angleVector2(Vector2 v1, Vector2 v2)
function Utility:angleVector2(v1, v2)
-- We use this for when rotating the selected object. This method
-- works better than the method we use in the transform dragger tool.
-- See https://stackoverflow.com/questions/21483999/using-atan2-to-find-angle-between-two-vectors
return math.atan2(Utility:crossVector2(v1, v2), v1:Dot(v2))
end
-- Vector2 Utility:floorVector2(Vector2 v)
function Utility:floorVector2(v)
return Vector2.new(math.floor(v.X), math.floor(v.Y))
end
-- Vector2 Utility:minVector2(Vector2 v1, Vector2 v2)
function Utility:minVector2(v1, v2)
return Vector2.new(math.min(v1.X, v2.X), math.min(v1.Y, v2.Y))
end
-- Vector2 Utility:maxVector2(Vector2 v1, Vector2 v2)
function Utility:maxVector2(v1, v2)
return Vector2.new(math.max(v1.X, v2.X), math.max(v1.Y, v2.Y))
end
-- UDim2 Utility:vector2ToUDim2Offset(Vector2 v)
function Utility:vector2ToUDim2Offset(v1)
return UDim2.new(0, v1.X, 0, v1.Y)
end
-- num or nil Utility:minOrNil(num v1, num v2)
function Utility:minOrNil(v1, v2)
if not v1 then return v2 end
if not v2 then return v1 end
return math.min(v1, v2)
end
-- num or nil Utility:maxOrNil(num v1, num v2)
function Utility:maxOrNil(v1, v2)
if not v1 then return v2 end
if not v2 then return v1 end
return math.max(v1, v2)
end
-- bool Utility:isOnlyScaleUDim2(UDim2 value)
function Utility:isOnlyScaleUDim2(value)
return (value.X.Offset == 0 and value.Y.Offset == 0) and
(value.X.Scale ~=0 or value.Y.Scale ~= 0)
end
-- bool Utility:isOnlyOffsetUDim2(UDim2 value)
function Utility:isOnlyOffsetUDim2(value)
return (value.X.Scale == 0 and value.Y.Scale == 0) and
(value.X.Offset ~=0 or value.Y.Offset ~= 0)
end
-- num or Vector2 Utility:distance((num or Vector2) v1, (num or Vector2) v2)
function Utility:distance(v1, v2)
local v1IsNumber = type(v1) == "number"
local v2IsNumber = type(v2) == "number"
if (v1IsNumber and v2IsNumber) then
return math.abs(v2 - v1)
elseif (v1IsNumber or v2IsNumber) then
Error("passed in one number and one non number")
else
return (v2 - v1).magnitude
end
end
-- table(mt ?) Utility:cloneTable(table(mt ?) t)
function Utility:cloneTable(t)
local newTable = {}
local mt = getmetatable(t)
local newMt = nil
for k, v in pairs(t) do
if (type(v) == "table") then
if v == mt then
v = Utility:cloneTable(v)
newMt = v
else
v = Utility:cloneTable(v)
end
end
newTable[k] = v
end
if mt ~= nil and newMt == nil then
newMt = Utility:cloneTable(mt)
end
if newMt then
setmetatable(newTable, newMt)
end
return newTable
end
--table Utility:joinTables(table t1, table t2)
function Utility:joinTables(t1, t2)
local newTable = Utility:cloneTable(t1)
for i = 1, #t2 do
table.insert(newTable, t2[i])
end
return newTable
end
return Utility
]]>
-
DoubleClickDetector
{D437651A-E23A-4FEC-9917-3B60B6DF46C6}
= currentTime) then
m_lastClickTime = nil
return true
end
m_lastClickTime = currentTime
return false
end
return DoubleClickDetector
]]>
-
TextEditor
{FAD895E4-EDA8-4C2A-A990-546FF1D94457}
-
Resize
{E2185AB6-C336-4E0C-8F88-7F1625A0EE8A}
m_mouseOverHandle = HANDLE_NOTSET
--]]
if handleDirection == m_mouseOverHandle then
m_mouseOverHandle = HANDLE_NOTSET
end
end
-- Creates the m_handleParent. It is an invisible frame that is transformed like the
-- selected object. The resize handles and the the bounding box frames are parented
-- to it and are transformed with it. That way there is no need for manually transforming
-- the resize handle and bounding box frame.
--
-- void createHandleParent()
local function createHandleParent()
m_handleParent = Instance.new("Frame")
m_handleParent.Name = "UIEditorResizeHandleParent"
-- Handle parent should only show in debug mode
m_handleParent.AnchorPoint = Vector2.new(0, 0)
m_handleParent.BackgroundTransparency = m_debugMode and 0.5 or 1
m_handleParent.BackgroundColor3 = Color3.new(0, 0, 255)
m_handleParent.BorderSizePixel = 0
end
-- void createResizeHandles()
local function createResizeHandles()
--[[
Then handles should appear at the corners and the middle of the sides. Using
the anchors points simplifies this, as we can just use those positions directly.
--]]
local anchorPoints = {
[Direction.E] = Vector2.new(0, 0.5),
[Direction.SE] = Vector2.new(0, 0),
[Direction.S] = Vector2.new(0.5, 0),
[Direction.SW] = Vector2.new(1, 0),
[Direction.W] = Vector2.new(1, 0.5),
[Direction.NW] = Vector2.new(1, 1),
[Direction.N] = Vector2.new(0.5, 1),
[Direction.NE] = Vector2.new(0, 1)
}
--[[
The handles are positioned using Scale relative to the m_handleParent. That way
their position will be updated automatically as the parent is resized.
--]]
local offset = 2
local positions = {
[Direction.E] = UDim2.new(1, -offset, 0.5, 0),
[Direction.SE] = UDim2.new(1, -offset, 1, -offset),
[Direction.S] = UDim2.new(0.5, 0, 1, -offset),
[Direction.SW] = UDim2.new(0, offset, 1, -offset),
[Direction.W] = UDim2.new(0, offset, 0.5, 0),
[Direction.NW] = UDim2.new(0, offset, 0, offset),
[Direction.N] = UDim2.new(0.5, 0, 0, offset),
[Direction.NE] = UDim2.new(1, -offset, 0, offset)
}
-- Create each resize handle
for i = Direction.FIRST, Direction.LAST do
local handle = Instance.new("Frame")
handle.Name = "ResizeHandle_" .. Direction:toShortName(i)
handle.AnchorPoint = anchorPoints[i]
handle.Size = UDim2.new(0, HANDLE_SIZE, 0, HANDLE_SIZE)
handle.Position = positions[i]
handle.BackgroundColor3 = BASE_COLOR
handle.BorderColor3 = HANDLE_BORDER_COLOR
handle.ZIndex = 3
-- Create drop shadow
local dropShadow = Instance.new("ImageLabel")
dropShadow.Image = "rbxasset://textures/StudioUIEditor/resizeHandleDropShadow.png"
dropShadow.Name = "ResizeHandleDropShadow_" .. Direction:toShortName(i)
-- We want to show four pixels of drop shadow on each side of the resize handle,
-- which is why we add 8 to the size.
dropShadow.Size = UDim2.new(0, HANDLE_SIZE + 8, 0, HANDLE_SIZE + 8)
-- The image's first four pixels is the blured edge, so move it over by 4 pixels. We want
-- more to show at the bottom than top, so move it by a little less in y.
dropShadow.Position = UDim2.new(0, -4, 0, -3)
dropShadow.BackgroundTransparency = 1
dropShadow.BorderSizePixel = 0
dropShadow.ImageColor3 = Color3.fromRGB(0, 0, 0)
dropShadow.ImageTransparency = 0.6
dropShadow.ScaleType = Enum.ScaleType.Slice
-- The image was created so four pixels around the border is the blurred edge. We
-- want those edges and corners to not be stretched in the 9-patch.
dropShadow.SliceCenter = Rect.new(4, 4, 12, 12)
dropShadow.ZIndex = 2
dropShadow.Parent = handle
-- Callbacks for when the handle is hovered
handle.MouseEnter:connect(function(x, y)
onHandleMouseEnter(i)
end)
handle.MouseLeave:connect(function(x, y)
onHandleMouseLeave(i)
end)
-- Add resize handle
handle.Parent = m_handleParent
m_handles[i] = handle
end
end
-- void createBoundingBox()
local function createBoundingBox()
-- The winding order is East and clockwise.
local anchors = {
Vector2.new(0, 0.5),
Vector2.new(0.5, 0),
Vector2.new(1, 0.5),
Vector2.new(0.5, 1)
}
local positions = {
UDim2.new(1, BORDER_SIZE, 0.5, 0),
UDim2.new(0.5, 0, 1, BORDER_SIZE),
UDim2.new(0, -BORDER_SIZE, 0.5, 0),
UDim2.new(0.5, 0, 0, -BORDER_SIZE)
}
--[[
The frames in the bounding box needs to larger than the selected
objects because they're displayed on the outside. We need to add
the bounding box width at both ends, hence the multiplication by
two. We finally need to add 2 because there's at least a one
pixel border on each side from the object itself.
--]]
local extraBoundingBoxSize = 2*BOUNDING_BOX_WIDTH + 2*BORDER_SIZE
local sizes = {
UDim2.new(0, BOUNDING_BOX_WIDTH, 1, extraBoundingBoxSize),
UDim2.new(1, extraBoundingBoxSize, 0, BOUNDING_BOX_WIDTH),
UDim2.new(0, BOUNDING_BOX_WIDTH, 1, extraBoundingBoxSize),
UDim2.new(1, extraBoundingBoxSize, 0, BOUNDING_BOX_WIDTH)
}
for i = 1, 4 do
local frame = Instance.new("Frame")
frame.AnchorPoint = anchors[i]
frame.BackgroundColor3 = BOUNDING_BOX_COLOR
frame.BorderSizePixel = 0
frame.Position = positions[i]
frame.Size = sizes[i]
-- Add bounding box frame
m_boundingBox[i] = frame
m_boundingBox[i].Parent = m_handleParent
end
end
-- TODO: Remove when removing FFlagStudioUIEditorV2Alpha
local function createResizeHandle()
assert(not FFlagStudioUIEditorV2Alpha)
local handle = Instance.new("Frame")
handle.Size = UDim2.new(0, HANDLE_SIZE, 0, HANDLE_SIZE)
handle.AnchorPoint = Vector2.new(0.5, 0.5)
handle.BackgroundColor3 = BASE_COLOR
handle.ZIndex = 2
return handle
end
-- TODO: Remove when removing FFlagStudioUIEditorV2Alpha
local function createBoundingFrame()
assert(not FFlagStudioUIEditorV2Alpha)
local frame = Instance.new("Frame")
frame.AnchorPoint = Vector2.new(0.5, 0.5)
frame.BackgroundColor3 = BOUNDING_BOX_COLOR
frame.BorderSizePixel = 0
return frame
end
-- bool handleExist()
local function handlesExist()
return #m_handles > 0
end
--Vector2 getPositionFromHandle(table(mt Extents2D), num handle)
local function getPositionFromHandle(extents, handle)
if (handle == HANDLE_NW) then
return extents.TopLeft
elseif (handle == HANDLE_N) then
return Vector2.new(extents.Center.X, extents.Top)
elseif (handle == HANDLE_NE) then
return extents.TopRight
elseif (handle == HANDLE_W) then
return Vector2.new(extents.Left, extents.Center.Y)
elseif (handle == HANDLE_E) then
return Vector2.new(extents.Right, extents.Center.Y)
elseif (handle == HANDLE_SW) then
return extents.BottomLeft
elseif (handle == HANDLE_S) then
return Vector2.new(extents.Center.X, extents.Bottom)
elseif (handle == HANDLE_SE) then
return extents.BottomRight
end
return extents.Center
end
-- num getSnappingTypeFromHandle(num handle)
local function getSnappingTypeFromHandle(handle)
if (handle == HANDLE_NW) then
return SnappingType.ResizeXnYn
elseif (handle == HANDLE_N) then
return SnappingType.ResizeYn
elseif (handle == HANDLE_NE) then
return SnappingType.ResizeXpYn
elseif (handle == HANDLE_W) then
return SnappingType.ResizeXn
elseif (handle == HANDLE_E) then
return SnappingType.ResizeXp
elseif (handle == HANDLE_SW) then
return SnappingType.ResizeXnYp
elseif (handle == HANDLE_S) then
return SnappingType.ResizeYp
elseif (handle == HANDLE_SE) then
return SnappingType.ResizeXpYp
end
--assert
return nil
end
-- void updateHandlePositionFromExtents(table(mt Extents2D) extents)
local function updateHandlePositionFromExtents(extents)
if FFlagStudioUIEditorV2Alpha then
local size = extents.Size
local position = extents.TopLeft
--[[
Update the m_handleParent so the resize handles and bounding box
frames are transformed.
--]]
m_handleParent.Position = UDim2.new(0, position.X, 0, position.Y)
m_handleParent.Size = UDim2.new(0, size.X, 0, size.Y)
if (#m_filteredSelection == 1) then
-- Only one object is selected so we can rotate the bounding box and resize handles
m_handleParent.Rotation = m_filteredSelection[1].AbsoluteRotation
else
m_handleParent.Rotation = 0
end
else
local widenedExtents = Utility:cloneTable(extents)
widenedExtents:translate(-Vector2.new(HANDLE_POSITION_OFFSET, HANDLE_POSITION_OFFSET))
widenedExtents:resize((widenedExtents.Size + Vector2.new(HANDLE_POSITION_OFFSET, HANDLE_POSITION_OFFSET) * 2) - HANDLE_OFFSET)
local size = widenedExtents.Size
local center = widenedExtents.Center
for i = 1, 8 do
m_handles[i].Position = Utility:vector2ToUDim2Offset(getPositionFromHandle(widenedExtents, i))
end
m_boundingBox[1].Position = UDim2.new(0, center.X, 0, widenedExtents.Top)
m_boundingBox[1].Size = UDim2.new(0, size.X, 0, BOUNDING_BOX_WIDTH)
m_boundingBox[2].Position = UDim2.new(0, center.X, 0, widenedExtents.Bottom)
m_boundingBox[2].Size = UDim2.new(0, size.X, 0, BOUNDING_BOX_WIDTH)
m_boundingBox[3].Position = UDim2.new(0, widenedExtents.Left, 0, center.Y)
m_boundingBox[3].Size = UDim2.new(0, BOUNDING_BOX_WIDTH, 0, size.Y)
m_boundingBox[4].Position = UDim2.new(0, widenedExtents.Right, 0, center.Y)
m_boundingBox[4].Size = UDim2.new(0, BOUNDING_BOX_WIDTH, 0, size.Y)
end
end
local function createResizeAdorns()
if (handlesExist()) then return end
local container = CoreGuiManager:findOrCreateFolder("m_handles")
if not m_screenGui then
m_screenGui = Instance.new("ScreenGui", container)
if FFlagStudioUIEditorV2Alpha then
-- I had forgotten to fast flag this in CLISTUDIO-14547
m_screenGui.Enabled = false
end
end
if FFlagStudioUIEditorV2Alpha then
createHandleParent()
m_handleParent.Parent = m_screenGui
createResizeHandles()
createBoundingBox()
else
for i = 1, 8 do
table.insert(m_handles, createResizeHandle())
m_handles[i].Parent = m_screenGui
end
for i = 1, 4 do
table.insert(m_boundingBox, createBoundingFrame())
m_boundingBox[i].Parent = m_screenGui
end
end
end
local function deleteResizeAdorns()
for i = 1, #m_handles do
m_handles[i]:Destroy()
end
for i = 1, #m_boundingBox do
m_boundingBox[i]:Destroy()
end
m_handles = {}
m_boundingBox = {}
if FFlagStudioUIEditorV2Alpha then
m_mouseOverHandle = HANDLE_NOTSET
if m_handleParent then
m_handleParent:Destroy()
m_handleParent = nil
end
if m_screenGui then
m_screenGui:Destroy()
m_screenGui = nil
end
end
end
-- TODO: Remove when removing FFlagStudioUIEditorV2Alpha
local function DEPRECATED_isPointInBox(location, upperLeft, size)
assert(not FFlagStudioUIEditorV2Alpha)
return location.x >= upperLeft.x and
location.y >= upperLeft.y and
location.x <= upperLeft.x + size.x and
location.y <= upperLeft.y + size.y
end
-- TODO: Remove when removing FFlagStudioUIEditorV2Alpha
local function DEPRECATED_getHandleOver(location)
assert(not FFlagStudioUIEditorV2Alpha)
for i = 1, #m_handles do
if (DEPRECATED_isPointInBox(location, m_handles[i].AbsolutePosition, m_handles[i].AbsoluteSize)) then
return m_handles[i]
end
end
return nil
end
-- Returns true if one or more instances of the type GuiObject is selected.
--
-- bool hasSelection()
function hasSelection()
return #m_filteredSelection > 0
end
-- Encapsulation
local Resize = {}
function Resize:onSelectionChanged()
if FFlagStudioUIEditorV2Alpha then
m_filteredSelection = SelectionManager:getFilteredSelection()
if (not SelectionManager:hasFilteredSelection()) then
Resize:hide()
else
Resize:updatePosition()
Resize:show()
end
else
if (not SelectionManager:hasSelection()) then
deleteResizeAdorns()
else
createResizeAdorns()
Resize:updatePosition()
end
end
end
-- TODO: Remove when removing FFlagStudioUIEditorV2Alpha
function Resize:DEPRECATED_clearAdornments()
assert(not FFlagStudioUIEditorV2Alpha)
deleteResizeAdorns()
end
-- TODO: Remove when removing FFlagStudioUIEditorV2Alpha
function Resize:DEPRECATED_showResizeAdorns()
assert(not FFlagStudioUIEditorV2Alpha)
if (SelectionManager:hasFilteredSelection()) then
createResizeAdorns()
Resize:updatePosition()
end
end
-- void Resize:updatePosition()
function Resize:updatePosition()
if FFlagStudioUIEditorV2Alpha then
if #m_filteredSelection == 0 then
return
end
updateHandlePositionFromExtents(Extents2D:getExtentsFromGuis(m_filteredSelection))
else
if (not handlesExist() or m_isHidden) then return end
local selection = SelectionManager:getFilteredSelection()
if (#selection == 0) then
Resize:hide()
return
end
updateHandlePositionFromExtents(Extents2D:getExtentsFromGuis(selection))
end
end
-- Returns true if the mouse is currently over one of the resize handles.
--
-- bool Resize:isOverAHandle()
function Resize:isOverAHandle()
if not hasSelection() then
return false
end
return m_mouseOverHandle ~= HANDLE_NOTSET
end
-- TODO: Remove when removing FFlagStudioUIEditorV2Alpha
function Resize:DEPRECATED_isOverHandle(location)
assert(not FFlagStudioUIEditorV2Alpha)
return DEPRECATED_getHandleOver(location) ~= nil
end
-- Updates the handle highlight. The previously hovered handles highlight will be
-- cleared. If a handle is hovered, then it will be highlighted. The hovered
-- handle will not be highlighted if noHighlight is true. That's used when the
-- mouse is over the handle, but it should not be highlighted, e.g when rotating.
--
-- Resize:updateHandleHighlight(bool noHighlight)
function Resize:updateHandleHighlight(noHighlight)
if not hasSelection() then
return
end
for i = Direction.FIRST, Direction.LAST do
if not noHighlight and m_mouseOverHandle == i then
m_handles[i].BackgroundColor3 = HOVER_COLOR
else
m_handles[i].BackgroundColor3 = BASE_COLOR
end
end
end
-- TODO: Remove when removing FFlagStudioUIEditorV2Alpha
function Resize:DEPRECATED_highlightHandles(location)
assert(not FFlagStudioUIEditorV2Alpha)
for i = 1, #m_handles do
if (DEPRECATED_isPointInBox(location, m_handles[i].AbsolutePosition, m_handles[i].AbsoluteSize)) then
m_handles[i].BackgroundColor3 = HOVER_COLOR
else
m_handles[i].BackgroundColor3 = BASE_COLOR
end
end
end
function Resize:isDragInProgress()
return m_currentlyDragging
end
-- Updates the resize mouse icon.
--
-- void Resize:updateMouseIcon()
function Resize:updateMouseIcon()
if m_mouseOverHandle ~= Direction.NOT_SET then
if #m_filteredSelection == 1 then
local absoluteRotation = m_filteredSelection[1].AbsoluteRotation
local mouseIconDirection = MouseIconManager:calcMouseIconDirection(m_mouseOverHandle, absoluteRotation)
MouseIconManager:setToResizeIcon(mouseIconDirection)
else
-- If there's more than one object selected, then the bounding box is axis aligned
MouseIconManager:setToResizeIcon(m_mouseOverHandle)
end
end
end
-- Hides all handles except for one, which is set to visible.
--
-- void onlyShowHandle(Direction handleToShow)
function onlyShowHandle(handleToShow)
for i = 1, #m_handles do
if i == handleToShow then
m_handles[i].Visible = true
else
m_handles[i].Visible = false
end
end
end
function Resize:startDrag(location)
if FFlagStudioUIEditorV2Alpha then
if not hasSelection() then
return
end
end
if m_currentlyDragging then return end
m_currentlyDragging = true
if FFlagStudioUIEditorV2Alpha then
m_draggingHandle = m_mouseOverHandle
onlyShowHandle(m_draggingHandle)
for i = 1, #m_filteredSelection do
table.insert(m_originalSelectionData,
{
m_filteredSelection[i],
m_filteredSelection[i].AbsolutePosition,
m_filteredSelection[i].Position,
m_filteredSelection[i].AbsoluteSize,
m_filteredSelection[i].Size
})
end
m_originalExtents = Extents2D:getExtentsFromGuis(m_filteredSelection)
m_originalAspectRatio = m_originalExtents.Width / m_originalExtents.Height
else
--hide handles
for i = 1, #m_handles do
if (DEPRECATED_isPointInBox(location, m_handles[i].AbsolutePosition, m_handles[i].AbsoluteSize)) then
m_draggingHandle = i
m_handles[i].Visible = true
else
m_handles[i].Visible = false
end
end
local selection = SelectionManager:getFilteredSelection()
for i = 1, #selection do
table.insert(m_originalSelectionData,
{
selection[i],
selection[i].AbsolutePosition,
selection[i].Position,
selection[i].AbsoluteSize,
selection[i].Size
})
end
m_originalExtents = Extents2D:getExtentsFromGuis(SelectionManager:getFilteredSelection())
m_originalAspectRatio = m_originalExtents.Width / m_originalExtents.Height
end
m_originalMousePosition = location
if FFlagStudioUIEditorV2Alpha then
m_actionMediator:onResizeBegan(location)
end
end
--void retainAspectRatio(table(mt Extents2D)& extents, Vector2 mouseLocation, bool hasSnappedX, bool hasSnappedY)
local function retainAspectRatio(extents, mouseLocation, hasSnappedX, hasSnappedY)
local snapXOnly = hasSnappedX and not hasSnappedY
local snapYOnly = hasSnappedY and not hasSnappedX
if (m_draggingHandle == HANDLE_E or
m_draggingHandle == HANDLE_W) then
local height = extents.Width / m_originalAspectRatio
extents:expandFromCenter(Vector2.new(0, height - extents.Height))
elseif (m_draggingHandle == HANDLE_N or
m_draggingHandle == HANDLE_S) then
local width = m_originalAspectRatio * extents.Height
extents:expandFromCenter(Vector2.new(width - extents.Width, 0))
elseif (m_draggingHandle == HANDLE_SE) then
local mouseDelta = mouseLocation - m_originalExtents.TopLeft
local mouseAspectRatio = mouseDelta.X / mouseDelta.Y
local isCloserX = mouseDelta.Y <= 0 or mouseAspectRatio > m_originalAspectRatio
if ((isCloserX or snapXOnly) and (not snapYOnly)) then
extents.BottomRight = extents.TopLeft + Vector2.new(extents.Width, extents.Width / m_originalAspectRatio)
else
extents.BottomRight = extents.TopLeft + Vector2.new(m_originalAspectRatio * extents.Height, extents.Height)
end
elseif (m_draggingHandle == HANDLE_NE) then
local multiplier = Vector2.new(1, -1)
local mouseDelta = (mouseLocation - m_originalExtents.BottomLeft) * multiplier
local mouseAspectRatio = mouseDelta.X / mouseDelta.Y
local isCloserX = mouseDelta.y <= 0 or mouseAspectRatio > m_originalAspectRatio
if (isCloserX) then
extents.TopRight = extents.BottomLeft + (Vector2.new(extents.Width, extents.Width / m_originalAspectRatio) * multiplier)
else
extents.TopRight = extents.BottomLeft + (Vector2.new(m_originalAspectRatio * extents.Height, extents.Height) * multiplier)
end
elseif (m_draggingHandle == HANDLE_SW) then
local multiplier = Vector2.new(-1, 1)
local mouseDelta = (mouseLocation - m_originalExtents.TopRight) * multiplier
local mouseAspectRatio = mouseDelta.X / mouseDelta.Y
local isCloserX = mouseDelta.y <= 0 or mouseAspectRatio > m_originalAspectRatio
if (isCloserX) then
extents.BottomLeft = extents.TopRight + (Vector2.new(extents.Width, extents.Width / m_originalAspectRatio) * multiplier)
else
extents.BottomLeft = extents.TopRight + (Vector2.new(m_originalAspectRatio * extents.Height, extents.Height) * multiplier)
end
elseif (m_draggingHandle == HANDLE_NW) then
local multiplier = Vector2.new(-1, -1)
local mouseDelta = (mouseLocation - m_originalExtents.BottomRight) * multiplier
local mouseAspectRatio = mouseDelta.X / mouseDelta.Y
local isCloserX = mouseDelta.y <= 0 or mouseAspectRatio > m_originalAspectRatio
if ((isCloserX or snapXOnly) and (not snapYOnly)) then
extents.TopLeft = extents.BottomRight + (Vector2.new(extents.Width, extents.Width / m_originalAspectRatio) * multiplier)
else
extents.TopLeft = extents.BottomRight + (Vector2.new(m_originalAspectRatio * extents.Height, extents.Height) * multiplier)
end
end
end
-- void Resize:updateDrag(Vector2 location)
function Resize:updateDrag(location)
if not m_currentlyDragging then return end
local selection = SelectionManager:getFilteredSelection()
local newExtents = Utility:cloneTable(m_originalExtents)
AdornmentModule:hideSnappingLines()
-----------------------
--Contextual Snapping--
-----------------------
local delta = location - m_originalMousePosition
if (m_draggingHandle == HANDLE_NW or
m_draggingHandle == HANDLE_W or
m_draggingHandle == HANDLE_SW) then
newExtents:translate(Vector2.new(delta.X, 0))
newExtents:resize(newExtents.Size - Vector2.new(delta.X, 0))
elseif (m_draggingHandle == HANDLE_NE or
m_draggingHandle == HANDLE_E or
m_draggingHandle == HANDLE_SE) then
newExtents:resize(newExtents.Size + Vector2.new(delta.X, 0))
end
if (m_draggingHandle == HANDLE_NW or
m_draggingHandle == HANDLE_N or
m_draggingHandle == HANDLE_NE) then
newExtents:translate(Vector2.new(0, delta.Y))
newExtents:resize(newExtents.Size - Vector2.new(0, delta.Y))
elseif (m_draggingHandle == HANDLE_SW or
m_draggingHandle == HANDLE_S or
m_draggingHandle == HANDLE_SE) then
newExtents:resize(newExtents.Size + Vector2.new(0, delta.Y))
end
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or UserInputService:IsKeyDown(Enum.KeyCode.RightShift)) then
retainAspectRatio(newExtents, location, false, false)
end
local snappingLines, hasSnappedX, hasSnappedY
newExtents, snappingLines, hasSnappedX, hasSnappedY = SnappingPointManager:snapExtents(newExtents, getSnappingTypeFromHandle(m_draggingHandle))
for i = 1, #snappingLines do
AdornmentModule:showSnappingLine(snappingLines[i])
end
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or UserInputService:IsKeyDown(Enum.KeyCode.RightShift)) then
retainAspectRatio(newExtents, location, hasSnappedX, hasSnappedY)
end
local intendedPosition = {}
local intendedSize = {}
--calculate intended position and size
for i = 1, #m_originalSelectionData do
local data = m_originalSelectionData[i]
local guiObject = data[DATA_INSTANCE]
local percentPosition = (data[DATA_ABSPOSITION] - m_originalExtents.TopLeft) / m_originalExtents.Size
local newAbsolutePosition = (percentPosition * newExtents.Size) + newExtents.TopLeft
local newAbsoluteSize = (data[DATA_ABSSIZE] / m_originalExtents.Size) * newExtents.Size
--adjust for anchor point
newAbsolutePosition = newAbsolutePosition + (newAbsoluteSize * guiObject.AnchorPoint)
if (newAbsoluteSize.X <= 0 or newAbsoluteSize.Y <= 0) then return end
local shouldUseScalePosition = Utility:isOnlyScaleUDim2(data[DATA_POSITION]) or
(not Utility:isOnlyOffsetUDim2(data[DATA_POSITION]) and
GlobalValues:isScale())
local shouldUseScaleSize = Utility:isOnlyScaleUDim2(data[DATA_SIZE]) or
(not Utility:isOnlyOffsetUDim2(data[DATA_SIZE]) and
GlobalValues:isScale())
intendedPosition[guiObject], intendedSize[guiObject] = Convert:convertAbsoluteToScaleOrOffset(
shouldUseScalePosition, shouldUseScaleSize,
newAbsolutePosition, newAbsoluteSize,
data[DATA_POSITION], data[DATA_SIZE],
guiObject.Parent)
end
for i = 1, #m_originalSelectionData do
local guiObject = m_originalSelectionData[i][DATA_INSTANCE]
guiObject.Position = intendedPosition[guiObject]
guiObject.Size = intendedSize[guiObject]
end
updateHandlePositionFromExtents(newExtents)
if FFlagStudioUIEditorV2Alpha then
m_actionMediator:onResizeChanged(location)
end
end
--void Resize:finishDrag(Vector2 location)
function Resize:finishDrag(location)
if not m_currentlyDragging then return end
AdornmentModule:hideSnappingLines()
if m_originalMousePosition ~= location then
Analytics:reportEvent("Resize")
ChangeHistoryService:SetWaypoint("Resize")
end
m_currentlyDragging = false
AdornmentModule:hideXSnappingLine()
AdornmentModule:hideYSnappingLine()
m_originalSelectionData = {}
m_originalMousePosition = nil
m_originalExtents = nil
m_draggingHandle = nil
for i = 1, #m_handles do
m_handles[i].Visible = true
end
if FFlagStudioUIEditorV2Alpha then
m_actionMediator:onResizeEnded(location)
end
end
-- void Resize:hide()
function Resize:hide()
if m_isHidden then return end
m_isHidden = true
if m_screenGui then
m_screenGui.Enabled = false
end
end
-- void Resize:show()
function Resize:show()
if FFlagStudioUIEditorV2Alpha then
if not m_isHidden or #m_filteredSelection == 0 then
return
end
else
if not m_isHidden then return end
end
m_isHidden = false
if m_screenGui then
m_screenGui.Enabled = true
end
end
function Resize:setActionMediator(actionMediator)
m_actionMediator = actionMediator
end
-- Turns the Resize on and performs initialization. Called when the plugin is turned on.
function Resize:On()
createResizeAdorns()
end
-- Turns the Resize off and performs de-initialization. Called when the plugin is turned off.
function Resize:Off()
deleteResizeAdorns()
end
return Resize
]]>
-
Error
{171BD556-A514-41FD-BF0A-2E58CDFAD4A0}
-
AdornmentModule
{902789FF-89A7-4491-AA7B-170A05D1A24A}
-
SelectionManager
{B2A1FB18-0D9B-4C62-9ABE-2322E03FF971}
-
Move
{8DFF8734-9E4B-45E6-9882-933F80386C52}
1) then
scale = scale / Vector2.new(element.Parent.CanvasSize.Width.Scale + 1.0, 1)
end
if (element.Parent.CanvasSize.Height.Scale > 1) then
scale = scale / Vector2.new(1, element.Parent.CanvasSize.Height.Scale + 1.0)
end
end
end
element.Position = m_originalSelectionData[i][DATA_POSITION] + UDim2.new(scale.X, 0, scale.Y, 0)
else
element.Position = m_originalSelectionData[i][DATA_POSITION] + UDim2.new(0, vector.X, 0, vector.Y)
end
end
end
end
local function dragElements(location)
dragElementsBy(location - m_originalMousePosition)
end
local function directionToDirectionVector(direction)
if (direction == UP) then
return Vector2.new(0, -1)
elseif (direction == DOWN) then
return Vector2.new(0, 1)
elseif (direction == LEFT) then
return Vector2.new(-1, 0)
elseif (direction == RIGHT) then
return Vector2.new(1, 0)
end
--assert
return Vector2.new(0, -1)
end
local function getFirstAncestorOfType(instance, objectType)
if not instance or not instance.Parent then
return nil
end
if (instance.Parent:IsA(objectType)) then
return instance.Parent
end
return getFirstAncestorOfType(instance.Parent, objectType)
end
--[[ Commenting out reparenting functionality until we have better flow
local function offerReparent(instance, offeredParent)
if not instance then
return
end
if not offeredParent then
offeredParent = getFirstAncestorOfType(instance, "ScreenGui")
if not offeredParent then
AdornmentModule:hideOfferReparent()
return
end
end
if (offeredParent == instance.Parent) then
AdornmentModule:hideOfferReparent()
else
AdornmentModule:showOfferReparentAdornments(instance,offeredParent)
end
end
--]]
local function isDescendantOf(item, potentialAncestor)
while (item and item.Parent) do
if (item.Parent == potentialAncestor) then
return true
end
item = item.Parent
end
return false
end
function getHighestZIndexOfSelfAndDescendants(instance, original)
if instance == original then return 0 end
local zIndex = 0
if (instance:IsA("GuiObject")) then
zIndex = instance.ZIndex
end
local children = instance:GetChildren()
for i = 1, #children do
zIndex = math.max(zIndex, getHighestZIndexOfSelfAndDescendants(children[i], original))
end
return zIndex
end
function incrementZIndexOfSelfAndDescendantsBy(instance, number)
if (instance:IsA("GuiObject")) then
instance.ZIndex = instance.zIndex + number
end
local children = instance:GetChildren()
for i = 1, #children do
incrementZIndexOfSelfAndDescendantsBy(children[i], number)
end
end
local Move = {}
function Move:isDragInProgress()
return m_draggingStarted
end
--void Move:startDrag(Vector2 location)
function Move:startDrag(location)
m_originalSelectionData = {}
local draggableElements = SelectionManager:getFilteredSelectionCommonAncestors()
for i = 1, #draggableElements do
table.insert(m_originalSelectionData, {draggableElements[i], draggableElements[i].AbsolutePosition, draggableElements[i].Position})
end
if (#m_originalSelectionData == 0) then return end
m_originalMousePosition = location
m_draggingStarted = true
m_currentlyDragging = false
m_originalExtents = Extents2D:getExtentsFromGuis(draggableElements)
if FFlag:isEnabled("StudioUIEditorV2Alpha") then
MouseIconManager:setToMoveIcon()
m_actionMediator:onMoveBegan(location)
end
end
--void Move:finishDrag(Vector2 location)
function Move:finishDrag(location)
if (m_currentlyDragging) then
Analytics:reportEvent("Move")
ChangeHistoryService:SetWaypoint("Translate Objects (better tt needed)")
end
m_draggingStarted = false
m_originalMousePosition = nil
AdornmentModule:hideSnappingLines()
--[[ Commenting out reparenting functionality until we have better flow
if (#m_originalSelectionData == 1 and m_currentlyDragging) then
local guiObject = m_originalSelectionData[1][DATA_INSTANCE]
local guiObjectsAtPoint = Select:getGuiObjectsAtPoint(location)
Utility:removeItemFromTable(guiObject, guiObjectsAtPoint)
acceptReparent(guiObject, guiObjectsAtPoint[1])
end
--]]
m_currentlyDragging = false
if FFlag:isEnabled("StudioUIEditorV2Alpha") then
MouseIconManager:setToDefaultIcon()
m_actionMediator:onMoveEnded(location)
end
end
-- void Move:updateDrag(Vector2 location)
function Move:updateDrag(location)
if not m_currentlyDragging and Utility:manhattanDistance(location - m_originalMousePosition) <= MANHATTAN_DRAG_START_DELTA then
return
end
m_currentlyDragging = true
AdornmentModule:hideSnappingLines()
local snapType = SnappingType.MoveXY
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or UserInputService:IsKeyDown(Enum.KeyCode.RightShift)) then
local distanceToXAxis = math.abs(location.Y - m_originalMousePosition.Y)
local distanceToYAxis = math.abs(location.X - m_originalMousePosition.X)
if (distanceToXAxis < distanceToYAxis) then
location = Vector2.new(location.X, m_originalMousePosition.Y)
else
location = Vector2.new(m_originalMousePosition.X, location.Y)
end
end
local extents = Extents2D:translate(m_originalExtents, location - m_originalMousePosition)
local snappingLines
extents, snappingLines = SnappingPointManager:snapExtents(extents, SnappingType.MoveXY)
for i = 1, #snappingLines do
AdornmentModule:showSnappingLine(snappingLines[i])
end
local positionOffset
if FFlag:isEnabled("StudioUIEditorV2Alpha") then
-- The extents centers can be non-integers. Floor them so we always have a consistent
-- center. We had an issue with frames with an odd size would snap on different sides
-- of the "middle" of the screen depending on how you moved the mouse. See CLISTUDIO-14120
positionOffset = Utility:floorVector2(extents.TopLeft - m_originalExtents.TopLeft)
else
positionOffset = extents.TopLeft - m_originalExtents.TopLeft
end
dragElements(m_originalMousePosition + positionOffset)
if not FFlag:isEnabled("StudioUIEditorV2Alpha") then
Resize:hide()
end
--[[ Commenting out reparenting functionality until we have better flow
if (#m_originalSelectionData == 1) then
local guiObject = m_originalSelectionData[1][DATA_INSTANCE]
local guiObjectsAtPoint = Select:getGuiObjectsAtPoint(location)
Utility:removeItemFromTable(guiObject, guiObjectsAtPoint)
offerReparent(guiObject, guiObjectsAtPoint[1])
end
--]]
if FFlag:isEnabled("StudioUIEditorV2Alpha") then
m_actionMediator:onMoveChanged(location)
end
end
function Move:bump(direction)
Move:startDrag(Vector2.new(0,0))
dragElementsBy(directionToDirectionVector(direction))
Move:finishDrag(direction)
end
function Move:setActionMediator(actionMediator)
m_actionMediator = actionMediator
end
Move.UP = UP
Move.DOWN = DOWN
Move.LEFT = LEFT
Move.RIGHT = RIGHT
return Move
]]>
-
Rotate
{92882F28-8124-4DC8-9C73-D41393974D28}
= 0 then
return angle % maxRotation
else
return -(-angle % maxRotation)
end
end
-- Rotates the selected object if rotation has been started.
--
-- void Rotate:onMouseMove(Vector2 location)
function Rotate:onMouseMove(location)
if not m_isRotating then
return
end
local mouseMoveVec = location - m_center -- From center to new mouse location
local angleRadians = Utility:angleVector2(m_previousMouseVec, mouseMoveVec)
local angle = math.deg(angleRadians)
-- We want the user to be able to rotate the object counter-clockwise
-- and get negative values all the way up to -360. Then it should roll
-- over back to 0. When rotating clock-wise we want the user to get
-- positive values all the way up to 360, and then roll over to 0. We
-- ran into an issue where when the rotation became sufficiently large
-- we could not know if the user had rotated one way or the other way.
-- If we "reset" the vectors we meassure the angles between every so
-- often, e.g. every 90 degrees, then we'll always get a small enough
-- angle so the rotation remains positive or negative.
m_accumulatedAngle = m_accumulatedAngle + angle
local roundedRotation = roundRotationAngle(m_referenceRotation + m_accumulatedAngle)
m_selectedObject.Rotation = constrainRotationAngle(roundedRotation)
m_previousMouseVec = mouseMoveVec
if math.abs(m_accumulatedAngle) > 90 then
-- Make the current angle the reference angle, so we never have a
-- large angle between the vectors. The 90 degrees was chosen
-- arbitrarily as something less than 180 degrees.
m_referenceRotation = m_selectedObject.Rotation
m_accumulatedAngle = 0
end
Rotate:update()
m_actionMediator:onRotateChanged(location)
end
-- Ends rotating the selected object if rotation was started.
--
-- void Rotate:onMouseUp(Vector2 location)
function Rotate:onMouseUp(location)
if not m_isRotating then
return
end
-- Add undo point if the selected object was rotated
if m_selectedObject.Rotation ~= m_originalRotation then
ChangeHistoryService:SetWaypoint("Rotate object")
end
m_isRotating = false
m_center = nil
m_previousMouseVec = nil
Rotate:update()
m_actionMediator:onRotateEnded(location)
end
-- Returns true is the selected object is being rotated.
--
-- bool Rotate:isRotating()
function Rotate:isRotating()
return m_isRotating
end
-- Updates the position of the rotate handles when the selected object's position,
-- anchor point, size or rotation changes. It can be either from from Properties
-- widget or by using the tools.
function Rotate:update()
if not m_selectedObject then
return
end
m_handleParent.AnchorPoint = m_selectedObject.AnchorPoint
local position = m_selectedObject.AbsolutePosition
m_handleParent.Position = UDim2.new(0, position.X, 0, position.Y)
local size = m_selectedObject.AbsoluteSize
m_handleParent.Size = UDim2.new(0, size.X, 0, size.Y)
m_handleParent.Rotation = m_selectedObject.AbsoluteRotation
end
function Rotate:onSelectionChanged()
local filteredSelection = SelectionManager:getFilteredSelection()
if #filteredSelection == 1 then
m_selectedObject = filteredSelection[1]
Rotate:update()
-- The m_handleParent is completely transparent, so it's still not "visible" to
-- the user. Setting it to visible enables the handles mouseEnter and mouseLeave
-- events. It also looks better when m_debugMode is enabled.
m_handleParent.Visible = true
else
m_selectedObject = nil
m_handleParent.Visible = false
end
end
-- Turns the Rotate feature on and performs initialization. Called when the plugin is turned on.
function Rotate:On()
createHandles()
resetIsMouseOverHandle()
m_isRotating = false
Rotate:update()
end
-- Turns the Rotate feature off and performs de-initialization. Called when the plugin is turned off.
function Rotate:Off()
destroyHandleParentAndRotationHandles()
m_isRotating = false
end
function Rotate:setActionMediator(actionMediator)
m_actionMediator = actionMediator
end
return Rotate
]]>
-
Select
{0F669255-450A-4C1B-BC43-EF8797844724}
= upperLeft.x and
point.x <= upperLeft.x + sizeBuffer.x and
point.y >= upperLeft.y and
point.y <= upperLeft.y + sizeBuffer.y
end
local function collectVisibleGuiObjectsUnder(instance)
local children = instance:GetChildren()
local allItems = {}
for i = 1, #children do
if (children[i]:IsA("GuiObject")) then
local ancestors = collectVisibleGuiObjectsUnder(children[i])
if (InstanceInfo:isVisible(children[i])) then
table.insert(allItems, children[i])
end
for j = 1, #ancestors do
table.insert(allItems, ancestors[j])
end
end
end
return allItems
end
local function guessScreenGui(sg)
local anc = collectVisibleGuiObjectsUnder(sg)
local orderMap = {}
for i = 1, #anc do
orderMap[anc[i]] = i;
end
local function guiSort(a, b)
if (a.ZIndex == b.ZIndex) then
return orderMap[a] < orderMap[b]
end
return a.ZIndex < b.ZIndex
end
table.sort(anc, guiSort)
return anc
end
local function refreshPaintOrder()
local starterGui = game.StarterGui
local children = starterGui:GetChildren()
paintOrder = {}
for i = 1, #children do
if (children[i]:IsA("ScreenGui")) then
local guiAncestors = guessScreenGui(children[i])
for i = 1, #guiAncestors do
table.insert(paintOrder, guiAncestors[i])
paintOrderMap[guiAncestors[i]] = #paintOrder
end
end
end
end
local function getGuiObjectsAtPoint(point)
local objectsAtPoint = {}
for i = #paintOrder, 1, -1 do
if (doesPointExistInInstance(point, paintOrder[i])) then
table.insert(objectsAtPoint, paintOrder[i])
end
end
return objectsAtPoint
end
local function getTopLevelItemAtPoint(point)
refreshPaintOrder()
local objectsAtPoint = getGuiObjectsAtPoint(point)
local objectToSelect = objectsAtPoint[1]
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftAlt) or UserInputService:IsKeyDown(Enum.KeyCode.RightAlt)) then
local location = Utility:findItemInTable(lastSelectedElement, objectsAtPoint)
if (location ~= 0 and location ~= #objectsAtPoint) then
objectToSelect = objectsAtPoint[location + 1]
end
end
return objectToSelect
end
--return true if added, false if removed
local function toggleItemsExistenceInTable(item, t)
local itemLocation = Utility:findItemInTable(item, t)
if (itemLocation > 0) then
table.remove(t, itemLocation)
return false
end
table.insert(t, item)
return true
end
local Select = {}
function Select:getGuiObjects()
return {unpack(paintOrder)}
end
function Select:getGuiObjectsAtPoint(point)
return getGuiObjectsAtPoint(point)
end
function Select:selectTopLevelItemAtPoint(point)
local objectToSelect = getTopLevelItemAtPoint(point)
local selection = SelectionManager:getRawSelection()
local newSelection = {unpack(selection)}
local analyticsSelectionReported = false
if (objectToSelect) then
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftControl) or
UserInputService:IsKeyDown(Enum.KeyCode.RightControl) or
UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or
UserInputService:IsKeyDown(Enum.KeyCode.RightShift)) then
if (toggleItemsExistenceInTable(objectToSelect, newSelection)) then
Analytics:reportEvent("AddToSelection")
else
Analytics:reportEvent("RemoveFromSelection")
end
analyticsSelectionReported = true
elseif (Utility:findItemInTable(objectToSelect, newSelection) == 0) then
newSelection = {objectToSelect}
end
else
if (UserInputService:IsKeyDown(Enum.KeyCode.LeftShift) or
UserInputService:IsKeyDown(Enum.KeyCode.RightShift)) then
return nil
elseif (Utility:findItemInTable(objectToSelect, newSelection) == 0) then
newSelection = {objectToSelect}
end
end
lastSelectedElement = objectToSelect
if (SelectionManager:setSelection(newSelection) and not analyticsSelectionReported) then
if (SelectionManager:hasFilteredSelection()) then
Analytics:reportEvent("Select")
else
Analytics:reportEvent("Deselect")
end
end
return lastSelectedElement
end
function Select:selectAllObjectsInBounds(point1, point2)
local min = Vector2.new(math.min(point1.X, point2.X), math.min(point1.Y, point2.Y))
local max = Vector2.new(math.max(point1.X, point2.X), math.max(point1.Y, point2.Y))
local totalSelected = {}
for i = 1, #paintOrder do
if (paintOrder[i].AbsolutePosition.X >= min.X and
paintOrder[i].AbsolutePosition.Y >= min.Y and
paintOrder[i].AbsolutePosition.X + paintOrder[i].AbsoluteSize.X <= max.X and
paintOrder[i].AbsolutePosition.Y + paintOrder[i].AbsoluteSize.Y <= max.Y) then
table.insert(totalSelected, paintOrder[i])
end
end
SelectionManager:setSelection(totalSelected)
end
function Select:toggleSelectionOfAllObjectsInBounds(previousSelection, point1, point2)
local min = Vector2.new(math.min(point1.X, point2.X), math.min(point1.Y, point2.Y))
local max = Vector2.new(math.max(point1.X, point2.X), math.max(point1.Y, point2.Y))
local totalSelected = {}
for i = 1, #paintOrder do
if (paintOrder[i].AbsolutePosition.X >= min.X and
paintOrder[i].AbsolutePosition.Y >= min.Y and
paintOrder[i].AbsolutePosition.X + paintOrder[i].AbsoluteSize.X <= max.X and
paintOrder[i].AbsolutePosition.Y + paintOrder[i].AbsoluteSize.Y <= max.Y) then
table.insert(totalSelected, paintOrder[i])
end
end
for i = 1, #previousSelection do
local location = Utility:findItemInTable(previousSelection[i], totalSelected)
if (location ~= 0) then
table.remove(totalSelected, location)
else
table.insert(totalSelected, previousSelection[i])
end
end
SelectionManager:setSelection(totalSelected)
end
return Select
]]>
-
GlobalValues
{27B4468D-96B1-4D16-804E-4EFDDDDCE260}
-
false
README
{246CC8ED-7B99-466C-B6BB-3B59DBE59695}
-
InstanceInfo
{55E2295C-E264-4599-9A2D-9250CEABDA31}
= 1.0) then
if (object:IsA("ImageLabel") or object:IsA("ImageButton")) then
return object.Image ~= "" and object.ImageTransparency < 1.0
end
if (object:IsA("TextLabel") or object:IsA("TextButton")) then
return object.Text ~= "" and object.TextTransparency < 1.0
end
return false
end
return true
end
-- bool InstanceInfo:canSeeThrough(GuiObject object)
function InstanceInfo:canSeeThrough(object)
if (not object:IsA("GuiObject") or
not object.Visible or
not areAncestorsEnabledAndVisible(object) or
object.BackgroundTransparency > 0) then
return true
end
return false
end
return InstanceInfo
]]>
-
SnappingPointManager
{4ABC8724-DB27-4AF0-B141-A7C746152F09}
-
Set
{526CED19-5FF7-4070-A852-B7ACD5447A74}
0 do
local pk = t[1]
if (type(pk) == "table") then
pk = getUniqueKey(pk)
end
t.map[pk] = nil
table.remove(t, 1)
end
end
end
end
setmetatable(setTable, setTable.mt)
return setTable
end
return Set
]]>
-
UniqueArrayMap
{90ADDAC7-524C-4817-9CF1-5957A24B30A3}
0 do
t.map[t[1][1]] = nil
table.remove(t, 1)
end
end
end
end
setmetatable(setTable, setTable.mt)
return setTable
end
return UniqueArrayMap
]]>
-
Analytics
{B36AE4D4-87BA-4539-B18A-679A05D2AF81}
-
Convert
{C7662E52-DE31-43E9-A36E-202A8DF06CAE}
-
FFlag
{65FDFEE9-A352-40A8-BCDB-37473F6BB9DC}
-
Extents2D
{6653155F-BD2E-4D8D-8842-995B9061446E}
0) then
extents.hidden.TopLeft = args[1]
extents.hidden.BottomRight = args[1]
table.remove(args, 1)
extend(extents, unpack(args))
else
refreshData(extents)
end
end
-- void Extents2D:translate(table(mt Extents2D)& extents, Vector2 offset)
function translate(extents, offset)
extents.hidden.TopLeft = extents.hidden.TopLeft + offset
extents.hidden.BottomRight = extents.hidden.BottomRight + offset
refreshData(extents)
end
-- void Extents2D:resize(table(mt Extents2D)& extents, Vector2 offset)
function resize(extents, size)
extents.hidden.BottomRight = extents.hidden.TopLeft + size
refreshData(extents)
end
-- void Extents2D:extendFromCenter(table(mt Extents2D)& extents, Vector2 offset)
function expandFromCenter(extents, sizeOffset)
local offset = sizeOffset * 0.5
extents.TopLeft = extents.TopLeft - offset
extents.BottomRight = extents.BottomRight + offset
refreshData(extents)
end
local Extents2D = {}
-- table(mt Extents2D) Extents2D.new(Vector2 ...)
function Extents2D.new(...)
local extents = {}
extents.map = {}
extents.mt = {}
extents.hidden = {}
extents.hidden.TopLeft = Vector2.new(0,0)
extents.hidden.BottomRight = Vector2.new(0,0)
set(extents, ...)
refreshVisibility(extents)
function extents.mt.__index(t, k)
if k == "extend" then
return extend
elseif k == "set" then
return set
elseif k == "TopLeft" then
return t.hidden.TopLeft
elseif k == "BottomRight" then
return t.hidden.BottomRight
elseif k == "TopRight" then
return t.hidden.TopRight
elseif k == "BottomLeft" then
return t.hidden.BottomLeft
elseif k == "Top" then
return t.hidden.Top
elseif k == "Bottom" then
return t.hidden.Bottom
elseif k == "Left" then
return t.hidden.Left
elseif k == "Right" then
return t.hidden.Right
elseif k == "TopLeftVisible" then
return extents.hidden.TopLeftVisible
elseif k == "TopRightVisible" then
return extents.hidden.TopRightVisible
elseif k == "BottomLeftVisible" then
return extents.hidden.BottomLeftVisible
elseif k == "BottomRightVisible" then
return extents.hidden.BottomRightVisible
elseif k == "TopVisible" then
return extents.hidden.TopLeftVisible or extents.hidden.TopRightVisible
elseif k == "BottomVisible" then
return extents.hidden.BottomLeftVisible or extents.hidden.BottomRightVisible
elseif k == "LeftVisible" then
return extents.hidden.TopLeftVisible or extents.hidden.BottomLeftVisible
elseif k == "RightVisible" then
return extents.hidden.TopRightVisible or extents.hidden.BottomRightVisible
elseif k == "CenterVisible" then
return extents.hidden.CenterVisible
elseif k == "translate" then
return translate
elseif k == "resize" then
return resize
elseif k == "expandFromCenter" then
return expandFromCenter
end
end
function extents.mt.__newindex(t, k, v)
if k == "TopLeft" then
t.hidden.TopLeft = v
elseif k == "BottomRight" then
t.hidden.BottomRight = v
elseif k == "TopRight" then
t.hidden.TopLeft = Vector2.new(t.hidden.Left, v.Y)
t.hidden.BottomRight = Vector2.new(v.X, t.hidden.Bottom)
elseif k == "BottomLeft" then
t.hidden.TopLeft = Vector2.new(v.X, t.hidden.Top)
t.hidden.BottomRight = Vector2.new(t.hidden.Right, v.Y)
elseif k == "Top" then
t.hidden.TopLeft = Vector2.new(t.hidden.Left, v)
elseif k == "Bottom" then
t.hidden.BottomRight = Vector2.new(t.hidden.Right, v)
elseif k == "Left" then
t.hidden.TopLeft = Vector2.new(v, t.hidden.Top)
elseif k == "Right" then
t.hidden.BottomRight = Vector2.new(v, t.hidden.Bottom)
end
refreshData(t)
end
setmetatable(extents, extents.mt)
return extents
end
-- table(mt Extents2D) Extents2D:translate(table(mt Extents2D) extents, Vector2 offset)
function Extents2D:translate(extents, offset)
local clone = Utility:cloneTable(extents)
translate(clone, offset)
return clone
end
-- table(mt Extents2D) Extents2D:resize(table(mt Extents2D) extents, Vector2 size)
function Extents2D:resize(extents, size)
local clone = Utility:cloneTable(extents)
resize(extents, size)
return clone
end
-- table(mt Extents2D) Extents2D:expandFromCenter(table(mt Extents2D) extents, Vector2 sizeOffset)
function Extents2D:expandFromCenter(extents, sizeOffset)
local clone = Utility:cloneTable(extents)
expandFromCenter(extents, sizeOffset)
return clone
end
-- table(mt Extents2D) Extents2D:getExtentsFromGui(GuiBase2d guiObject)
function Extents2D:getExtentsFromGui(guiObject)
local extents = Extents2D.new()
set(extents, guiObject.AbsolutePosition, guiObject.AbsolutePosition + guiObject.AbsoluteSize)
refreshVisibility(extents, guiObject)
return extents
end
-- table(mt Extents2D) Extents2D:getExtentsFromGuis(table(GuiBase2d) guiObjects)
function Extents2D:getExtentsFromGuis(guiObjects)
if (#guiObjects == 0) then return nil end
local extents = Extents2D.new()
set(extents, guiObjects[1].AbsolutePosition, guiObjects[1].AbsolutePosition + guiObjects[1].AbsoluteSize)
if FFlagStudioUIEditorV2Alpha then
for i = 2, #guiObjects do
extend(extents, guiObjects[i].AbsolutePosition, guiObjects[i].AbsolutePosition + guiObjects[i].AbsoluteSize)
end
else
for i = 2, #guiObjects do
extend(extents, guiObjects[2].AbsolutePosition, guiObjects[2].AbsolutePosition + guiObjects[2].AbsoluteSize)
end
end
return extents
end
return Extents2D
]]>
-
Enum
-
SnappingType
{5C0DCE85-5878-4418-8545-030BF2B0CB20}
-
Axis
{BB6169DC-17DB-419E-8A0F-1BD51E53EC7C}
-
Direction
{473B14D8-418B-43F2-BC05-FA03EECC0261}
-
Log
{DB87BDB3-0926-48F1-9118-DF42631F642F}
-
SizeBox
{D6073BB5-9075-40A6-8654-BC86985670BC}
-
DistanceLinesManager
{7C6CA309-9FEA-4B2B-B46D-53FF45390DB8}
= minimumRotation
if visible and isRotated then
m_xDistanceLine:setVisible(false)
m_yDistanceLine:setVisible(false)
return
end
m_xDistanceLine:setVisible(visible)
m_yDistanceLine:setVisible(visible)
end
return DistanceLinesManager
]]>
-
RectUtility
{4E938C81-B706-4229-B14E-DCD8096FFB24}
-
Tests
-
true
RectUtilityTest
{26DC7C62-63FA-4451-851C-DB3FE41D8E81}
-
DistanceLine
{94C5A240-65DC-429F-94E7-9EE180432E76}
-
MouseIconManager
{389A6BD1-9BBA-44F8-AF5D-196044924711}
-
ValueBox
{48540BF7-11EF-4D0C-A2B5-6EFBC3AC2D5D}
-
RotationBox
{6E982974-84B0-4C6C-A931-19590033338B}
-
ActionMediator
{68ECCB4F-CB88-48F4-A685-63B3EB6B9316}