Your choice of programming language determines how you must install LuciadCPillar. You can either program in C++ or in C#.

Before you start the installation, verify that your system complies with the LuciadCPillar Hardware and software requirements.

Installing LuciadCPillar for C++ development

To install LuciadCPillar and compile the C++ samples:

  1. Extract the LuciadCPillar_Pro-Windows.zip archive.

  2. Extract the LuciadCPillar_Pro_Documentation.zip archive.

  3. Extract the LuciadCPillar_Pro_Data.zip archive.

  4. Copy your LuciadCPillar license file, named luciadcpillar_development.txt, into the folder licenses.

  5. Open the x64 Native Tools Command Prompt that came installed with the Visual Studio version you are working in.

  6. Go to the extracted LuciadCPillar folder.

  7. Go to the folder cpp:

    >cd cpp
  8. Create a folder build, and step into that folder:

    >mkdir build
    >cd build
  9. Generate the Visual Studio solution:

    1. Make sure to include the folder with the Qt executable Programs in the Windows PATH environment variable: C:\Tools\Qt\5.12.6\msvc2017_64\bin, for example.

    2. Use CMake to generate the Visual Studio solution with the generator related to your Visual Studio version, for example Visual Studio 15 2017 Win64 or Visual Studio 16 2019.
      Make sure to point to the correct location for Qt5 in the command. These are examples of the cmake command:

      >cmake ../ -G "Visual Studio 15 2017 Win64" -DCMAKE_BUILD_TYPE=RelWithDebInfo -DQt5_DIR="C:/Qt/5.12.6/msvc2017_64/lib/cmake/Qt5"

      or

      >cmake ../ -G "Visual Studio 16 2019" -A x64 -DCMAKE_BUILD_TYPE=RelWithDebInfo -DQt5_DIR="C:/Qt/5.12.6/msvc2017_64/lib/cmake/Qt5"
  10. Open the generated solution file cpp/build/AllSamples.sln with Visual Studio.

  11. Select ALL_BUILD in the Solution Explorer, go to Build > Configuration Manager, and change the Active solution configuration to Release or RelWithDebInfo.

  12. Right-click ALL_BUILD in the Solution Explorer, and click Build to build all samples.

  13. Select the sample you want to run. For instance, to select sample_firstapp:

    1. Right-click on sample_firstapp project.

    2. Select Set as StartUp Project.

  14. Run the application sample, by pressing F5 for instance.

Installing LuciadCPillar for C# development

To install LuciadCPillar and compile the C# samples:

  1. Extract the LuciadCPillar_Pro-Windows.zip archive.

  2. Extract the LuciadCPillar_Pro_Documentation.zip archive.

  3. Extract the LuciadCPillar_Pro_Data.zip archive.

  4. Copy your LuciadCPillar license file, named luciadcpillar_development.txt, into the folder licenses.

  5. Open the x64 Native Tools Command Prompt that came installed with the Visual Studio version you are working in.

  6. Go to the extracted folder.

  7. Go to the folder csharp:

    >cd csharp
  8. Create a folder build, and step into that folder:

    >mkdir build
    >cd build
  9. Generate the Visual Studio solution.

    1. Make sure that the environment variable PATH includes the directory containing nuget.exe. Alternatively, you can specify it on the cmake command line by adding the parameter -DCMAKE_PROGRAM_PATH=c:\directory\containing\nuget. See the next step for a command line example.

    2. Use CMake to generate the Visual Studio solution with the generator related to your Visual Studio version. These are some examples of cmake commands:

      >cmake ../ -G "Visual Studio 15 2017 Win64"

      or

      >cmake ../ -G "Visual Studio 16 2019" -A x64 -DCMAKE_PROGRAM_PATH="C:\Users\myUser\nuget"
  10. Open the generated solution file csharp/build/AllSamplesCSharp.sln with Visual Studio.

  11. Select ALL_BUILD in the Solution Explorer, go to Build > Configuration Manager, and change the Active solution configuration to Release or RelWithDebInfo.

  12. Right-click ALL_BUILD in the Solution Explorer, and click Build to build all samples.

  13. Select the sample you want to run. For instance, to select csharp_sample_wpf:

    1. Right click on csharp_sample_wpf in the Solution Explorer.

    2. Select Set as StartUp Project.

  14. Run the application, by clicking the Start button for example.