Cocos2d-x遊戲開發中常用到骨骼動畫Armature，Armature不僅佔用資源不大（相對於幀動畫來說），而且還能新增幀事件，它還自帶有動畫的播放、停止、迴圈事件等。

     廢話少說，直入主題。拿到一個骨骼動畫的時候，我們往往會有這樣的需求：在情況A下，動畫的骨骼a需要顯示為樣式1，當發生情況B時，這個動畫的骨骼a需要顯示為樣式2。有一種方法，就是將骨骼a單獨作為一個動畫，這樣在使用時可以隨意替換，這裡不討論這種方法。

情景需求:
進行角色動畫處理時，當玩家裝備不同的武器時，我們需要在動畫上顯示出玩家裝備的這個武器（假設所有的武器都只是外觀不同）。所以我們需要將動畫中表示武器

需要用到的API

首先來說，替換Armature中的節點常用到以下幾個函式：

• virtual Bone *getBone(const std::string& name) const; //獲得骨骼節點
• void changeDisplayWithIndex(int index, bool force); //根據索引改變顯示內容
• void changeDisplayWithName(const std::string& name, bool force); //根據名稱改變顯示內容
• void addDisplay(DisplayData *displayData, int index); //新增一個顯示內容
• void addDisplay(cocos2d::Node *display, int index); //新增一個顯示內容
• void removeDisplay(int index); //移除一個顯示內容
• cocos2d::Node *getDisplayRenderNode(); // 獲得Display實際顯示的Node
• DisplayType getDisplayRenderNodeType(); //查詢顯示內容的型別
• virtual DisplayManager *getDisplayManager() const { return _displayManager; } //獲取Display的管理器

<1>替換骨骼(Bone)的顯示內容(Display)的方法

因為在實際拿到動畫的時候可能有多種情況，這裡我們分情況解釋。

舉例中所使用的動畫資源是使用Cocos Studio 1.6版本資源

動畫中已經包含了多個Display

專案中是直接使用.csb來建立Armature，不過可以開啟.ExportJson檔案來看一個Name為btn_icon的Bone所包含的Display資料:

bone_data下面有一個name名稱是"btn_icon"的骨骼節點。

上面看到"bone_data":後面就是動畫中包含的骨骼了，然後可以看到"bone_data"下面第一行就是一個Bone的Name屬性。跳過中間一堆位置、迴圈等屬性，往下可以看到一個"display_data"的標籤，它所代表的就是當前這個Bone中包含的所有的Display。這裡可以看到放置了3個Display，分別名為icon1.png、icon2.png、icon3.png。因為"display_data"所指的值是一個json陣列，所以自然我們也知道對應三個Display的Index分別為0、1、2.
在使用這個動畫檔案生成Armature物件時，Name屬性為btn_icon的這個Bone預設顯示的是索引為0的Display。
此時，如果我們需要改變這個Bone的顯示內容，只需要如下語句即可:

auto pArm = cocostudio::Armature::create("myArmatureName"); //生成Armature物件
auto pBone = pArm->getBone("btn_icon"); //獲取Bone物件指標
pBone->changeDisplayWithIndex(1, true); //修改Bone的Display為索引1的Display

這是在動畫中已經包含了多個Display的情況下，進行Bone的Display的切換。如果美術沒有在Bone中新增好所有需要的Display怎麼辦呢？我們可以自己新增。

動畫中沒有包含需要的Display

也就是對應的骨骼節點上所提供的display並不是自己所需的，所以得手動新增一個display，假設上面Name為btn_icon的Bone中只包含了3個Display，而我們需要顯示另外一個樣式，怎麼辦呢？我們可以手動新增一個Display。程式碼如下:

auto pArm = cocostudio::Armature::create("myArmatureName"); //生成Armature物件
auto pBone = pArm->getBone("btn_icon"); //獲取Bone物件指標
auto pSprite = Sprite::create("icon4.png"); //生成需要顯示的Node
pBone->addDisplay(pSprite, 3); //將新生成的Node新增到Bone中
pBone->changeDisplayWithIndex(3, true); //修改Bone的Display為索引3的Display

在上面兩種方式中，都有出現Index引數，這個引數有點講究。例如當新增一個Display時，Index引數值如果為0、1、2，就會導致新的Display覆蓋原來的Display，如果為3，則正好新增一個Display，如果超過3，則會在addDisplay這一行報錯，原因是被斷言:Assert failed: the _index value is out of range。
還有上面changeDisplayWithIndex中的第二個引數force，測試後再詳細來寫。

<2>替換骨骼(Bone)的粒子效果(Particle)的方法

看過上面方法，替換Bone上的Display就很容易了。如果某個Bone的顯示內容就是粒子，使用上面的兩種方法也是可以達到解決問題的效果。這裡再列出另外一種替換Bone上的粒子效果的方法。

Display是一個粒子

遇到這種情況，再放一張圖好了:

同樣是在上面提到的.ExportJson動畫檔案中，這裡可以看到Bone的Name屬性為pr1，它的"display_data"所表示的不是圖片名，而是一個plist檔案，這裡就是粒子系統(ParticleSystem)檔案。
將這張圖中"display_data"的內容與上一張圖(Bont-btn_icon)中的進行對比，可以看到"displayType"的值不同。
我們看看原始碼中的這個屬性:

/**
* DisplayType distinguish which type your display is.
*/
enum DisplayType
{
    CS_DISPLAY_SPRITE,                //! display is a single Sprite
    CS_DISPLAY_ARMATURE,         //! display is a Armature
    CS_DISPLAY_PARTICLE,            //! display is a CCParticle.

    CS_DISPLAY_MAX
};

可以瞭解到，Display是包含三種屬性的，一是精靈(Sprite)，資源就是png圖片；二是動畫(Armature)；三是粒子(Particle)，也就是我們現在遇到的。它們的列舉值分別為0、1、2,所以上圖中的"displayType"值為2，表示資源是粒子檔案。

然後粒子檔案要如何來替換呢？其實可以直接獲得這個Display顯示的Node，然後來修改Node的內容。看下面程式碼:

auto pBone = pArm->getBone("pr1"); //獲得Bone
auto pDisplayNode = (ParticleSystem*)(pBone->getDisplayRenderNode()); //獲得Bone的Display的Node，並強轉為ParticleSystem(因為已知了它是粒子系統)
pDisplayNode->initWithFile("my_particle.plist"); //使用新的粒子檔案重新初始化粒子系統

這樣在播放動畫時，我們看到的就是新的粒子系統的效果了。

其實這種方式，對於上面所說的Sprite類的Display也適用。

• 如果在Armature剛剛生成好，還沒有播放任何動畫時，去切換Display，如果force引數填true，則這個Bone會強行顯示出來，如果填false，則根本切換不過來。不知道這裡會不會有我操作失誤，待測。
• 在更換粒子效果時，如果粒子效果在當前幀還沒有顯示，此時使用getDisplayRenderNode獲取到的值為nullptr。