AR ColorMapping

[![GitHub release (latest by date)](https://camo.githubusercontent.com/ca789431087654dfa0d8e80242737cf76298080fb270b5daa101317f959c747a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f61697261722d6465762f556e6974792d41522d436f6c6f724d617070696e673f636f6c6f723d346363353165)](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/) [![GitHub top language](https://camo.githubusercontent.com/c9a232e43684647d2ea3143ace1b585c90da21abec49a0c587d72153b88d354d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c616e6775616765732f746f702f61697261722d6465762f556e6974792d41522d436f6c6f724d617070696e673f636f6c6f723d313038316332)](https://github.com/airar-dev/Unity-AR-ColorMapping/search?l=c%23) [![GitHub License](https://camo.githubusercontent.com/bae551e50652949cfd0b5390db43c8e3ab2bec17d5f155f94e61bce52cd725ee/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f61697261722d6465762f556e6974792d41522d436f6c6f724d617070696e673f636f6c6f723d663438303431)](https://opensource.org/licenses/BSD-3-Clause) [![GitHub Watchers](https://camo.githubusercontent.com/f9b85f5836f935411475c38ad631cdfa8630cc01b9b76b3876b8ceed09b3c8d0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f77617463686572732f61697261722d6465762f556e6974792d41522d436f6c6f724d617070696e673f636f6c6f723d346363353165)](https://github.com/airar-dev/Unity-AR-ColorMapping/watchers) [![GitHub Repo stars](https://camo.githubusercontent.com/ef2e0f90c3c4ebb8d417f8c66bf685325b36858b79df45788cddd8ea9ff626f6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f61697261722d6465762f556e6974792d41522d436f6c6f724d617070696e673f636f6c6f723d346363353165)](https://github.com/airar-dev/Unity-AR-ColorMapping/stargazers) [![GitHub Forks](https://camo.githubusercontent.com/2f22ed5ae280ac7be7005346799346a9aa84445fea0eafaaaacc98b28d514f76/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f61697261722d6465762f556e6974792d41522d436f6c6f724d617070696e673f636f6c6f723d346363353165)](https://github.com/airar-dev/Unity-AR-ColorMapping/network/members)
[![Unity Badge](https://camo.githubusercontent.com/784f35ef2c93783a7ad5e2565fa209085fdefd6e051ab41968cee20bc2a08a52/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d556e69747933445f323032322e332e3466312d3030303f6c6f676f3d756e697479266c696e6b3d68747470733a2f2f756e6974792e636f6d2f)](https://unity.com/) [![Visual Studio Badge](https://camo.githubusercontent.com/d5e4faa0ace2a2595c7b02e3bcbeb89a1087690ed6faca0c2a428e9f90c73055/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d56697375616c5f53747564696f5f323032322d3543324439313f6c6f676f3d76697375616c2d73747564696f266c696e6b3d68747470733a2f2f76697375616c73747564696f2e6d6963726f736f66742e636f6d2f)](https://visualstudio.microsoft.com/) [![OS And Badge](https://camo.githubusercontent.com/de2274e0e3c6949c013f617169227e3773681e41c9b934284e57a17547c04ead/687474703a2f2f696d672e736869656c64732e696f2f62616467652f2d6f70656e63765f332e342e31305f616e64726f69645f73646b2d3344444338343f6c6f676f3d416e64726f6964266c6f676f436f6c6f723d666666266c696e6b3d68747470733a2f2f6f70656e63762e6f72672f72656c65617365732f)](https://opencv.org/releases/) [![OS IOS Badge](https://camo.githubusercontent.com/7bc5f57012fb98b6c422d39cf7c87889fee50e6dac3056a2fa42a5858da3fdca/687474703a2f2f696d672e736869656c64732e696f2f62616467652f2d6f70656e63762e6672616d65776f726b2d3966396639663f6c6f676f3d694f53266c6f676f436f6c6f723d666666266c696e6b3d68747470733a2f2f6f70656e63762e6f72672f72656c65617365732f)](https://opencv.org/releases/)

This project is an easy-to-apply AR Coloring Library for Unity.
This project can be applied to AR Engines of MaxstAR, EasyAR, Vuforia, ARFoundation(ARkit, ARcore).
To use it for business projects, you need to purchase a separate license for the AR Engine.

View Demo

## Table of Contents * [Requirements](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#requirements) * [Installation](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#installation) * [Quick Start](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#quick-start) * [with MaxstAR](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#with-maxstar) * [with EasyAR](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#with-easyar) * [with Vuforia](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#with-vuforia) * [with ARFoundation(ARkit, ARcore)](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#with-arfoundationarkit-arcore) * [Release](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#release) * [Future Release](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#Future-release) * [Trouble Shooting](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#Trouble-shooting) * [Known Issues](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#known-issues) * [Contributing](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#contributing) * [License](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#license) * [Contact](https://github.com/airar-dev/Unity-AR-ColorMapping/raw/master/#contact)
## Requirements * Unity3D 2019.3.14f1 * MaxstAR 5.0.2v * EasyAR 3.1.0v * Vuforia Engine AR Unity Package 9.5.4v * ARFoundation 2.1.8v * Visual Studio 2019 * opencv-3.4.10-android-sdk * opencv.framework(*3.4.11 version)
The opencv library can be downloaded from the official website.
Download the opencv from this link (https://opencv.org/releases/).

**\* As of August 3, 2021, the latest version of Unity3D and the latest version of each AR engine have been tested.** * Unity3D 2021.1.6f1 * MaxstAR 5.0.5v * EasyAR 4.3.0v * Vuforia Engine AR Unity Package 10.0v * ARFoundation 4.1.7v

**\* As of July 21, 2023, the latest version of Unity3D and the latest version of each AR engine have been tested.** * Unity3D 2022.3.4f1 * MaxstAR 6.0.1v * EasyAR 4.6.2v * Vuforia Engine AR Unity Package 10.16.3v * ARFoundation 5.0.6v

**\* As of July 29, 2024, the latest version of Unity3D and the latest version of ARFoundation have been tested.** * Unity3D 2023.2.0f1 * ARFoundation 5.1.5v

**\* As of July 30, 2024, the latest version of Unity3D and the latest version of Vuforia have been tested.** * Unity3D 2023.2.0f1 * Vuforia 10.25.4v

**\* As of Aug 9, 2024, multi-tracking supported ARFoundation samples have been updated.** * Unity3D 2023.2.0f1 * ARFoundation 5.1.5v
## Installation 　1. Clone a repository or download it as zip. ``` git clone https://github.com/airar-dev/ColorMapping.git ``` 　2. Importing the AR Engine SDK to be used together.
　　(You can use MaxstAR, EasyAR, Vuforia, ARFoundation(ARkit, ARcore))

## 3D Guide https://youtu.be/2-h8aBLddjY

## Quick Start ### with MaxstAR **Create Android App Project Demo(https://youtu.be/JhixOsRKQ5k)**
**Create iOS App Project Demo(https://youtu.be/h3YQMaf7R-E)**

　**1. Create Project**
　-　Create an empty Unity3D project.

　**2. Import [MaxstAR](https://developer.maxst.com/MD/downloadsdk)**
　-　Import MaxstAR SDK(5.0.2v +).

　**3. Import Sample Package**
　-　After extracting the downloaded file,
　　 import ColorMappingWithMaxstARSample.unitypackage from
　　 ColorMapping-master -> Sample folder.

　**4. Import Native Library**
　-　Import ‘libAirarColorMap.so, libopencv_java3.so’ file for Android.
　　(Set the CPU to ARM64 in the platform settings of the libAirarColorMap.so, libopencv_java3.so files.)
　-　Import ‘libAirarColorMap.a, opencv2.framework’ file for iOS.

　**5. Player Settings for Android**

Allow 'unsafe' code	Check the Allow 'unsafe' code
Scripting Backend	Select IL2CPP
Target Architectures	Check Arm64 architecture(uncheck ARM7)
Scripting Define Symbols	Add ‘USE_MAXSTAR’ into Scripting Define Symbols

　**6. Player Settings for iOS**

Allow 'unsafe' code	Check the Allow 'unsafe' code
Scripting Backend	Select IL2CPP
Target Architectures	Check Arm64 architecture(uncheck ARM7)
Scripting Define Symbols	Add ‘USE_MAXSTAR’ into Scripting Define Symbols

　**7. Setting for 3D Contents**

‘coloring’ tag　　　　　

Set ‘coloring’ tag for Object containing the material
to which the colored texture is applied

　**8. MaxstARColorMapping.cs**

![masxtar-1]

trackableBehaviour	MaxstAR ImageTrackableBehaviour
ARContents	3D object to augment
RealWidth	Actual horizontal size of the marker image
RealHeight	Actual vertical size of the marker image

　**9. Build**
　-　Build by selecting the MaxstARSample scene under ColorMapping -> Scenes.

### with EasyAR **Create Android App Project Demo(https://youtu.be/elk7-E3LDYc)**
**Create iOS App Project Demo(https://youtu.be/bcKe0nKg5fg)**

　**1. Create Project**
　-　Create an empty Unity3D project.

　**2. Initialize [EasyAR](https://www.easyar.com/view/download.html)**
　-　EasyAR 3.1.0 Version + required.
　-　For EasyAR to work, a license key is required.

　**3. Import Sample Package**
　-　After extracting the downloaded file,
　　 import ColorMappingWithEasyARSample.unitypackage from
　　 ColorMapping-master -> Sample folder.

　**4. Import Native Library**
　-　Import ‘libAirarColorMap.so, libopencv_java3.so’ file for Android.
　　(Set the CPU to ARM64 in the platform settings of the libAirarColorMap.so, libopencv_java3.so files.)
　-　Import ‘libAirarColorMap.a, opencv2.framework’ file for iOS.

　**5. Player Settings for Android**

Allow 'unsafe' code	Check the Allow 'unsafe' code
Graphics APIs	Remove Vulkan from the Graphic API list
Scripting Backend	Select IL2CPP
Target Architectures	Check Arm64 architecture(uncheck ARM7)
Scripting Define Symbols	Add 'USE_EASYAR' into Scripting Define Symbols

　**6. Player Settings for iOS**

Allow 'unsafe' code	Check the Allow 'unsafe' code
Graphics APIs	Remove Metal from the Graphic API list
Scripting Backend	Select IL2CPP
Architecture	Check Arm64 architecture(uncheck ARM7)
Scripting Define Symbols	Add 'USE_EASYAR' into Scripting Define Symbols

　**7. Setting for 3D Contents**

‘coloring’ tag　　　　　

Set ‘coloring’ tag for Object containing the material
to which the colored texture is applied

　**8. EasyARColorMapping.cs**

![easyar-1]

ImageTargetController	EasyAR ImageTargetController
ARContents	3D object to augment
RealWidth	Actual horizontal size of the marker image
RealHeight	Actual vertical size of the marker image

　**9. Build**
　-　Build by selecting the EasyARSample scene under ColorMapping -> Scenes.

### with Vuforia **Create Android App Project Demo(https://youtu.be/b5zSwDiwE4Q)**
**Create iOS App Project Demo(https://youtu.be/s1TcKE2PzXk)**

　**1. Create Project**
　-　Create an empty Unity3D project.

　**2. Import Vuforia Unity Package**
　-　Importing the Vuforia Engine AR Unity Package(9.5.4v +) and Vuforia Sample Package.

　**3. Import Sample Package**
　-　After extracting the downloaded file,
　　 import ColorMappingWithVuforiaSample.unitypackage from
　　 ColorMapping-master -> Sample folder.

　**4. Import Native Library**
　-　Import ‘libAirarColorMap.so, libopencv_java3.so’ file for Android.
　　(Set the CPU to ARM64 in the platform settings of the libAirarColorMap.so, libopencv_java3.so files.)
　-　Import ‘libAirarColorMap.a, opencv2.framework’ file for iOS.

　**5. Player Settings for Android**

Allow 'unsafe' code	Check the Allow 'unsafe' code
Scripting Backend	Select IL2CPP
Target Architectures	Check Arm64 architecture(uncheck ARM7)
Scripting Define Symbols	Add 'USE_VUFORIA' into Scripting Define Symbols

　**6. Player Settings for iOS**

Allow 'unsafe' code	Check the Allow 'unsafe' code
Scripting Backend	Select IL2CPP
Target Architectures	Check Arm64 architecture(uncheck ARM7)
Scripting Define Symbols	Add 'USE_VUFORIA' into Scripting Define Symbols

　**7. Setting for 3D Contents**

‘coloring’ tag　　　　　

Set ‘coloring’ tag for Object containing the material
to which the colored texture is applied

　**8. VuforiaColorMapping.cs**

![vuforia-1]

ImageTaget	Vuforia ImageTargetBehaviour
ARContents	3D object to augment
RealWidth	Actual horizontal size of the marker image
RealHeight	Actual vertical size of the marker image

　**9. Build**
　-　Build by selecting the VuforiaSample scene under ColorMapping -> Scenes.

### with ARFoundation(ARkit, ARcore) **Create Android App Project Demo(https://youtu.be/nR0D5B6s6dA)**
**Create iOS App Project Demo(https://youtu.be/lzDVS_dOwV4)**

　**1. Create Project**
　-　Create an empty Unity3D project.

　**2. Import ARFoundation Unity Package**
　-　Importing the ARFoundation(2.1.8v +),
　　 ARCore(for Android)(2.1.11v +), ARKit(for iOS)(2.1.9v +) Unity Package.

　**3. Import Sample Package**
　-　After extracting the downloaded file,
　　 import ColorMappingWithARFoundationSample.unitypackage from
　　 ColorMapping-master -> Sample folder.

　**4. Import Native Library**
　-　Import ‘libAirarColorMap.so, libopencv_java3.so’ file for Android.
　　(Set the CPU to ARM64 in the platform settings of the libAirarColorMap.so, libopencv_java3.so files.)
　-　Import ‘libAirarColorMap.a, opencv2.framework’ file for iOS.

　**5. Player Settings for Android**

Allow 'unsafe' code	Check the Allow 'unsafe' code
Scripting Backend	Select IL2CPP
Target Architectures	Check Arm64 architecture(uncheck ARM7)
Scripting Define Symbols	Add 'USE_ARFOUNDATION' into Scripting Define Symbols
Minimum API Level	Android 7.0(API Level 24)+

　**6. Player Settings for iOS**

Allow 'unsafe' code	Check the Allow 'unsafe' code
Scripting Backend	Select IL2CPP
Architecture	Check Arm64 architecture(uncheck ARM7)
Scripting Define Symbols	Add 'USE_ARFOUNDATION' into Scripting Define Symbols
Target minimum iOS Version	11.0+

　**7. Setting for 3D Contents**

‘coloring’ tag　　　　　

Set ‘coloring’ tag for Object containing the material
to which the colored texture is applied

　**8. ARFoundationColorMapping.cs**

![arfoundation-1]

ImageManager	ARTrackedImageManager
ARContents	3D object to augment
RealWidth	Actual horizontal size of the marker image
RealHeight	Actual vertical size of the marker image

　**7. Build**
　-　Build by selecting the ARFoundationSample scene under ColorMapping -> Scenes.

## Release | Version | New Features | Date | |:---:|---|:---:| | 　v1.3.7　 | [multi-tracking supported ARFoundation samples have been updated.](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.3.7) | 　2024.08.09　 | | 　v1.3.6　 | [the latest version of Unity3D and the latest version of Vuforia have been tested.](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.3.6) | 　2024.07.30　 | | 　v1.3.5　 | [the latest version of Unity3D and the latest version of ARFoundation have been tested.](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.3.5) | 　2024.07.29　 | | 　v1.3.4　 | [the latest version of Unity3D and the latest version of each AR engine have been tested.](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.3.4) | 　2023.07.21　 | | 　v1.3.3　 | [Upload samples compatible with the latest version of Vuforia](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.3.3) | 　2023.05.31　 | | 　v1.3.2　 | [Upload samples compatible with the latest version of Vuforia](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.3.2) | 　2022.11.30　 | | 　v1.3.1　 | [the latest version of Unity3D and the latest version of each AR engine have been tested.](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.3.1) | 　2021.08.03　 | | 　v1.3.0　 | [update all sample for Android/iOS](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.3.0) | 　2020.10.27　 | | 　v1.2.1　 | [modify sample unitypackages for android](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/1.2.1) | 　2020.10.23　 | | v1.2.0 | [update android sample](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/v1.2.0) | 2020.10.23 | | v1.1.0 | [add iOS Library](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/3) | 2020.10.21 | | v1.0.1 | [add EasyAR sample](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/2) | 2020.10.07 | | v1.0.0 | [Apply MaxstAR, EasyAR](https://github.com/airar-dev/Unity-AR-ColorMapping/releases/tag/v1.0.0) | 2020.09.09 |
## Future Release * We will add a method for creating coloring 3D content in the near future.
## Trouble Shooting * If an error such as "Undefined symbols for architecture arm64" occurs.
　　example:
``` Undefined symbols for architecture arm64: "cv::getPerspectiveTransform(cv::Point_ const*, cv::Point_ const*)", referenced from: _ImageProc in libAirarColorMap.a(AirarColorMap.o) (maybe you meant: cv::getPerspectiveTransform(cv::Point_ const*, cv::Point_ const*, int)) ld: symbol(s) not found for architecture arm64 clang: error: linker command failed with exit code 1 (use -v to see invocation) ```
　　solutions:
　　Be sure to use **version 3.4.11 of the opencv framework.**

## Known issues * The coloring is not very accurate when used with the MaxstAR engine.
## Contributing * Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

　1.　Fork the Project.
　2.　Create your Feature Branch.
　3.　Commit your Changes.
　4.　Push to the Branch.
　5.　Open a Pull Request.

## License * The 3-Clause BSD License. (see the LICENSE file inside this repo)
## Contact * oh@airar.co (sung hoon oh)

[masxtar-1]: https://camo.githubusercontent.com/ce09f139e2ccb41b0a273b21c1caf4f8fc135cc307ccd83bdf304424273df213/687474703a2f2f61697261722e636f2e6b722f436f6c6f724d617070696e672f496d672f4d61787374415253616d706c65496d675f30312e6a7067 [easyar-1]: https://camo.githubusercontent.com/2f5c5d125117f852dc5b4c5798cc10a211778be834a88157753393d772b10548/687474703a2f2f61697261722e636f2e6b722f436f6c6f724d617070696e672f496d672f45617379415253616d706c65496d675f30312e6a7067 [vuforia-1]: https://camo.githubusercontent.com/e0f0769f14dcc959fd02c4ff259cba9be89e6d8b5f16c0968bee5c34d5e847bb/687474703a2f2f61697261722e636f2e6b722f436f6c6f724d617070696e672f496d672f5675666f72696153616d706c65496d675f30315f3232313133302e6a7067 [arfoundation-1]: https://camo.githubusercontent.com/99711296d5107a0a19fb4189770bce7c658fc8fc63ed146c97bfa0044af349e7/687474703a2f2f61697261722e636f2e6b722f436f6c6f724d617070696e672f496d672f4152466f756e646174696f6e53616d706c65496d675f30312e6a7067