Building

Dependency

Build tools:

• CMake
• A C++17 compatible compiler

Dependency handling:

• If you have internet access, CMake will automatically download and configure most required dependencies.
• You can also manually download dependencies.

Manual configuration (optional):

• Most dependencies are located via find_package. Others may use pkg-config or require explicit path specification via CMake variables.
• For certain dependencies, dedicated CMake variables (e.g., AC_PATH_XXX) are provided.
• Setting these variables will:
  1. Direct CMake to search in your specified paths first
  2. Override default search locations

List of dependencies

Dependency	CMake option	Module	Acquisition	Manual Configuration
CUDA Toolkit	AC_CORE_WITH_CUDA	core(CUDA)	Manual	find_package
libavcodec	AC_BUILD_VIDEO	video	Manual	pkg-config / AC_PATH_FFMPEG
libavformat	AC_BUILD_VIDEO	video	Manual	pkg-config / AC_PATH_FFMPEG
libavutil	AC_BUILD_VIDEO	video	Manual	pkg-config / AC_PATH_FFMPEG
libswscale	AC_BUILD_VIDEO	video	Manual	pkg-config / AC_PATH_FFMPEG
Qt	AC_BUILD_GUI	gui	Manual	find_package
Avisynth SDK	AC_BUILD_FILTER_AVISYNTH	filter(avisynth)	Automatic	AC_PATH_AVISYNTH_SDK
CLI11	AC_BUILD_CLI	cli	Automatic	find_package
DirectShow BaseClasses	AC_BUILD_FILTER_DIRECTSHOW	filter(directshow)	Automatic	AC_PATH_DIRECTSHOW_BASECLASSES
Eigen3	AC_CORE_WITH_EIGEN3	core(eigen3)	Automatic	find_package
OpenCL SDK	AC_CORE_WITH_OPENCL	core(opencl)	Automatic	find_package
pybind11	AC_BUILD_BINDING_PYTHON	binding(python)	Automatic	find_package
ruapu	N/A	core	Automatic	AC_PATH_RUAPU
stb	N/A	core	Automatic	AC_PATH_STB
VapourSynth SDK	AC_BUILD_FILTER_VAPOURSYNTH	filter(vapoursynth)	Automatic	pkg-config / AC_PATH_VAPOURSYNTH_SDK

• The minimum tested version of the CUDA Toolkit is 11.
• The minimum version of FFmpeg libraries is FFmpeg 4.
• Both Qt5 and Qt6 should be OK.
• VapourSynth SDK 4 is required.
• For non MSVC compilers, a modified version of the DirectShow BaseClasses will be used.

Platform

Windows

Tested with MinGW-w64, Clang and MSVC.

DirectShow filter is only available on Windows, tested compilers include MinGW-w64, ClangCL and MSVC.

Build with MinGW-w64:

mkdir build; cd build
cmake -G "MinGW Makefiles" .. -DAC_CORE_WITH_OPENCL=ON -DAC_ENABLE_STATIC_CRT=ON
cmake --build . --config Release -j8
cd bin
./ac_cli -v

Build with MSVC:

mkdir build; cd build
cmake -G "Visual Studio 17 2022" .. -DAC_CORE_WITH_OPENCL=ON
cmake --build . --config Release -j8
cd bin/Release/
./ac_cli -v

To setup FFmpeg libraries for building video module on Windows, it is recommended to add an AC_PATH_FFMPEG variable to CMake, but you can also use pkg-config for Windows. AC_PATH_FFMPEG should be a path to the FFmpeg's root folder witch contains lib and include.

To add AC_PATH_FFMPEG to CMake, click Add Entry button in cmake-gui or use -DAC_PATH_FFMPEG="path/to/ffmpeg/root" in terminal.

You can download FFmpeg with sdk from BtBN (ffmpeg-master-latest-win64-gpl-shared.zip or ffmpeg-master-latest-win64-lgpl-shared.zip) or gyan.dev (ffmpeg-release-full-shared.7z) for Windows.

