Bolt 动画

引擎内置的  种动画

--PosChangeAnimation 平移

local ani = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("PosChangeAnimation")

ani:BindObj(imageObj)

ani:SetTotalTime()

ani:SetLoop(true)

ani:SetKeyFramePos(,,,)

imageObj:GetOwner():AddAnimation(ani)

ani:Resume()

--AngleChangeAnimation 旋转

local ani = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("AngleChangeAnimation")

ani:BindObj(imageObj)

ani:SetKeyFrameAngle(,,,,,)

ani:SetTotalTime()

ani:SetLoop(true)

ani:SetBlendMode("AntiAlias")

imageObj:GetOwner():AddAnimation(ani)

ani:Resume()

--AlphaChangeAnimation 透明度

local ani = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("AlphaChangeAnimation")

ani:BindRenderObj(imageObj)

ani:SetTotalTime()

ani:SetKeyFrameAlpha(,)

imageObj:GetOwner():AddAnimation(ani)

ani:Resume()

--SeqFrameAnimation 序列帧

local ani = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("SeqFrameAnimation")

ani:BindImageObj(imageObj)

ani:SetTotalTime()

ani:SetLoop(true)

ani:SetResID("ImageSeq.BoltTest.SeqAni")

imageObj:GetOwner():AddAnimation(ani)

ani:Resume()

--TurnObjectAnimation 对象1旋转到对象2

local imageObj2 = ctrlObj:GetControlObject("TestAni2.Texture")

local ani = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("TurnObjectAnimation")

ani:BindRenderObj(imageObj1,imageObj2)

ani:SetFlag("RoundY")

ani:SetTotalTime("")

imageObj1:GetOwner():AddAnimation(ani)

ani:Resume()

--MaskChangeAnimation MaskObject 位置改变

local maskObj = ctrlObj:GetControlObject("MaskAni.Mask")

local uiObject = ctrlObj:GetControlObject("MaskAniBkg.Texture")

local ani = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("MaskChangeAnimation")

ani:BindMaskObj(maskObj)

ani:SetMaskKeyFrame(,,,,,-,,)

ani:SetLoop(true)

ani:SetTotalTime()

maskObj:GetOwner():AddAnimation(ani)

ani:Resume()

MaskObject 的使用方法参考相关文档；

注意这里只调用了 BindMaskObj 而没有调用 BindTargetObj ，不知道为啥调用了 BindTargetObj 之后动画并不会被执行

注意：不知道为啥旋转动画不能在OnInitControl里面直接使用，需要用AsynCall调用才行：

function OnInitControl(ctrlObj)

    local imageObj = ctrlObj:GetControlObject("TestAni.Image")

    AsynCall(function()        -- 异步调用

        -- AngleChangeAnimation 旋转

        local rotateAni = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("AngleChangeAnimation")

        rotateAni:BindObj(imageObj)

        rotateAni:SetKeyFrameAngle(,,,,,)

        rotateAni:SetTotalTime()

        rotateAni:SetLoop(false)

        rotateAni:SetBlendMode("AntiAlias")

        imageObj:GetOwner():AddAnimation(rotateAni)

        rotateAni:Resume()

    end)

end

自定义动画：

在 xml 文件里定义动画模版：

<animation_def class="BoltTest.ani">

    <method_def>

        <Action file="MainWnd.xml.lua" func="BoltTestAni_Action"/>

        <BindObj file="MainWnd.xml.lua" func="BoltTestAni_BindObj"/>

        <GetBindObj file="MainWnd.xml.lua" func="BoltTestAni_GetBindObj" />

    </method_def>

</animation_def>

在 lua 文件里使用动画：

