cocos2dx 本身並不做動畫編輯,它拿的是編輯器(CocosStudio,或 Flash 外掛 DragonBones)導出的 XML/JSON 資料。只要依序載入資源,幾行程式碼就能把動畫跑起來:
ArmatureDataManager::getInstance()->addArmatureFileInfoAsync(
"armature/Dragon.png", "armature/Dragon.plist", "armature/Dragon.xml",
this, schedule_selector(TestAsynchronousLoading::dataLoaded));
Armature *armature = nullptr;
armature = Armature::create("Dragon");
armature->getAnimation()->playWithIndex(1);
addChild(armature);
於是問題來了:Armature::create 與 getAnimation()->playWithIndex 內部究竟做了什麼?這個系列會從源碼層面把 Armature 拆開來看,本篇先建立三個基礎認知:什麼是骨骼動畫、編輯器導出的資料長什麼樣子、以及源碼的整體分工。
遊戲中的動畫大致可分為三類:
最直覺的一種,也是另兩種的基礎:一幀換一張圖,cocos2dx 的 Animate 就是典型代表。實作門檻最低,代價是資源消耗大——幀數越多,圖越多。
Flash 時代最常見的做法。不必逐幀畫圖,只要給定起始與結束狀態,中間幀由程式依時間內插計算。省資源,美術也熟悉,是性價比不錯的方案。
骨骼動畫可以視為補間動畫的延伸:先為各部件建立父子關聯(骨骼),再把圖片綁定到骨骼上,讓局部運動自動帶動整體。缺點是引擎側實作複雜,但相較純補間有兩個明顯優勢。
1. 設定檔更小,美術製作更省事
假設有一具這樣的骨骼結構:
body
armLeft
handLeft
armRight
handRight
head
legLeft
legRight
若要在某一幀讓整個角色向右移動,補間動畫必須逐一處理 body、armLeft、legRight……每個節點都要建立新影格並寫入資料;骨骼動畫只需要改 body 的位移,子節點會自動跟著父節點走。匯出的設定檔因此精簡許多。
2. 關節裂縫的修復
下圖出自《遊戲引擎架構》449 頁:美術作圖時若沒留意,關節銜接處容易出現裂縫。骨骼動畫的蒙皮可以依權重綁定到多個關節,並隨權重一起拉伸,從而掩蓋接縫。不過要留意工具支持度:CocosStudio 骨骼編輯器能否多綁定我不確定,Flash 的 DragonBones 外掛是不支援的,Spine 對這類多權重綁定則有很不錯的支持。

CocosStudio 導出的 JSON 與 DragonBones 導出的 XML 結構高度相似,都是「骨骼層 → 動畫層 → 圖片層」三段式。以下取一段 DragonBones 官方 demo(已刪減):
<skeleton name="DragonBones_Tutorial_MultiBehavior" frameRate="24" version="2.2">
<armatures>
<armature name="Dragon">
<b name="tail" parent="body" x="45.9" y="-70.8" kX="30" kY="30" cX="1" cY="1" pX="11.5" pY="176.35" z="10">
<d name="parts-tail" pX="0" pY="-63.8"/>
</b>
</armature>
</armatures>
<animations>
<animation name="Dragon">
<mov name="stand" dr="7" to="6" drTW="100" lp="1" twE="0"></mov>
<mov name="walk" dr="8" to="5" drTW="200" lp="1" twE="0"></mov>
<mov name="jump" dr="5" to="3" drTW="5" lp="1" twE="NaN"></mov>
<mov name="fall" dr="5" to="6" drTW="5" lp="1" twE="NaN"></mov>
</animation>
</animations>
<TextureAtlas name="DragonBones_Tutorial_MultiBehavior" width="512" height="512">
</TextureAtlas>
</skeleton>
三個區塊分別對應編輯器中的三個區域:
<armatures> 是骨骼部分,對應 Flash 中的第 1 區,一個 layer 就是一根 bone。<animations> 是動畫部分,對應第 2 區,靠影格標籤切分 stand、walk、jump 等片段。<TextureAtlas> 是圖片(皮膚)部分,對應第 3 區。
有了這些資訊,程式就有辦法還原編輯器中的動畫表現。至於 dr、drTW、kX、kY 等欄位的確切含義,後續文章會逐項說明。
整個模組的程式碼可以切成兩半:解析 XML/JSON,以及依解析結果驅動動畫。

各類別職責如下:
<armature>。<animation>。<SubTexture>。<b>。<d>。<mov>。<mov><b>。<mov><b><f>。
各類別職責如下:
把這兩半拼起來,就是「讀資料 → 建骨骼樹 → 用 Tween 在時間軸上插值 → 更新顯示對象」的完整鏈路。下一篇我們直接看設定檔欄位。