[ARToolKit] Setup ARToolKit

ARToolKit

Documentation
→Beginner:Getting Started: Setup ARToolKit

(yahoo翻譯+google翻譯+me)


Setting up ARToolKit


Introduction

其核心， ARToolKit是一個開發的軟件庫集合，設計成連接到應用程序。
因此， ARToolKit是分散式原始碼，你必須在你的特定作業系統和平台編譯它。
你需要一個開發環境，適用於你的作業系統。
自由環境是可在所有平台利用的。
建立檔案還提供了能夠建立在Windows中的非免費微軟的Visual Studio平台。


然而ARToolKit提供類似的跨平台功能，根據您的作業系統安裝不同的。本指南中，我們將為你特定的安裝引導您完成安裝過程。


您的機器，操作系統和平台必須滿足一些基本要求。
您的硬件必須能夠截取視訊，並有足夠的CPU來處理視訊和顯示。
也有一些基本軟體的依賴 -- 避免編譯器和連結器錯誤。
主要的軟件套件是跨平台（如OpenGL的GLUT， (OpenGL utility toolkit， 負責作業系統相關的輔助函式庫)），
以及其他相關的為您的機器的特殊視訊函式庫（ DirectShow， V4L ， QuickTime） 。


該軟件相依為每個支持的操作系統概述如下連同安裝說明。



Building

Building on Windows(以Windows作業系統為例)

Prerequisites

(請點圖放大看~)

Building ARToolKit

準備好上述系統開發環境後，可以開始建置了ARtoolkit：


1. 解壓縮ARtoolkit壓縮檔到適當的位置。這個路徑在下列步驟中將以{ARtoolkit}表示。
2. 解壓縮DSVideoLib壓縮檔到{ARToolKit} 。檢查資料夾名稱是否為"DSVL"。
3. 從 {ARToolKit}\DSV\bin 複製 "DSVL.dll"及 "DSVLd.dll" 到{ARToolKit}\bin目錄下。
4. 安裝GLUT DLL 到Windows System32 資料夾中，並將glut32.lib及glut.h複製到Visual Studio平台下的適當位置。
5. 執行 {ARToolKit}\Configure.win32.bat 以建置 include/AR/config.h。
6. 打開ARToolKit.sln文件（ VS.NET ）或ARToolkit.dsw文件（ VS6 ） 。
7. Build the toolkit. (該專案)

若你選擇使用OpenVRML則需以下步驟：(範例為：libARvrml及simpleVRML)


8. OpenVRML解壓縮到{ARToolKit}。
9. 從 {ARToolKit}\OpenVRML\bin複製"js32.dll"到{ARToolKit}\bin目錄。
10. Enable the libARvrml and simpleVRML projects in the VS configuration manager and build.



Running the utilities and examples

目前ARToolKit最新版本沒有被設計限制在哪種環境下安裝。

目前編輯目錄應該用來建立您ARToolKit應用。

ARToolKit建立靜態函式庫，將這些連接到任何您建立的可執行的。

使用ARToolKit你需要有一些marker(標誌)：

測試應用時在patterns directory(樣式目錄)需要提出一些預設marker。

你可以在pdf reader打開這些樣子的圖形，然後列印下來。這些在下次試驗會有用。

ARToolKit的markers必須是堅固且不易彎曲的，簡易的解決方法是將有marker的紙張黏在紙板上。

之後你需要測試ARToolKit的圖形物件與你的應用是否能一起使用。

假如執行結果顯示為一個旋轉的茶壺：

Graphics Test Screenshot

這項測試證實你的camera 支援OpenGL的ARToolKit圖形模型。

建議最低frame(幀)速率為15 fps ，

低於的話，ARToolKit rendering(顯像)時 ，將受到太多限制。
你還需測試影像(視頻)輸入及影像顯示是否能正常運作。
在 bin目錄下執行videoTest。
假如執行無誤，視窗將顯示(見下圖)。

這項試驗證實，您的camera支援ARToolKit視頻(video)組件和ARToolKit圖形(graphics)組件。

Video Test Screenshot

如果在視窗中都沒有顯示，

這個問題可能是與你預設的camera的設置有關。