function BoltTestAni_Action(aniSelf)

    local attr = aniSelf:GetAttribute()

    local bindObj = attr.BindObj

    if bindObj == nil then

        return

    end

    local totalTime = aniSelf:GetTotalTime()

    local runningTime = aniSelf:GetRuningTime()

    --[[ 按时间缩小

    local progress = (totalTime - runningTime) / totalTime

    if progress < 0 then

        progress = 0

    end

    local l,t,r,b = bindObj:GetObjPos()

    bindObj:SetObjPos(l,t,r,t+(b-t)*progress)

    --]]

    -- 按指定间隔切换图片

    local frameTime =

    local progress = runningTime / frameTime +

    if progress >  then

        progress =

    elseif progress <  then

        progress =

    end

    progress = math.floor(progress)

    bindObj:SetResID("Bitmap.BoltTest.SeqAni"..progress)

end

function BoltTestAni_BindObj(aniSelf, obj)

    local attr = aniSelf:GetAttribute()

    attr.BindObj = obj

end

function BoltTestAni_GetBindObj(aniSelf)

    local attr = aniSelf:GetAttribute()

    return attr.BindObj

end

注意：XLUE 每隔 / 秒刷新一次界面，每次刷新时改变对象的状态，这是自定义动画的基本原理；

Action 方法每隔 / 秒调用一次；

BindObj 方法里通过 attr 表来保存要渲染的对象；

GetRuningTime 方法获取动画的运行时间，因为是每隔 / 秒调用一次 Action 方法，所以 GetRuningTime 也是每隔 / 递增

动画的状态改变事件：

-- state: 0 动画未绑定对象；1 动画准备就绪；2 动画正在执行；3 动画暂停； 4 动画结束

ani:AttachListener(true, function(aniSelf, oldState, newState)

    -- TODO

end)

注意这里，如果设定动画 SetLoop(true) state 将在  和  之间转换；

对一个动画进行 Stop，state 变为  而不是 ；也就是动画结束而不是动画暂停；

对一个动画进行 Stop，再调用 resume 并不能够使暂停的动画重新开始；

对一个动画进行 Stop，该动画实例即失效，需要重新创建该动画才能使动画重新运行

同时执行多个动画：

将多个动画对象绑定到同一个 UIObject 上即可：

-- PosChangeAnimation 平移

local ani = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("PosChangeAnimation")

ani:BindObj(imageObj)

ani:SetTotalTime()

ani:SetLoop(false)

ani:SetKeyFramePos(,,,)

imageObj:GetOwner():AddAnimation(ani)

ani:Resume()

--SeqFrameAnimation 序列帧

local ani = XLGetObject("Xunlei.UIEngine.AnimationFactory"):CreateAnimation("SeqFrameAnimation")

ani:BindImageObj(imageObj)

ani:SetTotalTime()

ani:SetLoop(true)

ani:SetResID("ImageSeq.BoltTest.SeqAni")

imageObj:GetOwner():AddAnimation(ani)

ani:Resume()

注意这里，不知道为啥 AngleChangeAnimation 旋转动画跟 SeqFrameAnimation 序列帧动画不能一起用；

执行动画序列：

local function StartAnimSequence(onFinish, ...)

    local function StartAnim(aniIndex)

        if arg[aniIndex] == nil then

            onFinish()

            return

        end

        arg[aniIndex]:AttachListener(true, function(aniSelf, oldState, newState)

            if newState ==  then

                StartAnim(aniIndex + )

            end

        end)

        arg[aniIndex]:Resume()

    end

    StartAnim()

end

StartAnimSequence(function() return end, posAni, rotateAni)

尝试用这种方法封装一个执行动画序列的方法；发现不行，不知道为啥；

动画曲线：

在资源 xml 里定义 curve 资源，可使用 CurveTool 工具来定义：

<curve id="Curve.BoltTest.MyAni" type="bspline">

    <controlpoint  tp="0.000000" sp="0.000000"/>

    <controlpoint  tp="0.854396" sp="0.025281"/>

    <controlpoint  tp="0.859890" sp="0.977528"/>

    <controlpoint  tp="0.997253" sp="1.000000"/>

</curve>

在自定义动画里通过 Curve:GetProgress(tp) 传入一个时间，获取对应的进度：

local curve = aniSelf:GetCurve()

local tp = runningTime / totalTime

local progress = curve:GetProgress(tp)

利用这个 progress 来设定进度即可