SPC-UTIL（二代動(dòng)畫修改工具）是一款非常好玩的植物大戰(zhàn)僵尸2靜態(tài)修改器。通過使用這款修改器，就能對(duì)PVZ2進(jìn)行多項(xiàng)參數(shù)修改，比如金幣、陽光等，還可以對(duì)植物以及僵尸進(jìn)行修改，大幅降低游戲難度，需要的用戶可下載體驗(yàn)。

【使用說明】

　　解碼PAM動(dòng)畫的方法：

　　1. 解包數(shù)據(jù)包，得到PAM文件，使用SPC-Util打開該文件，選擇 "PAM-Convert-To-XFL-OneStep" 選項(xiàng)(輸入它前面的數(shù)字)后回車，程序會(huì)解碼PAM并生成后綴為.xfl的文件夾。解碼完畢。

　　2. 拆分這個(gè)動(dòng)畫所對(duì)應(yīng)的Atlas(需要1536規(guī)格的圖像)，得到分解圖(PNG)，將所有分解圖復(fù)制到第一步中生成的xfl文件夾下的LIBRARY文件夾內(nèi)。

　　3. 使用 Adobe Animate 軟件打開xfl文件夾下的Anim.xfl文件，即可看到解析出來的動(dòng)畫。

　　編碼生成PAM動(dòng)畫的方法：

　　在An中對(duì)動(dòng)畫進(jìn)行修改、保存后，使用SPC-Util打開這個(gè)xfl文件夾，選擇 "PAM-Convert-From-XFL-OneStep" 選項(xiàng)(輸入它前面的數(shù)字)后回車，程序會(huì)根據(jù)其中的內(nèi)容編碼出可在PvZ2游戲中運(yùn)行的PAM動(dòng)畫文件。

　　需要說明的是，目前SPC-Util可處理的XFL動(dòng)畫有諸多限制，例如：只能使用PNG位圖、不允許漸變、只能進(jìn)行逐幀制作(可以使用傳統(tǒng)補(bǔ)幀、并在要進(jìn)行轉(zhuǎn)碼前在An中將至轉(zhuǎn)化為逐幀動(dòng)畫)。具體說明參考下文。如果違反如下規(guī)則，很有可能無法成功將XFL轉(zhuǎn)換為PAM（程序進(jìn)行轉(zhuǎn)換時(shí)將會(huì)崩潰）。

　　動(dòng)畫主體結(jié)構(gòu)說明：

　　動(dòng)畫的主場(chǎng)景被命名為 "Anim"，他有四個(gè)Layer，從上到下依次為：

　　* labels : 標(biāo)簽層，用于設(shè)置幀標(biāo)簽，游戲程序會(huì)通過幀標(biāo)簽定位到需要播放的動(dòng)畫。

　　* actions : 定義動(dòng)作命令以及stop指令

　　* stop 指令：即指令 stop() ，這會(huì)使動(dòng)畫的播放停止，通過幀標(biāo)簽與stop的配合，可以使游戲播放二者之間的動(dòng)畫。

　　> 例如：在花園中種植植物，澆水后會(huì)觸發(fā)“澆水動(dòng)畫”，游戲會(huì)讀取該植物的PAM，得到動(dòng)畫數(shù)據(jù)，并通過幀標(biāo)簽"water"找到澆水動(dòng)畫所在位置，從該幀開始播放，直至播放到含有 stop指令 的幀，這樣就播放了一次澆水動(dòng)畫。

　　* 其他動(dòng)作指令：fscommand命令，游戲可讀取這種命令，并使對(duì)象做出指定的行為：例如：fscommand("use_action"); 指令，可以使射手類植物射出一枚***、使生產(chǎn)型植物生產(chǎn)一次陽光。

　　* audio : fscommand命令，用于播放音效，形如：fscommand("PlaySample", eventName); ，其中，eventName是SoundBank中定義的Event的字符串ID。

　　* animation : 動(dòng)畫層，這一層直接調(diào)用了 ID為"A_Main"的“影片剪輯”元件，要修改動(dòng)畫內(nèi)容，應(yīng)直接步入改元件進(jìn)行修改，不要改動(dòng)這一層的數(shù)據(jù)。

　　# 元件說明

　　制作動(dòng)畫時(shí)，只能使用“影片剪輯”類型的元件。通過這種元件的嵌套、組合，在A_Main元件中進(jìn)行修改。

　　## “影片剪輯”類型元件的分類與命名規(guī)則

　　* M元件：iMage（圖像）

　　M元件中，只能有一個(gè)層級(jí)、這個(gè)層級(jí)上的內(nèi)容只有一幀，并且這一幀中必須且只能包含一個(gè)“位圖”類型元件，包含之后，這一位圖可以使用如下屬性：

　　* 指定變換原點(diǎn)、平移、縮放。

　　這三種屬性以外的屬性，會(huì)在編碼PAM過程中被忽略。

　　* A元件：Animate（動(dòng)畫）

　　A元件中，可以包含任意數(shù)量的層級(jí)（即使是0），每一層級(jí)中，必須且只能有一段連續(xù)的動(dòng)畫，這段連續(xù)動(dòng)畫中，每幀都必須始終引用同一“影片剪輯”元件，“連續(xù)動(dòng)畫”之前，可以存在任意數(shù)量的空白幀，使前N幀保持空白。“連續(xù)動(dòng)畫”的最后一幀之后，不可再存在任何幀(空白幀、或引用其他元件的非空白幀)。

