Lua波浪排布：相位错开的错落动画

flowchart TD
A[每一拍读时钟] --> B[逐个图标算相位]
B --> C[相位 = 时钟乘流速 加下标乘错距]
C --> D[纵偏 = 正弦乘波幅]
D --> E[图标落在基准加纵偏]
E --> A

 fx-wavelayout

-- @file WaveLayout.lua
-- 波浪排布 —— 相位错开的错落动画

local WaveLayout = {}

local CONST = {
    ITEM_COUNT    = 9,
    ITEM_GAP      = 65,
    BASE_Y        = 150,
    AMPS          = { 6, 12, 22 },
    SPEEDS        = { 1.5, 3, 6 },
    PHASE_STEP    = 0.55,

    AUTOINC_BASE  = 1159000,
}

local _ampIdx    = 2
local _spdIdx    = 2
local _icons     = {}
local _scheduler = nil
local _autoInc   = 0

local function GenID(prefix)
    _autoInc = _autoInc + 1
    return string.format("%s_%d", prefix or "WVL",
        CONST.AUTOINC_BASE + _autoInc)
end

local function ShowTip(msg)
    if msg and msg ~= "" then SL:ShowSystemTips(msg) end
end

function WaveLayout.Amp()
    return CONST.AMPS[_ampIdx]
end

function WaveLayout.Speed()
    return CONST.SPEEDS[_spdIdx]
end

function WaveLayout.OffsetY(idx, clock)
    local phase = clock * WaveLayout.Speed()
        + idx * CONST.PHASE_STEP
    return math.sin(phase) * WaveLayout.Amp()
end

-- 逐个排布：每个图标按自己的相位落位
if not _scheduler then
    _scheduler = SL:Schedule(function(dt)
        pt = pt + dt
        for idx = 0, CONST.ITEM_COUNT - 1 do
            local node = _icons[idx]
            if node and not GUI:Widget_IsNull(node) then
                local off = WaveLayout.OffsetY(idx, pt)
                GUI:setPosition(node,
                    70 + idx * CONST.ITEM_GAP,
                    CONST.BASE_Y + off)
            end
        end
    end, 0.02)
end

function WaveLayout.CycleAmp()
    _ampIdx = _ampIdx % #CONST.AMPS + 1
    ShowTip("波幅换成" .. WaveLayout.Amp())
end

function WaveLayout.CycleSpeed()
    _spdIdx = _spdIdx % #CONST.SPEEDS + 1
    ShowTip("流速换成" .. WaveLayout.Speed())
end

SL:ScheduleOnce(function()
    for idx = 0, CONST.ITEM_COUNT - 1 do
        local node = GUI:Layout_Create(GUI:GetRootWindow(),
            GenID("Icon"), 70 + idx * CONST.ITEM_GAP,
            CONST.BASE_Y, 48, 48, false)
        _icons[idx] = node
    end
    ShowTip("技能已加载: 波浪排布 (调试按钮触发)")
end, 1.0)

function WaveLayout.Unload()
    if _scheduler then SL:Unschedule(_scheduler) end
    for _, node in pairs(_icons) do
        if node and not GUI:Widget_IsNull(node) then
            GUI:removeFromParent(node)
        end
    end
    _icons = {}
end

return WaveLayout