ARToolKitUWP

ARToolKit Wrapper for UWP (Universal Windows Platform)

Author: Long Qian

Date: 2020-04-19

Overview

ARWrapper library provided by ARToolKit is compatible with multiple platforms, but not with UWP yet. This project intends to fill this gap. The native library built by this project consumes UWP runtime, and can be accessed by .NET applications via PInovoke.

Starting v0.3, ARToolKitUWP supports HoloLens 2 (ARM64) in addition to HoloLens 1 (x86).

What's in?

ARToolKitUWP.sln solution builds a dynamic link library for x86 or ARM64, namely, ARToolKitUWP.dll. This library incorperates the following ARToolKit (v5.3.2) components:

• AR.lib
• ARICP.lib
• ARMulti.lib

Therefore, this wrapper is capable of detecting single-pattern markers and multi-pattern markers. NFT (Natural Feature Marker) is not supported right now, because of its various unsatisfied dependencies on UWP.

Exported APIs

The exported functions from this dll are listed in ARToolKitUWP/include/ARToolKitUWP.h.

Build

• Make sure you have Visual Studio 2017 and Windows 10 SDK installed.
• Open solution file ARToolKitUWP.sln, choose configuration Release, Win32 or Release, ARM64, and hit Build Solution.
• Find the ARToolKitUWP.dll file at the output directory. Simple.

For Unity3D and HoloLens

Place the built library in Unity project folder: Assets/ARToolKitUWP/Plugins/WSA/x86/ or Assets/ARToolKitUWP/Plugins/WSA/ARM64/. In the Unity inspector, these libraries need to be manually set for WSAPlayer and the correct CPU architecture.

---

License

ARToolKitUWP is open for use in compliance with GNU Lesser General Public License (LGPL v3.0). Please see COPYING and COPYING.LESSER for license details.

ARToolKitUWP is a modified version of ARToolKit, statically links against ARToolKit binaries, and therefore complies with the license restrictions of ARToolKit (see details).