透過.MADSTATE檔案結合模型動畫(Mesh Animation)與遊戲事件

.madState函式名稱介紹
範例
可用的函式
互斥(exclusive)與互相包含(inclusive)的狀態

此份文件描述了.madState檔案的格式與用途。.madState檔案提供將儲存在.mad檔案中的模型動畫綁定給特定遊戲中事件的方法。.madState檔案是lua script，其中包含了一些在特定遊戲事件中會被執行的函式。例如你可以利用這個系統來將某個動畫指定給船隻離開港口的事件。每次遊戲中發生特定事件時都會呼叫對應的函式。因此，他們應該很單純。

這些函式會在SobWithMesh的MadState類別中被呼叫。MadState類別是一些被封裝起來的布林值狀態變數。當某個狀態變數的狀態被改變，將會呼叫.madstate中對應的函式（如果有的話）。

Mesh animations are deterministic in playback. Therefore, it is permissible to make the MadState dependent upon mesh animations and the game simulation dependent upon the MadState. This is one way to enable mesh animation to fit in with procedural animation. For example, we can require a ship to deploy its weapons (a mesh animation) before training them on targets (procedural animation).

.madState函式名稱介紹

.madState檔案中的函式名稱看起來像這樣：

<ShipName>_<State>_On<Event>

其中：

<ShipName>是船艦的名稱，例如 VGR_HEAVYMISSILEFRIGATE。

<State>則是狀態變數。例如 Launching

下面是狀態表：

事件（event）則有下列幾種：

範例：

這裡有個.madState腳本的範例：

VGR_HEAVYMISSILEFRIGATE_CodeRed_OnSet = function(ship) 
    setState(ship, "CodeRed", 0) 
    startAnim(ship, "Open") 
    startEffect(ship, "Open") 
    setPauseTime(ship, "Open", 1000) 
end 
 
VGR_HEAVYMISSILEFRIGATE_CodeRed_OnPause = function(ship) 
    setState(ship, "CodeRed", 1) 
end 

VGR_HEAVYMISSILEFRIGATE_CodeGreen_OnSet = function(ship) 
    startAnim(ship, "Close") 
    startEffect(ship, "Close") 
    setTime(ship,"Close",0) 
    setPauseTime(ship, "Close", 1000) 
end 

很明顯的，這是給維格重型飛彈護衛艦使用的script。其中定義了進入「Code Red」以及「Code Green」狀態的動畫。當進入Code Red時，開啟飛彈艙門的動畫會被啟動，並且在動畫結束時暫停動作（這裡使用的時間長度為1000秒，理由只是因為這個數字夠大）。按照預設，系統在呼叫script的同時也會設定狀態變數，所以我們這裡必須先取消Code Red，避免武器在動畫完成前就發射。在OnPause函式中我們再手動設定Code Red狀態為啟動。當進入「Code Green」狀態時，關閉飛彈艙門的動畫被啟動，同時「Code Green」狀態也會被呼叫這段函式的程式碼所設定。

可用的函式：

在事件函式中，你可以呼叫任何可以使用的Lua函式。然而我們也定義了一些動畫╱狀態相關的函式：

互斥(exclusive)與互相包含(inclusive)的狀態

狀態可以是互斥的或是互相包含的。這讓某些動畫的行為更容易被使用在船艦上。在Scripts/MeshAnimation.lua文件中，包含了名為inclusive（互相包含）與exclusive（互斥）的表格，列出了互相排斥以互相包含的狀態配對。當互相包含的狀態中的前者被設定時，後者也會跟著被設定。當互斥的配對中前者被設定時，後者將會被清除。這些規則的應用就像利用.madState script設定狀態一樣：他們不會呼叫lua函式，因此不會觸發動畫。