CompileHowto.md

Preparing build environment

Debian/Ubuntu

sudo apt-get update
sudo apt-get install build-essential cmake git nasm libasound2-dev libavahi-core-dev libavahi-compat-libdnssd-dev libglvnd-dev libqt5serialport5-dev libqt5sql5-sqlite libqt5svg5-dev libqt5x11extras5-dev libusb-1.0-0-dev python3-minimal qtbase5-dev

For X11 screen grabber

sudo apt-get install libx11-dev

For Linux CEC support library

sudo apt-get install libp8-platform-dev

Windows

We assume a 64bit Windows 10. Install the following;

• Git (Check: Add to PATH)
• CMake (Windows win64-x64 Installer) (Check: Add to PATH)
• Visual Studio 2019 Build Tools (direct link)
  • Select C++ Buildtools
  • On the right, just select MSVC v142 VS 2019 C++ x64/x86-Buildtools and latest Windows 10 SDK. Everything else is not needed.
• nasm (win64)
• Python 3 (Windows x86-64 executable installer) (Check: Add to PATH and Debug Symbols)
  • Open a console window and execute pip install aqtinstall.
  • Now we can download Qt to C:\Qt mkdir c:\Qt && aqt install -O c:\Qt 5.15.0 windows desktop win64_msvc2019_64
  • May need to add Qt path before compiling, for example: set CMAKE_PREFIX_PATH=C:\Qt\6.2.0\msvc2019_64\lib\cmake\ or set Qt5_Dir=C:\Qt\5.15.2\msvc2019_64\lib\cmake\Qt5\
  • QT6.2 requires Vulkan SDK https://vulkan.lunarg.com/sdk/home The installer should configure it, for example: set VULKAN_SDK=C:\VulkanSDK\1.2.182.0
• Optional for package creation: NSIS 3.x (direct link)

MacOs

First install brew manager. Next:

• brew install qt@5
• brew install cmake
• brew install xz

Compiling and installing HyperHDR

The general quick way (without big comments)

git clone --recursive https://github.com/awawa-dev/HyperHDR.git hyperhdr
cd hyperhdr
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j $(nproc)

# if this get stucked and dmesg says out of memory try:
make -j 2

# Run it from the build directory
bin/hyperhdr -d
# webui is located on http://localhost:8090 or 8091 and https on 8092

# optional: install into your system
sudo make install/strip
# optional: to uninstall (not very well tested, please keep that in mind)
sudo make uninstall

# BUILD INSTALLERS
# build the installer after the compilation 
cpack
# or compile and build the package using one command
cmake --build . --target package --config Release

Download

Creates hyperhdr directory and checkout the code from github

export HYPERHDR_DIR="hyperhdr"
git clone --recursive --depth 1 https://github.com/awawa-dev/HyperHDR.git "$HYPERHDR_DIR"

Preparations

Change into hyperhdr folder and create a build folder

cd "$HYPERHDR_DIR"
mkdir build
cd build

Generate the make files:

To generate make files with automatic platform detection and default settings:

cmake -DCMAKE_BUILD_TYPE=Release ..

Platform should be auto detected. For Windows, you can also force following settings (optional):

# You might need to setup MSVC env first
call "C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Auxiliary\Build\vcvars64.bat"
cmake -DPLATFORM=windows -G "Visual Studio 16 2019" ..

In Visual Studio select hyperhdr project as default for the solution to run it after compilation.

Run make to build HyperHDR

The -j $(nproc) specifies the amount of CPU cores to use.

make -j $(nproc)

On Windows run

cmake --build . --config Release -- -maxcpucount

Maintainer: To build installer, install NSIS and set env VCINSTALLDIR="C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC"

Install HyperHDR into your system

Copy all necessary files to /usr/local/share/hyperhdr

sudo make install/strip

If you want to install into another location call this before installing

cmake -DCMAKE_INSTALL_PREFIX=/home/pi/apps ..

This will install to /home/pi/apps/share/hyperhdr