lufylegend.js 是一套開源的 HTML5 遊戲引擎。遊戲裡的動畫 Traditionally 不是做成 GIF 就是請美術輸出序列圖,但其實用程式寫 ALSO 很 Fun——而且檔案小、可互動、解析度-independent。本文就用引擎內建的緩動類 LTweenLite 做一段帶點科幻感的「開戰」動畫。

線上展示:
https://lufylegend.com/demo/effects01/
先到官網下載引擎,並把 API 文件放進書籤——後面查方法會用到。
lufylegend.js 引擎官網:https://lufylegend.com/lufylegend
線上 API 文件:https://lufylegend.com/lufylegend/api
做動畫最直覺的做法是掛時間軸事件,例如讓物件 A 每幀往右移 1 像素:
layer.addEventListener(LEvent.ENTER_FRAME, onframe); function onframe(event){ A.x += 1; }
但這次我們改用 LTweenLite。它是 lufylegend 的緩動類,可以一次描述「哪個屬性、幾秒內、從目前值變到目標值、用什麼緩動曲線」,寫起來比手動累加座標簡潔得多,而且支援連續串接(.to().to())與 onComplete 回呼,做循環動畫特別順手。本範例的所有動畫都靠它完成。
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8" /> <title>effects01</title> <script type="text/javascript" src="js/lufylegend-1.8.0.simple.min.js"></script> <script type="text/javascript" src="js/lufylegend.LoadingSample4-0.1.0.min.js"></script> </head> <body style="margin:0px 0px 0px 0px;"> <div id="legend"></div> <script> </script> </body> </html>
var imgData = [ {name:"background",path:"background.jpg"}, {name:"background_ad",path:"background_ad.jpg"}, {name:"card01",path:"card01.png"}, {name:"card02",path:"card02.png"}, {name:"card03",path:"card03.png"}, {name:"card04",path:"card04.png"}, {name:"card05",path:"card05.png"}, {name:"effects",path:"effects.png"}, {name:"stable_assets",path:"stable_assets.png"} ]; var dataList; var loadingLayer,charaLayer,stageLayer; var warshipDown,playerText,enemyText,windowUp,title,big_vs,background,swords,swords02; if(LGlobal.canTouch){ LGlobal.stageScale = LStageScaleMode.EXACT_FIT; LSystem.screen(LStage.FULL_SCREEN); } init(20,"legend",320,410,main); function main(){ loadingLayer = new LoadingSample4(); addChild(loadingLayer); /**讀取圖片*/ LLoadManage.load(imgData, function(progress){ loadingLayer.setProgress(progress); },gameInit); }
那段 LGlobal.canTouch 判斷的意思是:以手機瀏覽時把舞台設為全螢幕並等比填滿,電腦上就維持固定尺寸。
兩張圖疊在一起,讓上層那張的 alpha 在 0 與 1 之間來回補間,就得到呼吸燈的效果。這裡用到了 1.8.0 版新增的「連續緩動」,並在 onComplete 裡回頭呼叫自己的 run,形成無限循環。
function BackGround(bg01,bg02){ var self = this; base(self,LSprite,[]); self.bitmapBG01 = new LBitmap(new LBitmapData(bg01)); self.addChild(self.bitmapBG01); self.bitmapBG02 = new LBitmap(new LBitmapData(bg02)); self.addChild(self.bitmapBG02); self.run(); } BackGround.prototype.run = function(){ var self = this; var tween = LTweenLite.to(self.bitmapBG02,0.5,{alpha:0,ease:Bounce.easeIn}). to(self.bitmapBG02,0.5,{alpha:1,ease:Bounce.easeIn,onComplete:function(){ self.run(); }}); }
「上下浮動」用兩段互補的 y 值補間串接而成;「開火」則用 delay 製造間隔,並透過 onUpdate 在每一幀把炮彈的 y 座標貼回船身,讓炮彈在船浮動時不會飄掉。最後一段的 onComplete 再呼叫 shot 自己,形成循環。
function Warship(shipData,shotData){ var self = this; base(self,LSprite,[]); self.bitmapShip = new LBitmap(shipData); self.addChild(self.bitmapShip); self.bitmapShot = new LBitmap(shotData); self.bitmapShot.x = -10; self.bitmapShot.y = self.bitmapShip.y + 123; self.addChild(self.bitmapShot); self.bitmapShot.rotate = -75; self.bitmapShot.alpha = 0; self.bitmapShot02 = new LBitmap(shotData); self.bitmapShot02.scaleX = self.bitmapShot02.scaleY = 0.7; self.bitmapShot02.x = 65; self.bitmapShot02.y = self.bitmapShip.y + 220; self.addChild(self.bitmapShot02); self.bitmapShot02.rotate = -80; self.bitmapShot02.alpha = 0; self.run(); self.shot(); } Warship.prototype.run = function(){ var self = this; LTweenLite.to(self.bitmapShip,1,{y:5,ease:Quad.easeInOut}). to(self.bitmapShip,1,{y:0,ease:Quad.easeInOut,onComplete:function(){ self.run(); }}); } Warship.prototype.shot = function(){ var self = this; LTweenLite.to(self.bitmapShot,0.1,{delay:1.5,alpha:1,ease:Quad.easeInOut,onUpdate:function(obj){ obj.y = obj.parent.bitmapShip.y + 123; }}) .to(self.bitmapShot,0.1,{alpha:0,ease:Quad.easeInOut}) .to(self.bitmapShot02,0.1,{delay:0.5,alpha:1,ease:Quad.easeInOut,onUpdate:function(obj){ obj.y = obj.parent.bitmapShip.y + 220; }}) .to(self.bitmapShot02,0.1,{alpha:0,ease:Quad.easeInOut,onComplete:function(){ self.shot(); }}); }
標題的閃爍同樣是改 alpha;寶劍類多收一個 scale 參數,傳 -1 時把 scaleY 設為負值並補上回推的 y,就能畫出上下鏡像的另一把劍。
function Title(bitmapData){ var self = this; base(self,LSprite,[]); self.bitmap = new MiddleBitmap(bitmapData); self.bitmap.scaleX = self.bitmap.scaleY = 0.5; self.addChild(self.bitmap); self.run(); } Title.prototype.run = function(){ var self = this; LTweenLite.to(self.bitmap,1,{alpha:0.4,ease:Quad.easeInOut}). to(self.bitmap,1,{alpha:1,ease:Quad.easeInOut,onComplete:function(obj){ obj.parent.run(); }}); }
function Swords(bitmapData,scale){ var self = this; base(self,LSprite,[]); self.bitmapSwords = new LBitmap(bitmapData); self.bitmapSwords.x = -self.bitmapSwords.getWidth()*0.5; self.bitmapSwords.y = -self.bitmapSwords.getHeight()*0.5; if(scale == -1){ self.bitmapSwords.scaleY = scale; self.bitmapSwords.y += self.bitmapSwords.getHeight(); } self.addChild(self.bitmapSwords); }
這是整份程式裡最值得學的小設計。把子物件 LBitmap 的中心移到容器原點,之後無論對容器做縮放還是旋轉,視覺上的中心點都不會跑掉——否則旋轉時物件會繞著左上角轉圈,看起來很怪。
function MiddleBitmap(bitmapData){ var self = this; base(self,LSprite,[]); self.bitmapTitle = new LBitmap(bitmapData); self.bitmapTitle.x = -self.bitmapTitle.getWidth()*0.5; self.bitmapTitle.y = -self.bitmapTitle.getHeight()*0.5; self.addChild(self.bitmapTitle); }
從素材圖上裁出不同區域當作不同特效編號,加入舞台後先放大再放大並淡出,最後在 onComplete 裡把自己從父節點移除,不必手動回收。
function Effect(index){ var self = this; base(self,LSprite,[]); var bitmapData; switch(index){ case 0: bitmapData = new LBitmapData(dataList["effects"],99,45,116,96); break; case 1: bitmapData = new LBitmapData(dataList["effects"],102,278,110,88); break; case 2: bitmapData = new LBitmapData(dataList["effects"],357,85,122,127); break; case 3: bitmapData = new LBitmapData(dataList["effects"],346,357,108,99); break; case 4: bitmapData = new LBitmapData(dataList["effects"],246,918,57,62); break; } self.item = new MiddleBitmap(bitmapData); self.item.scaleX = self.item.scaleY = 0.1; self.addChild(self.item); LTweenLite.to(self.item,0.1,{scaleX:2,scaleY:2,ease:Quad.easeInOut}) .to(self.item,0.2,{scaleX:3,scaleY:3,alpha:0,ease:Quad.easeInOut,onComplete:function(obj){ var eff = obj.parent; eff.parent.removeChild(eff); }}); }
左右各五張角色卡,各自的 scale 與目標位置 ty 先記在物件上,等到動畫開始時再統一批次補間過去。這裡刻意讓初始 alpha 為 0,方便後面上淡入。
function setChara(){ charaLayer = new LSprite(); stageLayer.addChild(charaLayer); var charaBitmap,sy = 220; var charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card01"])); charaBitmap.scale = 0.4; charaBitmap.x = 110; charaBitmap.ty = 50; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card02"])); charaBitmap.scale = 0.45; charaBitmap.x = 85; charaBitmap.ty = 90; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card03"])); charaBitmap.scale = 0.55; charaBitmap.x = 70; charaBitmap.ty = 140; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card04"])); charaBitmap.scale = 0.65; charaBitmap.x = 75; charaBitmap.ty = 215; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card05"])); charaBitmap.scale = 0.75; charaBitmap.x = 85; charaBitmap.ty = 280; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); //right charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card05"])); charaBitmap.scale = 0.4; charaBitmap.x = 215; charaBitmap.ty = 50; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card04"])); charaBitmap.scale = 0.45; charaBitmap.x = 240; charaBitmap.ty = 90; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card01"])); charaBitmap.scale = 0.55; charaBitmap.x = 260; charaBitmap.ty = 140; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card03"])); charaBitmap.scale = 0.65; charaBitmap.x = 260; charaBitmap.ty = 215; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); charaBitmap = new MiddleBitmap(new LBitmapData(dataList["card02"])); charaBitmap.scale = 0.75; charaBitmap.x = 242; charaBitmap.ty = 280; charaBitmap.y = sy; charaBitmap.alpha = 0; charaLayer.addChild(charaBitmap); } function addEff(index,x,y){ var eff = new Effect(index); eff.x = x; eff.y = y; stageLayer.addChild(eff); }
這一步只是「佈景」:建立各個圖層並把物件掛上去。一開始用不到的角色(標題、大 VS、兩把寶劍)先把 visible 設為 false,等動畫播到那一段再打開。
function addItem(){ backLayer = new LSprite(); stageLayer.addChild(backLayer); backLayer.scaleX = backLayer.scaleY = 2; background = new BackGround(dataList["background"],dataList["background_ad"]); background.x = -60; background.y = -50; backLayer.addChild(background); var warship = new Warship(new LBitmapData(dataList["stable_assets"],0,0,409,480) ,new LBitmapData(dataList["stable_assets"],754,0,270,250)); warship.scaleX = warship.scaleY = 0.8; backLayer.addChild(warship); setChara(); warshipDown = new LSprite(); warshipDown.y = LGlobal.height; stageLayer.addChild(warshipDown); var warship02 = new LBitmap(new LBitmapData(dataList["stable_assets"],0,505,720,310)); warship02.scaleX = warship02.scaleY = 0.5; warship02.x = (LGlobal.width - warship02.getWidth())*0.5; warshipDown.addChild(warship02); var small_vs = new MiddleBitmap(new LBitmapData(dataList["stable_assets"],726,502,120,120)); small_vs.scaleX = small_vs.scaleY = 0.6; small_vs.x = LGlobal.width*0.5; small_vs.y = LGlobal.height - 355; warshipDown.addChild(small_vs); playerText = new LTextField(); playerText.color = "red"; playerText.text = "player"; playerText.x = (LGlobal.width*0.5 - playerText.getWidth())*0.5; playerText.y = 30; warshipDown.addChild(playerText); enemyText = new LTextField(); enemyText.color = "red"; enemyText.text = "enemy"; enemyText.x = LGlobal.width*0.5 + (LGlobal.width*0.5 - enemyText.getWidth())*0.5; enemyText.y = 30; warshipDown.addChild(enemyText); windowUp = new LSprite(); windowUp.y = -50; stageLayer.addChild(windowUp); var title_battle = new MiddleBitmap(new LBitmapData(dataList["stable_assets"],897,469,45,239)); title_battle.rotate = -90; title_battle.scaleX = title_battle.scaleY = 0.55; title_battle.x = LGlobal.width*0.5; title_battle.y = 10; windowUp.addChild(title_battle); var chain = new LBitmap(new LBitmapData(dataList["stable_assets"],880,264,71,180)); chain.rotate = -90; chain.scaleX = chain.scaleY = 0.5; windowUp.addChild(chain); var chain01 = new LBitmap(new LBitmapData(dataList["stable_assets"],851,740,100,173)); chain01.rotate = -90; chain01.scaleX = chain01.scaleY = 0.6; chain01.x = 240; windowUp.addChild(chain01); title = new Title(new LBitmapData(dataList["stable_assets"],415,425,405,80)); title.x = LGlobal.width*0.5; title.y = 290; title.alpha = 0; title.visible = false; stageLayer.addChild(title); big_vs = new MiddleBitmap(new LBitmapData(dataList["stable_assets"],420,5,340,330)); big_vs.rotate = -90; big_vs.x = LGlobal.width*0.5; big_vs.y = 170; big_vs.alpha = 0; big_vs.visible = false; stageLayer.addChild(big_vs); swords = new Swords(new LBitmapData(dataList["stable_assets"],405,335,454,89),1); swords.x = LGlobal.width*0.5; swords.y = LGlobal.height*0.5 - 60; swords.rotate = -135; swords.scaleX = swords.scaleY = 0.8; swords.visible = false; stageLayer.addChild(swords); swords02 = new Swords(new LBitmapData(dataList["stable_assets"],405,335,454,89),-1); swords02.x = LGlobal.width*0.5; swords02.y = LGlobal.height*0.5 - 60; swords02.rotate = -45; swords02.scaleX = swords02.scaleY = 0.8; swords02.visible = false; stageLayer.addChild(swords02); }
第一支動畫:角色依序淡入並滑到定位(右邊五張的 delay 減半,讓左右兩側看起來同時開始),背景先放大左移再復原,上下兩塊UI 面板用 Elastic.easeOut 彈進來,最後大 VS 縮小並觸發特效,銜接第二支動畫。
function animation01Start(event){ if(event){ stageLayer.die(); stageLayer.removeAllChild(); } /*添加所有對象*/ addItem(); /*所有人物開始緩動*/ var charaList = charaLayer.childList,chara,delayValue,duration; for(var i=0,l=charaList.length;i<l;i++){ chara = charaList[i]; chara.ty = 220; var scaleX = chara.scale, scaleY = chara.scale; delayValue = 0.1*i; if(i >= 5){ delayValue = 0.1*(i - 5); } duration = 1 - delayValue; chara.y = 220; LTweenLite.to(chara,duration,{delay:delayValue,alpha:1,scaleX:scaleX,scaleY:scaleY,ease:Strong.easeOut}) .to(chara,1,{y:chara.ty,ease:Strong.easeOut}); } /*背景緩動,變大左移上移→變小右移下移*/ LTweenLite.to(backLayer,1,{scaleX:1.3,scaleY:1.3,x:-100,y:-50,ease:Strong.easeOut}) .to(backLayer,1,{scaleX:1,scaleY:1,x:0,y:0,ease:Strong.easeOut}); /*下面窗口緩動,延時→上移→標題可顯示+VS可顯示*/ LTweenLite.to(warshipDown,0.5,{delay:1.5,y:320,ease:Elastic.easeOut,onComplete:function(){ title.visible = big_vs.visible = true; }}); /*上面窗口緩動,延時→下移*/ LTweenLite.to(windowUp,0.5,{delay:1.5,y:0,ease:Elastic.easeOut}); /*上面窗口緩動,延時→不透明*/ LTweenLite.to(title,0.2,{delay:1.5,alpha:1,ease:Elastic.easeOut}); /*VS標題緩動,延時→不透明縮小→縮小→添加特效並且進入第二個動畫初始化*/ LTweenLite.to(big_vs,0.5,{delay:1.5,alpha:1,scaleX:1,scaleY:1,ease:Elastic.easeOut}) .to(big_vs,1,{scaleX:0.45,scaleY:0.45,ease:Elastic.easeOut,onComplete:function(){ addEff(1,big_vs.x,big_vs.y); addEff(1,big_vs.x,big_vs.y); /*所有緩動後,動畫2開始准備*/ animation02Init(); }}); }
第二支動畫:VS 放大淡出消失、背景連續三段縮放、兩把寶劍從畫面外飛向中央,最後在 delay 到點時灑下隨機特效並回到第一支動畫的待機狀態。Math.random()*5 >> 0 是個常見寫法,用位移取整數,效果等同 Math.floor。
function animation02Start(event){ stageLayer.removeEventListener(LMouseEvent.MOUSE_UP, animation02Start); /*VS緩動,變大變透明→然後消失*/ LTweenLite.to(big_vs,1,{scaleX:2,scaleY:2,alpha:0,ease:Elastic.easeIn,onComplete:function(){ big_vs.parent.removeChild(big_vs); }}); /*背景緩動,變大→變大→變小*/ LTweenLite.to(backLayer,2,{delay:1,scaleX:1.2,scaleY:1.2,x:-100,y:-50,ease:Sine.easeInOut}) .to(backLayer,1,{scaleX:1.5,scaleY:1.5,ease:Sine.easeInOut}) .to(backLayer,0.5,{scaleX:1,scaleY:1,x:0,y:0,ease:Sine.easeInOut}); /*下面窗口緩動,下移→上移*/ LTweenLite.to(warshipDown,0.5,{delay:0.5,y:LGlobal.height,ease:Strong.easeOut}) .to(warshipDown,0.5,{delay:3,y:320,ease:Strong.easeOut}); /*上面窗口緩動,上移→下移*/ LTweenLite.to(windowUp,0.5,{delay:0.5,y:-50,ease:Strong.easeOut}) .to(windowUp,0.5,{delay:3,y:0,ease:Strong.easeOut}); /*標題緩動,無效果→不顯示+人物緩動開始→顯示*/ LTweenLite.to(title,0.5,{delay:0.5,ease:Strong.easeOut,onComplete:function(obj){ obj.visible = false; charaBattle(); }}) .to(title,0.5,{delay:3,ease:Strong.easeOut,onComplete:function(obj){ obj.visible = true; }}); /*寶劍變為可顯示,且坐標設定在畫面之外*/ swords.visible = true; swords02.visible = true; swords.x = -200; swords02.x = LGlobal.width + 200; var wait = 4; /*左邊寶劍緩動,向右移動屏幕中間*/ LTweenLite.to(swords,0.5,{delay:wait,x:LGlobal.width*0.5,ease:Elastic.easeOut}); /*右邊寶劍緩動,向左移動屏幕中間*/ LTweenLite.to(swords02,0.5,{delay:wait,x:LGlobal.width*0.5,ease:Elastic.easeOut}); /*stageLayer緩動,無效果延時,結束後添加特效並且進入第一個動畫初始化*/ LTweenLite.to(stageLayer,0.2,{delay:wait,onComplete:function(){ addEff(Math.random()*5 >> 0,LGlobal.width*0.5,LGlobal.height*0.4); addEff(Math.random()*5 >> 0,LGlobal.width*0.5,LGlobal.height*0.4); addEff(Math.random()*5 >> 0,LGlobal.width*0.5,LGlobal.height*0.4); animation01Init(); }}); }
最後只要分別掛上點擊事件,就能讓兩段動畫互相切換,形成一個可以一直玩下去的小循環。
function animation01Init(){ stageLayer.addEventListener(LMouseEvent.MOUSE_UP, animation01Start); } function animation02Init(){ stageLayer.addEventListener(LMouseEvent.MOUSE_UP, animation02Start); }
以上就是全部程式碼。回頭看,這類動畫的骨架其實只有三件事:用 MiddleBitmap 統一中心點、用連續 to() 描述時間序列、用 onComplete 接上下一段。把這三個模式吃透,之後要做任何介面動畫都能套用。歡迎一起交流。