Skip to content

Installation

Alec Musasa edited this page Jan 10, 2022 · 4 revisions

Using the prebuilt binaries

Prebuilt binaries can be found here.

  1. Download the latest release. This will be a zip file under "Assets".
  2. Extract the content of the zip folder on your computer. The extract will have three sub-directories:

    • bin - contains the binary files (dlls)
    • lib - contains the static library files that accompany the dlls
    • include - contains the include files

    Below is a description of the files under the /bin directory:

    File Description
    lecui32.dll 32 bit release build
    lecui64.dll 64 bit release build
    lecui32d.dll 32 bit debug build
    lecui64d.dll 64 bit debug build

    The files in the /lib directory are named after the respective dlls.

  3. Open your Microsoft Visual Studio project's properties and for All Configurations and All Platforms set the following:

    • C/C++ -> General -> Additional Include Directories -> Edit -> New Line ... add \liblec\include
    • Linker -> General -> Additional Library Directories -> Edit -> New Line ... add \liblec\lib
    • Debugging -> Environment -> Edit ... add PATH=\liblec\bin;PATH%

    Now you can use the library using

    #include <liblec/lecui/...>

Compiling the source code

Below is what you need to know if you need to compile the source code yourself:

Compile-time Dependencies

The library has the following compile-time dependencies:

boost C++ libraries

  • assumes boost 1.72 prebuilt binaries are in C:\local\libs\boost_1_72_0
  • download prebuilt boost binaries here
  • For example, the binaries for boost 1.72 are here
  • For Microsoft Visual Studio 2019 you can download the file boost_1_72_0-msvc-14.2-64.exe (64 bit) and boost_1_72_0-msvc-14.2-32.exe (32 bit).
  • if the boost c++ library is installed elsewhere you will need to change the Microsoft Visual Studio project properties under Properties - C/C++ - General - Additional Include Directories and also under Properties - Linker - General - Additional Library Directories.

Building

Create a folder '\liblec' and clone the repository into it such that it resides in 'liblec\lecui'. Open the Microsoft Visual Studio Solution file liblec\lecui\lecui.sln. Select Build -> Batch Build, then select the desired configurations of the given four:

  1. Debug x86
  2. Relese x86 (32 bit Release Build)
  3. Debug x64
  4. Release x64 (64 bit Release Build)

Build.

After the build is complete, three folders will be created in the \liblec directory, namely bin, lib and include. You can use these files the same way described above under "Using the prebuilt binaries".