Lua角度差归一：就近转向的最短弧

flowchart TD
A[读目标和当前角] --> B[差值 = 目标减当前]
B --> C[加180取模360再减180]
C --> D[差值归一到正负180]
D --> E[按差值就近转向]
E --> F{差值趋零}
F -- 否 --> A
F -- 是 --> G[到位 停转]

 fx-anglenorm

-- @file AngleNorm.lua
-- 角度差归一 —— 就近转向的最短弧

local AngleNorm = {}

local CONST = {
    TURN_SPEED    = 3.0,
    SNAP_DEG      = 0.5,

    AUTOINC_BASE  = 1162000,
}

local _cur       = 0
local _target    = 0
local _shortest  = true
local _scheduler = nil
local _autoInc   = 0

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

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

-- 差值归一：折到正负180的区间里
function AngleNorm.Diff(target)
    local d = target - _cur
    d = (d + 180) % 360 - 180
    return d
end

function AngleNorm.Cur()
    return _cur % 360
end

-- 就近转向：按归一后的差值逐步转
if not _scheduler then
    _scheduler = SL:Schedule(function(dt)
        local d = AngleNorm.Diff(_target)
        if not _shortest then
            d = _target - _cur
        end
        if math.abs(d) < CONST.SNAP_DEG then
            _cur = _target % 360
            return
        end
        _cur = _cur + d * math.min(1, CONST.TURN_SPEED * dt)
    end, 0.02)
end

function AngleNorm.SetTarget(deg)
    _target = deg % 360
end

function AngleNorm.SetMode(shortest)
    _shortest = shortest
end

SL:ScheduleOnce(function()
    SL:BindDebugButton("目标跳350", function()
        AngleNorm.SetTarget(350)
    end)
    SL:BindDebugButton("切模式", function()
        AngleNorm.SetMode(not _shortest)
    end)
    ShowTip("技能已加载: 角度差归一 (调试按钮触发)")
end, 1.0)

function AngleNorm.Unload()
    if _scheduler then SL:Unschedule(_scheduler) end
    _scheduler = nil
end

return AngleNorm