You are here: Start » C++ Project Configuration

C++ Project Configuration

General Information

Adaptive Vision Deep Learning Library is designed to be used as a part of C++ projects developed with Microsoft Visual Studio in versions 2010-2017.

Required Project Settings

All projects that use Adaptive Vision Deep Learning Library need some specific values of the compiler and linker settings. Please apply the settings listed below to configured project:

  • Configuration Properties | General
    • Character Set should be set to Use Unicode Character Set.
  • Configuration Properties | C/C++
    • General
      • Additional Include Directories should contain the $(AVLDL_PATH4_12)\include\ path.
  • Configuration Properties | Linker
    • General
      • Additional Library Directories should contain the proper path to directory containing the AVLDL.lib file. The proper path is $(AVLDL_PATH4_12)\lib\$(PlatformName)\.
    • Input
      • Additional Dependencies should contain AVLDL.lib file.
  • Configuration Properties | Build Events
    • Post-Build Event
      • Command Line should contain copy "$(AVLDL_PATH4_12)\bin\$(PlatformName)\AVLDL.dll" "$(OutDir)" call. This setting is not mandatory, but the application using Adaptive Vision Deep Learning Library requires an access to the AVLDL.dll file and this is the easiest way to fulfill this requirement.

Including Headers

Every source code file that uses Adaptive Vision Deep Learning Library needs the #include <AVLDL.h> (and/or #include <Api.h>) directive. A proper path to the AVLDL.h file is set in the settings of the compiler (described above), so there is no need to use the full path in the directive.

Providing Dependencies

All programs using AVLDL.dll have to load DLL files from Deps_x64 subdirectory of Adaptive Vision Deep Learning Addon installation directory. Common ways to ensure that are:

  • add path to Deps_x64 directory to PATH environment variable, or
  • copy contents of Deps_x64 to some directory listed in PATH environment variable, or
  • copy contents of Deps_x64 next to AVLDL.dll.

Distributing Adaptive Vision Deep Learning Library with Your Application

Once the application is ready, it is time for preparing a distribution package or an installer. There are several requirements that needs to be fulfilled:

  • The final executable file of the application needs to have access to the AVLDL.dll file and its dependencies. Typically, the AVLDL.dll file should be placed in the same directory as the executable. Dependencies can be provided in several ways, described above.
  • Note, that most of Adaptive Vision Deep Learning Library functions require running Adaptive Vision Deep Learning Service. It is installed with Adaptive Vision Deep Learning Addon package.
  • The computer that the application will run on needs a valid license for the use of Adaptive Vision Deep Learning Addon product. Licenses can be managed with the License Manager application, that is installed with Adaptive Vision Deep Learning Addon package.
  • A license file (*.key) can be also manually copied to the end user's machine without installing Adaptive Vision Deep Learning Addon. It must be placed in a subdirectory of the AppData system folder. The typical location for the license file is C:\Users\%USERNAME%\AppData\Local\Adaptive Vision\Licenses. Remember that the license is valid per machine, so every computer that runs the application needs a separate license file.
  • Alternatively to the (*key) files we support USB Dongle licenses.
Previous: Installation Manual Next: C# Project Configuration