Defold 精灵与动画：Sprite、Flipbook、缓动与程序动画

① Sprite（静态）：一张图 → 换图切帧
② Flipbook（逐帧）：图集多帧循环 → 传统动画
③ 程序动画（go.animate）：属性插值 → 移动/旋转/缩放/透明度
   └─ 骨骼动画（Spine/DragonBones）：复杂角色骨骼驱动

Atlas（图集）：
  把多张图片打包成一张大图 + 元数据
  好处：一次纹理上传、精灵按名引用

-- 给 game object 添加 sprite 组件
local sp = msg.url("#sprite")      -- 引用 sprite 组件

-- 播放图集中的某张图（Flipbook 或静态帧）
sprite.play_flipbook(sp, hash("idle"))
-- 或直接换静态图
msg.post(sp, "set_texture", { texture = resource.get_atlas("atlas:main") })

go.set(sp, "scale", vmath.vector3(2, 2, 2))    -- 缩放
go.set(sp, "tint", vmath.vector4(1, 0.5, 0.5, 1)) -- 染色（命中闪白）
go.set(sp, "size", vmath.vector3(128, 128, 0))   -- 渲染尺寸

制作流程：
1. 美术导出帧序列：walk_1.png … walk_8.png
2. 导入 Defold → 图集自动生成 Flipbook 动画：walk
3. 代码播放动画名字

local sp = msg.url("#sprite")

-- 播放一次（p 参数）
sprite.play_flipbook(sp, hash("walk"), { playback = go.PlaybackMode.PLAYBACK_ONCE_FORWARD })
-- 循环播放
sprite.play_flipbook(sp, hash("walk"), { playback = go.PlaybackMode.PLAYBACK_LOOP_FORWARD })
-- 倒放/镜像
sprite.play_flipbook(sp, hash("walk"), { playback = go.PlaybackMode.PLAYBACK_ONCE_BACKWARD })

-- 手动设置当前帧（按索引）
sprite.set_hflip(sp, true)     -- 水平翻转
-- 或设置动画进度
go.set(sp, "cursor", 0.5)      -- 播到 50%

-- 移动：让 position 从当前位置动画到目标
go.animate(".", "position", go.PlaybackMode.PLAYBACK_ONCE_FORWARD,
           vmath.vector3(100, 100, 0), go.Easing.LINEAR, 2.0)

-- 旋转
go.animate(".", "rotation", go.PlaybackMode.PLAYBACK_ONCE_FORWARD,
           vmath.quat_rotation_z(math.rad(180)), go.Easing.IN_OUT_QUAD, 1.0)

-- 缩放
go.animate(".", "scale", go.PlaybackMode.PLAYBACK_LOOP_PINGPONG,
           vmath.vector3(1.5, 1.5, 1), go.Easing.OUT_BOUNCE, 0.5)

-- 透明（GUI/Sprite 染色 alpha）
go.animate("#sprite", "tint.w", go.PlaybackMode.PLAYBACK_ONCE_FORWARD,
           0, go.Easing.IN_QUAD, 0.3)

go.animate(url, property, playback, to, easing, duration)
--       对象    属性      模式      目标值  曲线    时长(秒)

LINEAR        匀速
IN_QUAD       先慢后快
OUT_QUAD      先快后慢
IN_OUT_QUAD   两头慢中间快
OUT_BOUNCE    结束弹跳
OUT_ELASTIC   结束回弹
IN_BACK / OUT_BACK   超出再回（回拉效果）

-- 按钮回弹效果
go.animate("#btn", "scale", go.PlaybackMode.PLAYBACK_LOOP_PINGPONG,
           vmath.vector3(1.1, 1.1, 1), go.Easing.OUT_ELASTIC, 0.8)

-- 取消所有正在进行的 go.animate 动画
go.cancel_animations(".", "position")
-- 取消该对象所有属性动画
go.cancel_animations(".", go.PROP_ANIM_POSITION)

-- 停止 Flipbook 播放
msg.post("#sprite", "play_animation", { id = hash("idle"), playback = ... })

-- 在 receive_message 里监听
function on_message(self, message_id, message, sender)
    if message_id == hash("animation_done") then
        -- message.animation_id 是刚播完的动画名
        -- 用于：播完攻击→回待机；播完死亡→销毁
        print("动画播完:", message.animation_id)
    end
end

-- 攻击动画播完 → 自动回待机
function on_message(self, message_id, message, sender)
    if message_id == hash("animation_done") then
        sprite.play_flipbook("#sprite", hash("idle"), { playback = go.PlaybackMode.PLAYBACK_LOOP_FORWARD })
    end
end

-- 每帧更新 y 位置
local t = self.t or 0
self.t = t + dt * 2.0

local base_y = self.base_y or 0
go.set(".", "position.y", base_y + math.sin(self.t) * 20)

-- 二次贝塞尔：P(t) = (1-t)²P0 + 2(1-t)t·P1 + t²·P2
local function quad_bezier(p0, p1, p2, t)
    local it = 1 - t
    return it * it * p0 + 2 * it * t * p1 + t * t * p2
end

-- 每帧推进 t
self.t = math.min(self.t + dt * self.speed, 1)
local x = quad_bezier(self.start.x, self.ctrl.x, self.end.x, self.t)
local y = quad_bezier(self.start.y, self.ctrl.y, self.end.y, self.t)
go.set(".", "position", vmath.vector3(x, y, 0))

Spine / DragonBones：
  美术在骨骼软件里摆动作
  导出 JSON + 纹理图集
  Defold 加载 → 作为骨骼动画资源播放

1. 导出 Spine JSON + atlas
2. 拖入 Defold 资源 → 自动生成模型组件
3. 代码控制骨骼动画

-- 播放骨骼动画（通过模型组件）
local model = msg.url("#model")
msg.post(model, "play_anim", { id = hash("run") })

-- 监听播完
function on_message(self, message_id, message, sender)
    if message_id == hash("animation_done") then
        msg.post("#model", "play_anim", { id = hash("idle") })
    end
end

-- 状态定义
local STATE = { IDLE = 1, RUN = 2, ATTACK = 3, HURT = 4, DEAD = 5 }

-- 状态 → 动画映射
local ANIM = {
    [STATE.IDLE]   = hash("idle"),
    [STATE.RUN]    = hash("run"),
    [STATE.ATTACK] = hash("attack"),
    [STATE.HURT]   = hash("hurt"),
    [STATE.DEAD]   = hash("dead"),
}

function init(self)
    self.state = STATE.IDLE
end

-- 切状态统一入口
local function set_state(self, new_state)
    self.state = new_state
    local anim = ANIM[new_state]
    local playback = go.PlaybackMode.PLAYBACK_ONCE_FORWARD
    if new_state == STATE.IDLE or new_state == STATE.RUN then
        playback = go.PlaybackMode.PLAYBACK_LOOP_FORWARD   -- 待机/跑动循环
    end
    sprite.play_flipbook("#sprite", anim, { playback = playback })
end

-- 攻击播完 → 回待机
function on_message(self, message_id, message, sender)
    if message_id == hash("animation_done") then
        if self.state == STATE.ATTACK then set_state(self, STATE.IDLE) end
    end
end