Compiler setup

Windows

Requirements:

VisualStudio 2019 and higher
CMake

macOS

Requirements:

Xcode 14.2 and higher
CMake

Linux

Requirements:

clang
cmake

License file placement

A license file is required to use the evaluation version. Please place the license file in the folder as described below.

Windows

Place the license file ailia.lic in the same foolder as ailia.dll (or in the cpp folder if this is the sample).

macOS

Place the license file ailia.lic in ~/Library/SHALO/.

Linux

Place the license file ailia.lic in ~/.shalo/.

Building the sample

Move to the cpp folder, then run the command corresponding to your OS as described below.

Windows

cl ailia_tracker_sample.cpp ailia.lib ailia_audio.lib ailia_tokenizer.lib ailia_tracker.lib

macOS

clang++ -o ailia_tracker_sample ailia_tracker_sample.cpp libailia.dylib libailia_audio.dylib libailia_tracker.dylib libailia_tokenizer.dylib -Wl,-rpath,./ -std=c++17

Linux

export LD_LIBRARY_PATH=./

g++ -o ailia_tracker_sample ailia_tracker_sample.cpp libailia.so libailia_audio.so libailia_tokenizer.so libailia_tracker.so

Downloading model files

Download model files from links below. And then, place them in the same folder as binary file.

Running the sample

Run the sample by executing the command below.

./ailia_tracker_sample <video path>

Example of output:

env_id : 0 type : 0 name : CPU
env_id : 1 tyoe : 1 name : CPU-AppleAccelerate
env_id : 2 type : 2 name : MPSDNN-Applie M2
you can select environment using -e option
enb_id: 2
selected enb name : MPSDNN-Apple M2
Program finished successfully.

Available options when executing the sample

The sample executable can take the following options.

./ailia_tracker_sample [-h, --help] VIDEO_PATH [-w WEB_CAMERA] [-o OUTPUT_VIDEO_PATH] [-e ENV_ID]

See below for details about each argument:

Contents	Details
Input video file name	Indicates the input video file
Use web camera	Set this flag when input source is web camera stream
Output video file name	Indicated the output video file (MP4 format)
Backend environment	Indicates the backend environment

Platform-specific remarks

Release the 'downloaded' attribute in MacOS

Binaries downloaded from the browser in macOS may have a 'downloaded' attribute and may not be able to be executed. In that case, it is possible to remove the attribute by right-clicking on the .dylib file and executing it. You can also release the 'downloaded' attribute by executing the following command from the command line:

xattr -d com.apple.quarantine libailia_tracker.dylib