上一篇我們從宏觀角度梳理了 cocos2dx 內建的骨骼動畫體系,本篇把鏡頭拉近,逐欄拆解 DragonBones(DragonBone)導出的 XML 設定檔。把這些欄位吃透,之後讀 Armature 相關源碼時就會順暢很多。
<skeleton name="Dragon" frameRate="24" version="2.2">
三個屬性各有分工:
<armatures>
<armature name="Dragon">
<b name="tail" parent="body" x="." y="-." kX="" kY="" cX="" cY="" pX="." pY="." z="">
<d name="parts-tail" pX="" pY="-."/>
</b>
<b name="LegR" ... />
......
</armature>
</armatures>
<b/> 就是一根骨骼(b 是 bone 的縮寫),多個 <b/> 組成一具完整的 <armature/>。對照下面兩張圖就很直觀:整個 layer 與骨骼的對應關係就是一個 armature,紅框中的每一個 layer 各自對應一個 b 節點。


那為什麼 <armatures> 底下會出現多個 armature?因為同一個 Flash 檔裡可以放多套骨骼動畫,每套動畫各自對應一個 armature。例如下圖這個 Flash 導出後,armatures 中就會包含多個 armature——判斷依據是:帶有影格標籤的元件會被視為一個獨立的 Skeleton。

<armature name="Dragon"> 的 name 取自元件在庫(Library)中的名稱,同時也是 Skeleton 的名字。

<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">
這裡記錄的是骨骼在第一幀的基準狀態,各欄位意義如下:



骨骼中真正用來顯示的節點,可以理解為皮膚。一個 layer 裡用到了幾個庫中的元件,就會產生幾個 <d> 節點。
<d name="parts-tail" pX="0" pY="-63.8"/>
name 是顯示對象的名稱,由庫中的路徑與元件名稱拼接而成,如下面兩張圖所示。


pX / pY 則是顯示對象相對於原點的位移量。
<animations>
<animation name="Dragon">
<mov name="stand" dr="" to="" drTW="" lp="" twE="">
<b name="tail" sc="" dl="">
<f x="." y="-." cocosd_x="." cocosd_y="-." kX="" kY="" cX="" cY="" pX="." pY="." z="" dI="" dr=""/>
<f x="." y="-." cocosd_x="." cocosd_y="-." kX="." kY="." cX="" cY="" pX="." pY="." z="" dI="" dr=""/>
<f x="." y="-." cocosd_x="." cocosd_y="-." kX="" kY="" cX="" cY="" pX="." pY="." z="" dI="" dr=""/>
</b>
</mov>
<mov name="walk" dr="" to="" drTW="" lp="" twE=""></mov>
<mov name="jump" dr="" to="" drTW="" lp="" twE="NaN"></mov>
<mov name="fall" dr="" to="" drTW="" lp="" twE="NaN"></mov>
</animation>
</animations>
<animations/> 中出現多個 <animation/> 的原因與前面同理:一個檔案可以有多套骨骼,而 animation 與 armature 透過 name 屬性一一配對。
mov 才是程式碼裡真正拿來播放的動畫單位。TimeLine 上每打一個影格標籤,就會產生一個 mov,因此單一 <animation/> 中通常包含多個 mov。

<mov name="stand" dr="7" to="6" drTW="30" lp="1" twE="0">
<b name="tail" sc="1" dl="0">
每個 mov 都會列出全部骨骼節點,用來描述該動畫片段中的骨骼狀態。

<f x="45.9" y="-70.8" cocos2d_x="124.1" cocos2d_y="-229.25" kX="30" kY="30" cX="1" cY="1" pX="11.5" pY="176.35" z="10" dI="0" dr="2"/>
f 即 frame,對應一個關鍵幀。stand 動畫有三個關鍵幀,就會有三個 f 節點。其中 x、y、kX、kY、cX、cY、pX、pY、z 的含義與 armature 下的 b 節點完全相同;cocos2d_x、cocos2d_y 則是匯出時額外寫入的座標換算值。
<armature><b><d> 中的 d。DragonBones 可以選擇不同的導出方式。若選擇匯出大圖,TextureAtlas 節點描述的便是大圖中小圖的位置與尺寸,作用等同 TexturePacker 產生的 plist 檔。
<TextureAtlas name="Dragon" width="" height=""> <SubTexture/> <SubTexture name="parts-tail" width="" height="" cocosd_pX="" cocosd_pY="-." x="" y=""/> <SubTexture/> <SubTexture/> <SubTexture/> </TextureAtlas>
SubTexture 描述單张小圖:width、height 為尺寸,x、y 為其在大圖中的座標;cocos2d_pX、cocos2d_pY 則是匯出時附帶的錨點換算資訊。
以上就是本篇對 Armature 導出設定的逐欄解讀。把 skeleton、armatures、animations、TextureAtlas 四大區塊對應清楚之後,下一篇我們就能順勢進入解析與播放流程的實作細節。