Skip to content

Latest commit

 

History

History
135 lines (88 loc) · 3.55 KB

windows-build.md

File metadata and controls

135 lines (88 loc) · 3.55 KB
Raw

Windows Setup Guide

Prerequisite

  1. Visual Studio with a C++17 compatible compiler (MSVC 19.15 or later)
  2. CMake >= 3.14
  3. Software Network SW client

Build Dependencies

  1. Download the source code of latest Leptonica and Tesseract release. Here we use leptonica 1.83.1 an tesseract 5.3.3.

  2. Extract the source to disk (~\Documents\third_party\ for example).

Install SW

  1. Download the latest release of SW client from here.
  2. Add path to SW client to system path.
  3. Run sw.exe setup as administrator.

Build Leptonica

  1. Open terminal, navigate to leptonica source direcotry

    cd ~\Documents\third_party\leptonica-1.83.1

  2. Configure CMake project

    cmake -B cmake-build-release -DCMAKE_BUILD_TYPE=Release
cmake -B cmake-build-debug -DCMAKE_BUILD_TYPE=Debug

  3. Build leptonica

    cmake --build cmake-build-release --config Release
cmake --build cmake-build-debug --config Debug

  4. Install leptonica

    By default, installation prefix is C:\Program Fils (x86)\, thus running powershell as administrator is required.

    cmake --install cmake-build-release
cmake --install cmake-build-debug

Build Tesseract

  1. Open powershell and navigate to tesseract source directory

    cd ~\Documents\third_party\tesseract-5.3.3

  2. Configure tesseract with cmake

    cmake -B cmake-build-release -DCMAKE_BUILD_TYPE=Release -DSW_BUILD=ON -DOPENMP_BUILD=ON
cmake -B cmake-build-debug -DCMAKE_BUILD_TYPE=Debug -DSW_BUILD=ON -DOPENMP_BUILD=ON

    Note:

    • If cmake complains about cannot find leptonica, add -DLeptonica_DIR=/path/to/leptonica/cmake to the configuratio command

  3. Build tesseract

    cmake --build cmake-build-release --config release
cmake --build cmake-build-debug --config debug

  4. Install tesseract

    Similar to leptonica, installing to default prefix requires running powershell as administrator.

    cmake --install cmake-build-release
cmake --install cmake-build-debug

  5. Prepare tesseract pre-trained model data

    1. Download pre-trained English model from GitHub repo.
    2. Copy the downloaded model eng.traineddata to C:\Program Fils (x86)\tesseract\share\tessdata
    3. Modify environment variable to set TESSDATA_PREFIX to be the above mentioned director.

Building TextSpotter from Powershell

  1. Clone the repository and navigate to the directory

  2. Crate a build directory

    mkdir build && cd build

  3. Configure textspotter with cmake

    cmake ..

    If cmake cannot find package like OpenCV or Tesseract, add their respective path to cmake arguments like this:

    cmake .. -DOpnCV_DIR="C:\opencv\build\x64\vc16\lib" -DTesseract_DIR="C:\Program Files(X86)\tesseract\lib\cmake"

  4. Build textspotter

    cmake --build .

Building TextSpotter from Visual Studio

  1. Clone the repo and open with Visual Studio

  2. Right click CMakeLists.txt and select CMake Settings.

  3. Add configurations x64-Release.

  4. Similar to powershell build, if package is not found, go to CMake Settings > Command arguments > CMake command arguments and add package dir manually.

  5. Click Build > Build All on the top menu bar to build all target.