　　* 可以調(diào)用任何M元件，也可以調(diào)用A元件，但所調(diào)用A元件的序號(hào)必須小于當(dāng)前A元件的序號(hào)。例如 有 M_0 ~ M_20 與 A_0 ~ A_10 元件，A_5元件可以調(diào)用所有M元件與A_0 ~ A_4 元件，不能調(diào)用 A_5 ~ A_10 元件。

　　A元件可以有以下幾種屬性：

　　* 平移、縮放、旋轉(zhuǎn)、傾斜。

　　這四種屬性以外的屬性，會(huì)在編碼PAM過程中被忽略。

　　* 命名規(guī)則：

　　M元件的元件名，必須嚴(yán)格按照格式 M_%u 填寫，其中 %u 表示這個(gè)M元件的序號(hào)，序號(hào)從0開始計(jì)數(shù)，且不可中斷，例如：M_0、M_1、M_2......M_9。

　　A元件的命名同理。A_Main元件是特殊的A元件，他始終存在，并只能使用 A_Main 這個(gè)名稱。

　　* 導(dǎo)入一張位圖

　　可轉(zhuǎn)換為PAM的XFL動(dòng)畫中，只能包含位圖（并且為PNG格式）。

　　位圖導(dǎo)入XFL庫的步驟如下：

　　1. 在AN中，將一張PNG圖像導(dǎo)入到庫中，并進(jìn)行重命名，規(guī)則為：只能由數(shù)字、字母、下劃線組成，不包含文件后綴(如.png)。

　　2. 根據(jù)上文中的M元件命名規(guī)則，新建一個(gè)“影片剪輯”類型的元件；新建成功后，在這個(gè)M元件的第一層、第一幀中，加入第一步中添加到庫里的位圖，可以為其指定縮放與平移屬性。

　　3. 打開 xfl 文件夾 下的 OtherInfo.json 文件，在 "ImageSize" 對(duì)象的最后一個(gè)成員之后，添加新的成員，成員Key為圖像ID，對(duì)應(yīng)resources.json中的"ID"，圖像ID只由大寫字母、數(shù)組、下劃線組成；成員值是由兩個(gè)無符號(hào)整數(shù)(不可帶小數(shù)點(diǎn))組成的數(shù)組，兩個(gè)數(shù)分別表示圖像的寬高。

　　> 例如： "IMAGE_TEST_1": [ 11, 22 ] 。表示ID為IMAGE_TEST_1、高度11像素、寬度11像素的圖像。

　　4. 在 "ImageMapper" 對(duì)象的最后一個(gè)成員之后，添加新的成員，成員Key為第二版新建的M元件名，成員Value為第三步所添加的圖像ID。

　　# 創(chuàng)建新的A元件

　　1. 在AN中，創(chuàng)建一個(gè)“影片剪輯”元件，其命名符合A元件命名規(guī)則。

　　2. 打開 OtherInfo.json ，在 "SubAnimMapper" 對(duì)象的最后一個(gè)成員之后，添加新的成員，成員Key為第一步所新建的A元件的名稱，成員值為該A元件的標(biāo)簽名。

　　> A元件的標(biāo)簽可用于<元件屏蔽>。游戲可在播放動(dòng)畫時(shí)，指定某些標(biāo)簽的A元件不被顯示。游戲中的“植物裝扮切換”就是這個(gè)原理。

【注意事項(xiàng)】

　　# 注意點(diǎn)

　　## 轉(zhuǎn)換XFL為PAM時(shí)的注意事項(xiàng)

　　在轉(zhuǎn)換為PAM之前，需要打開XFL文件夾內(nèi)等 DOMDocument.xml 文件，并在第一行 DOMDocument 文字后面添加文字： __ABOUT__="This XFL is convert from PAM file, By SPC-Util." (ABOUT兩邊有雙下劃線)，才能使用SU進(jìn)行轉(zhuǎn)換。

　　## 關(guān)于圖像文件的尺寸

　　1. 標(biāo)準(zhǔn)尺寸：OtherInfo中指定的圖像尺寸：是按照 標(biāo)準(zhǔn)尺寸常數(shù) 定義的寬高屬性，必須是一個(gè)大于0的整數(shù)。

　　2. 分辨率縮放比：XFL庫中的位圖文件，都應(yīng)使用同一分辨率，默認(rèn)情況下由轉(zhuǎn)換出的XFL，使用的是 1536 分辨率。分辨率值會(huì)與 標(biāo)準(zhǔn)尺寸常數(shù) 復(fù)合，在M元件中定義了圖像的縮放數(shù)值。

　　> 圖像文件實(shí)際尺寸應(yīng)等于 標(biāo)準(zhǔn)尺寸 乘以 分辨率縮放比的倒數(shù)，計(jì)算結(jié)果舍去小數(shù)部分。

　　>

　　> 1536 分辨率的縮放比是 78.125 % (百分?jǐn)?shù))。所以 若導(dǎo)入一張 標(biāo)準(zhǔn)尺寸 為 100x100 的位圖，實(shí)際圖像文件的尺寸應(yīng)為 100x100 乘以 1/0.78165(約為1.28) = 128x128