Click or drag to resize

Getting Started

This document describes how to get started with using STK Components in your application.

Adding STK Components to an Application

In order to use STK Components in your own application, perform these steps:

  1. Obtain a valid license file (either a temporary license from AGI support or the license you purchased) and place it in the same directory as the STK Components assemblies: [Install Directory]\Assemblies. The file should have a .lic file extension. You can request a temporary development license from AGI Technical Support by e-mailing your request to support@agi.com.

  2. Add references to the STK Components assemblies to your project. In Visual Studio, this is easily accomplished by right-clicking your project and then clicking Add Reference. Then, navigate to [Install Directory]\Assemblies and select the assemblies you would like to use in your application.

  3. Add the licenses.licx file, which is found with the STK Components assemblies as well, to your project. Adding this file to your project tells Visual Studio to look for the .lic file at compile time and embed it in your application. This way, your application can be deployed without the need for an external license file. See the Licensing and Deployment topic for details and advanced scenarios.

For a detailed walkthrough of building an application with STK Components, see the Tutorial.

Insight3D®

The Insight3D visualization library currently only works on 64-bit Microsoft Windows operating systems, in a 64-bit process.

Using Insight3D requires that you perform some additional steps beyond the ones described above:

Install the Microsoft Visual C++ Redistributable for Visual Studio 2017

Insight3D depends on the Microsoft Visual C++ Redistributable for Visual Studio 2017, which should be installed on any system where you intend to run your application. For convenience, the installer, vc_redist.x64.exe, is included in the root directory of your STK Components installation.

The ability to load the required dependencies from the application directory ("app-local") is also technically possible, but due to the complexity is not described here. Contact AGI support if you have a need to deploy Insight3D applications without an installer on systems that cannot install the redistributable.

Configure your application to run as a 64-bit process

By default, a .NET application created with Visual Studio uses the Any CPU configuration. Because Insight3D is a 64-bit only assembly, it is easiest to configure the solution to build your application as a 64-bit process.

In Visual Studio, select Build, Configuration Manager. Open the Active solution platform list, and select New....

Configuration Manager

Add a new x64 solution platform, and make sure the Create new project platforms checkbox is checked.

New Solution Platform

The result should be that your project is set to x64, as seen below.

Configuration Manager With x64 Configuration

Enabling Features From External Libraries

Certain Insight3D features require third-party functionality from separate DLLs. Specifically, using videos as 2D textures requires FFmpeg video processing libraries (avcodec-57.dll, avformat-57.dll, avutil-55.dll, swresample-2.dll, swscale-4.dll), and MrSID imagery requires the LizardTech MrSID DSDK (Altidsdk_9.5.dll, Alb.dll).

These separate DLLs will be loaded when needed at runtime from the same directory as the Insight3D library (AGI.Foundation.Graphics.dll). You can either copy these files to your project output directory manually, or you can add these DLLs as content to your Visual Studio project and mark the files as Copy if newer.

Alternatively, if you don't use any functionality in Insight3D that requires the separate DLLs, you can skip this.