You are here: Start » Project Configuration

Project Configuration

General Information

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

Creating a New Project

Microsoft Visual Studio 2010

FabImage Library Lite is provided with a wizard that creates and configures a project for using FabImage Library Lite. To use the wizard, start Microsoft Visual Studio and choose the File | New | Project... command. The wizard called FILProject is available at Installed Templates | Visual C++ | FIL. Enter the name for your project and click OK. An empty project configured for using FabImage Library Lite will be created.

Microsoft Visual Studio 2012, 2013, 2015 and 2017

A project template similar to the wizard available for Visual Studio 2010 is available also for the newer versions. To create a new project using FabImage Library Lite, start Microsoft Visual Studio and choose the File | New | Project... command. The template called FIL 4.11 Project is available in the tab Installed | Templates | Other Languages | Visual C++.

Required Project Settings

All projects that use FabImage Library Lite need some specific values of the compiler and linker settings. If you want to use the Library in your existing project or you are manually configuring a new project, please apply the settings listed below:

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

Including Headers

Every source code file that uses FabImage Library Lite needs the #include <FIL_Lite.h> directive. A proper path to the FIL_Lite.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.

Distributing FabImage Library Lite with Your Application

Once the application is ready, it is time for preparing a distribution package or an installer. The final executable file of the application needs to have access to the proper version (used by Win32 or x64 configuration) of the FIL_Lite.dll file. Typically, the FIL_Lite.dll file should be placed in the same directory as the executable.

Previous: SDK Installation Next: Technical Issues