aruco-ios-demo icon indicating copy to clipboard operation
aruco-ios-demo copied to clipboard

Tiny iOS app integrating the Aruco library

Aruco iOS demo

Platforms Swift Version License

Tiny iOS app integrating the Aruco library and the OpenCV camera calibration tool, including a wrapper in Objective-C++ that allows access to the APIs from Swift.

App screenshot


Setup

In order to setup the project, follow these steps:

  • Download the Aruco library (v3.0.X) from this mirror (as the official repo doesn't keep this version any longer; see #5)
  • Copy the folders src and 3rdparty into the Aruco folder of the project.
  • From the project root, run chmod -R 755 ./Aruco/3rdparty/eigen3/Eigen.
  • Download OpenCV 3.4.X (iOS pack) from here.
  • Make a new folder Frameworks in the project root and copy opencv2.framework into it.
  • Install the remaining dependencies by running pod install.

If everything went well, your project should now look like this (omitting less relevant files):

.
├── Aruco
│   ├── 3rdparty/
│   ├── ArucoWrapper.h
│   ├── ArucoWrapper.mm
│   └── src/
├── ArucoDemo/
├── ArucoDemo.xcodeproj
├── ArucoDemo.xcworkspace
├── Frameworks
│   └── opencv2.framework
├── Podfile
├── Podfile.lock
└── Pods/

You might also need to comment out parts of the Aruco library that involve windows, as these are not needed for the app and will cause errors when compiling. See also this issue.

Requirements

  • Xcode 9.0
  • iOS 10.0 or above

Contributing

Contributions of any kind are more than welcome! Make a pull request or open an issue.

License

This project is released under the MIT license. See LICENSE for more information.