# 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

Dependency | Required For | Install Location
--- | --- | ---
Visual Studio 2022 | Building from source | Default install
SDL3 | viewer.exe, fileviewer.exe | `C:\SDL3`
FFmpeg | videogen.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:

- Add the installation directory to your antivirus exclusions
- Restore quarantined files from the antivirus history
- Rebuild from source after adding exclusions

## 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