MAYA C++ API | 從編譯環境到 MAYAPluginWizard 精靈安裝 – 步驟篇
本文陳述我的整個安裝經驗,為求行文順暢,本文不提及各種可能遇到的錯誤訊息。而是留到一下一小節,屆時再完整的列舉我遇到的所有問題。(最後更新 2013-11-08)
系列目錄
一、MAYA C++ API 編譯環境設置 – with Visual Studio
二、我的安裝經驗,從C++到精靈安裝 – 步驟篇 (不提及各種錯誤訊息)
我的安裝經驗,從C++到精靈安裝 – 步驟篇 (不提及各種錯誤訊息)
我的作業系統與軟體環境
首先描述我的環境,Windows 7 64bit + Visual Studio 2010 Express + Maya 2013 64 bit ,其實這非常的重要,有些問題其實都出在版本不同,如果可以,你最好還是嚴格按照官網的建議版本。
MAYA 2013 所建議的版本是 Visual Studio 2010 。
1. 安裝 Visual Studio 環境,請參考:
Windows SDK 7.1的Visual Studio 2010 SP1相容性問題更新檔 by [賴榮樞]的軟體資訊誌
安裝順序應該是 Visual Studio 2010 → Windows SDK 7.1 → 2010 SP1 → SP1 修正檔
安裝完畢後,建議先做 Hello World 測試,其中可能遇到的問題請參考 C++ 研究小劄之始 ,Hello World 沒問題後,再繼續下一步。
2. 安裝MAYA 外掛精靈 ( MayaPlugInWizard ),請詳閱官網的安裝步驟:
Maya Plug-in Wizard For Visual Studio
- 進入資料夾 D:\Program Files\Autodesk\Maya2013\devkit\pluginwizard ,看到 ,MayaPluginWizard2.0.zip,先解壓縮,之後產生資料夾MayaPluginWizard。
- 進入MayaPluginWizard 資料夾,找到MayaPluginWizard.vsdir 、MayaPluginWizard.vsz、MayaPluginWizard.ico三個檔案,先把三個檔案複製到 C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\Express\VCProjects
- 再把頂層 MayaPluginWizard 資料夾複製到 C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\VCWizards
- 官網特別標註提醒,請你不要複製「子資料夾的 MayaPluginWizard 」,而要複製頂層的 MayaPluginWizard
圖一、官網提醒
圖二、複製三個檔案與頂層資料夾
3. 複製完畢後,執行 C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\vcvarsall.bat 使 Visual Studio 環境重建一次。 (這是我的個人建議,雖然官網或其他文件可能沒提)
圖三、執行 vcvarsall.bat
4. 精靈安裝完畢,開啟 Visual Studio → 檔案 → 新增 → 專案,視窗裡面應該要有 MayaPlugInWizard 的圖示,請參考下圖四。先幫你的專案取的名稱後,點選 MayaPlugInWizard 圖示以新增一個專案,例如、 helloworld 專案。
注意、我習慣不勾選「為方案建立目錄」,因為會多一兩層資料夾,怕路徑可能因此而錯。
圖四、 MayaPlugInWizard 圖示
5. 跳出精靈設定介面,MAYA版本當然是2013,而下面的路徑,看你是否把maya安裝在預設路徑? 我安裝在 D:\Program Files\Autodesk\Maya2013,所以我必須選下面的 custom location,並填入我的安裝路徑。
圖五、專案精靈第一步
6. 選擇最簡單的 MEL 命令,而且不帶有 Undo 功能。
圖六、專案精靈第二步
7. library 只需要Foundation 跟 OpenMaya
圖七、專案精靈第三步
8. 弄篇 HelloWorld 的範例程式碼來試試,請參考官網: Writing a simple plug-in ,你可以加上自己的註解,然後準備編譯前的工作。
9. 編譯前,先把必要的 64 位元程式庫路徑設定好:
我安裝的是 Windows SDK 7.1 ,所以路徑應該是 :C:\Program Files\Microsoft SDKs\Windows\v7.1\Lib\x64 ,但為求保險起見,你可把下述兩路徑都加入:
- C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\lib\amd64
- C:\Program Files\Microsoft SDKs\Windows\v7.1\Lib\x64
你需找到專案的屬性頁裡面的下述兩個欄位(參考下圖八):
- 組態屬性→VC++目錄→程式庫目錄,並加入路徑
- 組態屬性→連結器→一般→其他程式庫目錄,並加入路徑
加入步驟是:在欄位右側點一下左鍵,跳出一個小選單,選取 <編輯> ,然後在跳出視窗內操作即可。請參考下圖八:
圖八、加入程式庫路徑的操作方法
10. 按下 Ctrl + F5 (或 F5),完成Hello World 的編譯,至此,第一個 HelloWorld 外掛便產生了,隨後將之安裝到 MAYA 內,即可在 MAYA 命令列執行此指令了。
圖九、編譯成功
11. 編譯好的程式以 helloworld.mll 的格式儲存,那麼要到哪裡找它呢?
- 先找到你的專案檔路徑,例如、我的文件\MS Visual Studio 10.0\helloworld\
- 找資料夾 Debug 或 Release,helloworld.mll 就在裡面。
12. 後續
- 如果你遇到錯誤,請參考 我的安裝經驗,從C++到精靈安裝 – 可能錯誤篇
- 如果你想知道如何執行編譯好的檔案,請參考 MAYA C++ API Hello World !
- 如果你想進一步學習 C++ API 的資料結構或函式內容,請參考以下網頁。
- 官網 API Guide 、API Reference
- Maya API Programming
- Maya開發(一)—緒論 by 吥啦吥啦吥啦的博客
- maya技術 by 80Monkey
Leave a Reply