Linux

Tested with gcc and Clang.

# Toolchain
sudo apt install cmake build-essential
# For video module:
sudo apt install pkg-config libavcodec-dev libavformat-dev libavutil-dev libswscale-dev
# For GUI:
sudo apt install qt6-base-dev qt6-tools-dev
# For python binding:
sudo apt install python3-dev

mkdir build && cd build
cmake .. -DAC_CORE_WITH_OPENCL=ON #-DAC_BUILD_VIDEO=ON -DAC_BUILD_GUI=ON
cmake --build . --config Release -j8
cd bin
./ac_cli -v

Termux

To build with OpenCL support, you need install ocl-icd package, OpenCL SDK from Khronos seems not to be worked with termux.

pkg install cmake clang ocl-icd opencl-clhpp opencl-headers
mkdir build && cd build
cmake .. -DAC_CORE_WITH_OPENCL=ON
cmake --build . --config Release -j8
cd bin
LD_LIBRARY_PATH=/vendor/lib64:$PREFIX/lib ./ac_cli -l

WASM

Tested with Emscripten.

Mac OS

Tested with Apple Clang via github actions, MACOSX_DEPLOYMENT_TARGET >= 10.12 is required.

CMake options

Option	Description	Default
AC_SHARED_LIB	build as a shared library	OFF
AC_CORE_WITH_EIGEN3	build core with eigen3	OFF
AC_CORE_WITH_SSE	build core with x86 sse	Auto detect
AC_CORE_WITH_AVX	build core with x86 avx	Auto detect
AC_CORE_WITH_FMA	build core with x86 fma and avx	Auto detect
AC_CORE_WITH_NEON	build core with arm neon	Auto detect
AC_CORE_WITH_WASM_SIMD128	build core with wasm simd128	Auto detect
AC_CORE_WITH_OPENCL	build core with opencl	OFF
AC_CORE_WITH_CUDA	build core with cuda	OFF
AC_CORE_ENABLE_FAST_MATH	enable fast math for core	OFF
AC_CORE_DISABLE_IMAGE_IO	disable image file read and write for core	OFF
AC_BUILD_CLI	build cli	ON
AC_BUILD_GUI	build gui	OFF
AC_BUILD_VIDEO	build video module	OFF
AC_BUILD_FILTER_AVISYNTH	build avisynth filter	OFF
AC_BUILD_FILTER_VAPOURSYNTH	build vapoursynth filter	OFF
AC_BUILD_FILTER_DIRECTSHOW	build directshow filter (Windows only)	OFF
AC_BUILD_FILTER_AVISYNTH_VAPOURSYNTH	build an avisynth and vapoursynth universal filter	OFF
AC_BUILD_BINDING_C	build c binding for core	OFF
AC_BUILD_BINDING_PYTHON	build python binding for core	OFF
AC_TOOLS_BENCHMARK	build benchmark	OFF
AC_TEST_UTIL	build util module test	OFF
AC_TEST_VIDEO	build video module test	OFF
AC_TEST_WASM	build wasm test (Emscripten only)	OFF
AC_ENABLE_LTO	enable LTO	OFF
AC_ENABLE_STATIC_CRT	enable static link crt	OFF
AC_DISABLE_RTTI	disable rtti	OFF
AC_DISABLE_EXCEPTION	disable exception	OFF
AC_DISABLE_PIC	disable pic or pie	OFF

There are some convenient presets:

AC_PRESET_RELEASE

• AC_CORE_WITH_OPENCL
• AC_CORE_WITH_CUDA
• AC_CORE_ENABLE_FAST_MATH
• AC_BUILD_CLI
• AC_BUILD_GUI
• AC_BUILD_VIDEO
• AC_BUILD_FILTER_AVISYNTH_VAPOURSYNTH
• AC_BUILD_FILTER_DIRECTSHOW (Windows only)