DIV CSS 佈局教程網

cocos2dx 骨骼動畫 Armature 源碼剖析(二):導出配置的欄位全解析
編輯:關於JavaScript     

上一篇我們從宏觀角度梳理了 cocos2dx 內建的骨骼動畫體系,本篇把鏡頭拉近,逐欄拆解 DragonBones(DragonBone)導出的 XML 設定檔。把這些欄位吃透,之後讀 Armature 相關源碼時就會順暢很多。

一、skeleton 根節點

 <skeleton name="Dragon" frameRate="24" version="2.2">

三個屬性各有分工:

  • name:對應 Flash 的原始檔名。
  • frameRate:製作時使用的影格率,後續換算時間長度會用到。
  • version:DragonBones 的版本號,用來判斷格式相容性。

二、armatures 節點:整套骨骼的容器

 <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 節點:骨骼本身的姿態

 <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">

這裡記錄的是骨骼在第一幀的基準狀態,各欄位意義如下:

  • name:骨骼名稱,等同 TimeLine 上的 layer 名稱。
  • parent:父骨骼名稱,決定骨骼樹的層級關係。
  • x / y:元件旋轉錨點相對於父節點原點的座標,注意 y 軸向下為正值。

  • kX / kY:對應 skewX、skewY,一般情況下兩者數值相同,用來表達旋轉量。

  • cX / cY:對應 scaleX、scaleY,即縮放比例。
  • pX / pY:對應 pivotX、pivotY,也就是旋轉錨點相對於元件原點的偏移。下圖示範了旋轉 30 度後的樣子。

  • z:層級序號,最底部的 layer 為 0,往上逐層遞增,決定渲染先後。

四、d 節點:掛在骨骼上的「皮膚」

骨骼中真正用來顯示的節點,可以理解為皮膚。一個 layer 裡用到了幾個庫中的元件,就會產生幾個 <d> 節點。

 <d name="parts-tail" pX="0" pY="-63.8"/>

name 是顯示對象的名稱,由庫中的路徑與元件名稱拼接而成,如下面兩張圖所示。

pX / pY 則是顯示對象相對於原點的位移量。

五、animations 節點:骨骼隨時間的變化

 <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 節點:一個動畫剪輯的實體

mov 才是程式碼裡真正拿來播放的動畫單位。TimeLine 上每打一個影格標籤,就會產生一個 mov,因此單一 <animation/> 中通常包含多個 mov。

 <mov name="stand" dr="7" to="6" drTW="30" lp="1" twE="0">
  • name:影格標籤的名稱,也就是動畫名稱。
  • dr:duration,這個 mov 佔多少影格。上圖中 stand 為 7 幀。
  • to:用途不明,推測與循環銜接的目標幀有關。
  • drTW:duration_tween,動畫實際播放的時間長度。以 24fps、7 幀計算即 1/24×7≈0.29 秒;在 DragonBones 面板調整 Total Time 會影響此值。
  • lp:loop,是否循環播放。
  • twE:用途不明,部分動畫會出現 NaN。

七、mov 內的 b 節點:該影格下的骨骼狀態

 <b name="tail" sc="1" dl="0">

每個 mov 都會列出全部骨骼節點,用來描述該動畫片段中的骨骼狀態。

  • name:骨骼名稱。
  • sc:movement_scale,可理解為播放速率/總幀數縮放,DragonBones 面板可調整。
  • dl:movement_delay,延遲播放的設定,應與面板中的 Play Delay 相關。

八、f 節點:關鍵幀資料

 <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 則是匯出時額外寫入的座標換算值。

  • dI:display_index,決定要顯示哪一個圖,也就是 <armature><b><d> 中的 d。
  • dr:duration,該關鍵幀持續的幀數。

九、TextureAtlas 節點:圖集資訊

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 四大區塊對應清楚之後,下一篇我們就能順勢進入解析與播放流程的實作細節。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved