Files
pfUI/modules/firstrun.lua
T
Brues a376afb2d7 UI scale: size borders from the scale the game applies, mirror its options
GetPerfectPixel divided by the uiScale option, or by 1 while useUiScale was
off, though the game's automatic scale is never under 0.9, so default
borders came out about a tenth of a pixel thin. The game scales UIParent
only after add-ons and saved variables load, so the pixel now comes from
GetPhysicalScreenSize and the scale the game is about to apply, worked out
from the same options and rules as OnDisplaySizeChanged. UI_SCALE_CHANGED
offers a reload once when the pixel size changes.

The preset dropdown and the pixelperfect module go: its presets were pixel
perfect only at 1080p and its restore path never ran. The settings show the
game's own Use UI-Scale and UI-Scale options, plus a Pixel Perfect UI-Scale
checkbox (one UI unit per screen pixel, kept through window resizes) that
overrides them. The pixel perfect border and HiDPI options go too; border
sizes now count real pixels. CVAR settings rows write their option through
their own config instead of this:GetParent(), which a dropdown's menu
button is not. The first-run slider stops at 0.64, below which the game
drops uiScale for its automatic scale.
2026-11-03 01:07:02 -06:00

326 lines
12 KiB
Lua

pfUI:RegisterModule("firstrun", function ()
pfUI.firstrun = CreateFrame("Frame", "pfFirstRunWizard", UIParent)
pfUI.firstrun.steps = {}
pfUI.firstrun:RegisterEvent("PLAYER_ENTERING_WORLD")
pfUI.firstrun:SetScript("OnEvent", function() pfUI.firstrun:NextStep() end)
local autoconfig = false
function pfUI.firstrun:AddStep(name, func)
if not name then return end
table.insert(pfUI.firstrun.steps, { name = name, func = func})
end
local cur, max = 0, 0
function pfUI.firstrun:NextStep()
local windowcount = 0
for i, step in pairs(pfUI.firstrun.steps) do
if not pfUI_init[step.name] then
windowcount = windowcount + 1
end
end
max = windowcount > max and windowcount or max
for _, step in pairs(pfUI.firstrun.steps) do
local name = step.name
if not pfUI_init[name] then
cur = cur + 1
local f = step.func()
f.progress:SetMinMaxValues(0, max)
f.progress:SetValue(cur)
f.ptext:SetText(cur .. " / " .. max)
f.name = name
f:Show()
if autoconfig == true then
f.next:Click()
end
if cur == max then
f.next:SetText(T["Finish"])
autoconfig = false
cur = 0
max = 0
end
return
end
end
if not self.completed then
self.completed = true
pfUI.events:TriggerEvent("firstrun:complete")
end
end
-- main function to create wizard windows
local function CreateFirstRunPage()
local f = CreateFrame("Frame", nil, UIParent)
f:SetPoint("CENTER", 0, 0)
f:SetFrameStrata("TOOLTIP")
f:SetMovable(true)
f:EnableMouse(true)
f:RegisterForDrag("LeftButton")
f:SetWidth(380)
f:SetHeight(180)
f:SetScript("OnDragStart",function()
this:StartMoving()
end)
f:SetScript("OnDragStop",function()
this:StopMovingOrSizing()
end)
CreateBackdrop(f, nil, nil, .85)
CreateBackdropShadow(f)
-- text
f.text = f:CreateFontString("Status", "OVERLAY", "GameFontNormal")
f.text:SetFontObject(GameFontWhite)
f.text:SetJustifyV("TOP")
f.text:SetJustifyH("CENTER")
f.text:SetPoint("TOPLEFT", f, "TOPLEFT", 10, -10)
f.text:SetPoint("BOTTOMRIGHT", f, "BOTTOMRIGHT", -10, 10)
f.progress = CreateFrame("StatusBar", nil, f)
f.progress:SetPoint("BOTTOMLEFT", 100, 10)
f.progress:SetPoint("BOTTOMRIGHT", -100, 10)
f.progress:SetHeight(12)
f.progress:SetStatusBarTexture(pfUI.media["img:bar"])
f.progress:SetStatusBarColor(.2,1,.8,1)
f.progress:SetMinMaxValues(1,9)
f.progress:SetValue(3)
CreateBackdrop(f.progress)
f.ptext = f.progress:CreateFontString("Status", "LOW", "GameFontNormal")
f.ptext:SetFontObject(GameFontWhite)
f.ptext:SetAllPoints()
f.ptext:SetText("0/0")
f.next = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.next:SetWidth(80)
f.next:SetHeight(20)
f.next:SetPoint("BOTTOMLEFT", f.progress.backdrop, "BOTTOMRIGHT", 8, 0)
f.next:SetText(T["Next"])
f.next:SetScript("OnClick", function()
if f.NextScript then f.NextScript() end
pfUI_init[f.name] = true
f:Hide()
pfUI.firstrun:NextStep()
end)
SkinButton(f.next)
f.abort = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.abort:SetWidth(80)
f.abort:SetHeight(20)
f.abort:SetPoint("BOTTOMRIGHT", f.progress.backdrop, "BOTTOMLEFT", -8, 0)
f.abort:SetText(T["Cancel"])
f.abort:SetScript("OnClick", function()
f:Hide()
end)
SkinButton(f.abort)
f:Hide()
return f
end
-- welcome dialog
pfUI.firstrun:AddStep("init", function()
local f = CreateFirstRunPage()
f.text:SetFormattedText(T["Welcome to |cff33ffccpf|cffffffffUI|r!\n\nI'm the first run wizard that will guide you through some basic configuration. If you're lazy, feel free to hit the \"Defaults\" button. If you wish to run this dialog again, go to the settings and hit the \"Reset Firstrun\" button.\n\nVisit |cff33ffcc%s|r to check for the latest version."], GetAddOnMetadata(pfUI.name, "X-Website"))
return f
end)
-- choose profile
pfUI.firstrun:AddStep("profile", function()
local f = CreateFirstRunPage()
f.text:SetText(T["A new installation of |cff33ffccpf|rUI ships with 4 prebuilt design profiles. Click below if you wish to load one of these profiles."])
local function LoadProfile(name)
_G["pfUI_config"] = CopyTable(pfUI_profiles[name])
pfUI_init.selected_profile = name
pfUI:LoadConfig()
ReloadUI()
end
f.Modern = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.Modern:SetSize(120, 20)
f.Modern:SetPoint("BOTTOM", -65, 100)
f.Modern:SetTextColor(1,1,1)
f.Modern:SetText("Modern")
f.Modern:SetScript("OnClick", function() LoadProfile("Modern") end)
SkinButton(f.Modern)
f.Nostalgia = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.Nostalgia:SetSize(120, 20)
f.Nostalgia:SetPoint("BOTTOM", 65, 100)
f.Nostalgia:SetTextColor(1,1,1)
f.Nostalgia:SetText("Nostalgia")
f.Nostalgia:SetScript("OnClick", function() LoadProfile("Nostalgia") end)
SkinButton(f.Nostalgia)
f.Legacy = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.Legacy:SetSize(120, 20)
f.Legacy:SetPoint("BOTTOM", 65, 75)
f.Legacy:SetTextColor(1,1,1)
f.Legacy:SetText("Legacy")
f.Legacy:SetScript("OnClick", function() LoadProfile("Legacy") end)
SkinButton(f.Legacy)
f.Slim = CreateFrame("Button", nil, f, "UIPanelButtonTemplate")
f.Slim:SetSize(120, 20)
f.Slim:SetPoint("BOTTOM", -65, 75)
f.Slim:SetTextColor(1,1,1)
f.Slim:SetText("Slim")
f.Slim:SetScript("OnClick", function() LoadProfile("Slim") end)
SkinButton(f.Slim)
f.Slider = CreateFrame("Slider", "pfFirstRunWizardScaleSlider", f, "OptionsSliderTemplate")
f.Slider.text = f.Slider:CreateFontString("Status", "LOW", "GameFontWhite")
f.Slider.text:SetPoint("TOP", f.Slider, "BOTTOM", 0, 2)
f.Slider.text:SetText(T["Scale"])
f.Slider:SetSize(240, 20)
f.Slider:SetPoint("BOTTOM", 0, 50)
f.Slider:SetOrientation('HORIZONTAL')
-- the game drops a uiScale under 0.64 for its automatic scale at login
f.Slider:SetMinMaxValues(0.64, 2.0)
f.Slider:SetValue(UIParent:GetScale())
f.Slider:SetScript("OnMouseUp", function()
local scale = round(this:GetValue(),2)
SetCVar("uiScale", scale)
SetCVar("useUiScale", 1)
this:SetValue(scale)
end)
f.Slider:SetScript("OnValueChanged", function()
local scale = round(this:GetValue(),2)
this:SetValue(scale)
end)
f.Slider:SetScript("OnUpdate", function()
local scale = round(this:GetValue(),2)
this.text:SetText(T["Scale"] .. ": " .. scale * 100 .. "%")
end)
SkinSlider(f.Slider)
return f
end)
-- optimized cvars dialog
pfUI.firstrun:AddStep("cvars", function()
local f = CreateFirstRunPage()
f.text:SetText(T["|cff33ffccBlizzard: \"Interface Options\"|r\n\nDo you want me to set up the recommended Blizzard UI settings? This will enable settings that can be found in the Interface section of your client. Options like Buff Durations, Instant Quest Text, Auto Selfcast and others will be set."])
f.checkbox = CreateFrame("CheckButton", "pfCheckBoxCVAR", f, "UICheckButtonTemplate")
f.checkbox:SetChecked(true)
f.checkbox.text = f:CreateFontString("Status", "LOW", "GameFontNormal")
f.checkbox.text:SetPoint("LEFT", f.checkbox, "RIGHT", 5, 0)
f.checkbox.text:SetText(" " .. T["Setup Optimized Game Settings"])
f.checkbox:SetPoint("BOTTOMLEFT", (f:GetWidth() - f.checkbox.text:GetStringWidth() - 20) / 2, 50)
SkinCheckbox(f.checkbox, 18)
f.NextScript = function()
if f.checkbox:GetChecked() then
pfUI.SetupCVars()
end
end
return f
end)
-- right chat dialog
pfUI.firstrun:AddStep("chat_right", function()
local f = CreateFirstRunPage()
f.text:SetText(T["|cff33ffccChat: \"Loot & Spam\"|r\n\nDo you want me to create and manage a specific Chatframe called \"Loot & Spam\"? This chat will display world channels, loot information and miscellaneous messages, that would otherwise clutter your main chatframe."])
f.checkbox = CreateFrame("CheckButton", "pfCheckBoxChatRight", f, "UICheckButtonTemplate")
f.checkbox:SetChecked(true)
f.checkbox.text = f:CreateFontString("Status", "LOW", "GameFontNormal")
f.checkbox.text:SetPoint("LEFT", f.checkbox, "RIGHT", 5, 0)
f.checkbox.text:SetText(" " .. T["Enable \"Loot & Spam\" Window"])
f.checkbox:SetPoint("BOTTOMLEFT", (f:GetWidth() - f.checkbox.text:GetStringWidth() - 20) / 2, 50)
SkinCheckbox(f.checkbox, 18)
f.NextScript = function()
if not pfUI.chat then message("Couldn't apply settings. Chat module is disabled.") return end
pfUI.chat.SetupRightChat(f.checkbox:GetChecked())
end
return f
end)
-- chat position dialog
pfUI.firstrun:AddStep("chat_position", function()
local f = CreateFirstRunPage()
f.text:SetText(T["|cff33ffccChat: \"Layout\"|r\n\nDo you want me to adjust the layout of your chatframes? This would make sure, that every window is placed on its dedicated position."])
f.checkbox = CreateFrame("CheckButton", "pfCheckBoxChatPosition", f, "UICheckButtonTemplate")
f.checkbox:SetChecked(true)
f.checkbox.text = f:CreateFontString("Status", "LOW", "GameFontNormal")
f.checkbox.text:SetPoint("LEFT", f.checkbox, "RIGHT", 5, 0)
f.checkbox.text:SetText(" " .. T["Align Chat Windows"])
f.checkbox:SetPoint("BOTTOMLEFT", (f:GetWidth() - f.checkbox.text:GetStringWidth() - 20) / 2, 50)
SkinCheckbox(f.checkbox, 18)
f.NextScript = function()
if not pfUI.chat then message("Couldn't apply settings. Chat module is disabled.") return end
if f.checkbox:GetChecked() then
pfUI.chat.SetupPositions()
end
end
return f
end)
-- chat channels dialog
pfUI.firstrun:AddStep("chat_channels", function()
local f = CreateFirstRunPage()
f.text:SetText(T["|cff33ffccChat: \"Channels\"|r\n\nDo you want me to setup the chat channels of your chatframes? This would set important or personal messages to the left chat and world channels and lootinformation to the right chat."])
f.checkbox = CreateFrame("CheckButton", "pfCheckBoxChatChannels", f, "UICheckButtonTemplate")
f.checkbox:SetChecked(true)
f.checkbox.text = f:CreateFontString("Status", "LOW", "GameFontNormal")
f.checkbox.text:SetPoint("LEFT", f.checkbox, "RIGHT", 5, 0)
f.checkbox.text:SetText(" " .. T["Setup All Chat Channels"])
f.checkbox:SetPoint("BOTTOMLEFT", (f:GetWidth() - f.checkbox.text:GetStringWidth() - 20) / 2, 50)
SkinCheckbox(f.checkbox, 18)
f.NextScript = function()
if not pfUI.chat then message("Couldn't apply settings. Chat module is disabled.") return end
if f.checkbox:GetChecked() then
pfUI.chat.SetupChannels()
end
end
return f
end)
-- finalize dialog
pfUI.firstrun:AddStep("finalize", function()
-- Set default positions for new modules based on the active profile.
-- Only write positions that haven't been saved yet (don't override user preferences).
local function SetDefaultPosition(name, anchor, xpos, ypos)
if not pfUI_config.position[name] then
pfUI_config.position[name] = {
anchor = anchor,
parent = "UIParent",
xpos = xpos,
ypos = ypos,
}
end
end
local positions = (pfUI_profiles[pfUI_init.selected_profile or "Modern"] or pfUI_profiles["Modern"]).new_module_positions
or pfUI_profiles["Modern"].new_module_positions
for frameName, pos in pairs(positions) do
SetDefaultPosition(frameName, pos.anchor, pos.xpos, pos.ypos)
end
local f = CreateFirstRunPage()
f.text:SetText(T["Your interface is now set up.\n\nFor advanced configuration, just open the |cff33ffccpf|rUI settings via the escape menu or type \"|cffffffaa/pfui|r\" into the chat.\n\n Have a nice trip!\n\n|cffaaaaaa- Shagu"])
return f
end)
end)