# Introduction

The C sample programs demonstrate how to use the C implementation of the Filter API. The sample code is intended to provide a starting point for your own applications or to be used for reference purposes.

The following C sample programs are provided:

- tstxtract
- filter

The source code and makefile (`program_name_platform.mak`) for the programs are in the directory `install\samples\program_name`, where `install` is the path of the Filter installation directory, and `program_name` is the name of the sample program.

The sample programs pass license information to KeyView using fpInitWithLicenseData(). This is the method recommended by Micro Focus. Before the sample programs can be compiled, you must replace the parameters `YOUR_LICENSE_ORGANIZATION` and `YOUR_LICENSE_KEY` in the `fpInitWithLicenseData()` function call with your license information.

To compile the sample programs, use the makefile provided for the appropriate platform. Make sure that the Filter `include` directory is specified in the include path of the project. After the executable is compiled and built, you must place it in the same directory as the Filter libraries.

NOTE: Compiled binaries are provided for some of the sample programs, in the `PLATFORM/bin` folder. These have an embedded trial license, which expires approximately five months after release. If the environment variables KV_SAMPLE_PROGRAM_LICENSE_ORGANIZATION and KV_SAMPLE_PROGRAM_LICENSE_KEY are set, their values are used instead of the trial license. This allows you to continue to use the program after the embedded trial license has expired, and also to test or troubleshoot with your actual license.

_FT_HTML5_bannerTitle.htm