Home Hardware Quick Start Settings Troubleshooting
Home » Installation

Installation

From ZIP Package

  1. Extract VideoDistanceMarking-x.x.x.zip to a folder (e.g., C:\VideoDistanceMarking)
  2. The package contains: 
    bin\              Executables + SDL3.dll + ffmpeg.exe
doc\              Documentation (this help system)
settings.txt      Sample configuration file
  3. Copy settings.txt into the bin\ directory (or specify the path when launching programs)
  4. Edit settings.txt for your hill — see Settings Reference

From Source

See BUILD.md in the project root for full build instructions. Summary:

cmake -B build -G "Visual Studio 17 2022" -DSDL3_DIR=C:/SDL3/cmake
cmake --build build --config Release
ctest --test-dir build -C Release

Dependencies

DependencyRequired ForInstall Location
Visual Studio 2022Building from sourceDefault install
SDL3viewer.exe, fileviewer.exeC:\SDL3
FFmpegvideogen.exe (runtime)C:\ffmpeg

Antivirus Configuration

Norton and some antivirus programs may quarantine newly built or extracted executables. If programs disappear or fail to start:

First-Time Setup

  1. Connect all three USB capture devices to separate USB 3.0 controllers
  2. Verify devices appear in Windows Device Manager under "Cameras" or "Imaging Devices"
  3. Copy settings_sample.txt to settings.txt
  4. Edit motion regions for each feed to match your camera views
  5. Proceed to Quick Start to test the system