# Introduction

The sample programs demonstrate how to use the C and COM implementations of HTML Export. The sample code is intended to provide a starting point for your own applications or to be used for reference purposes.

The source code and makefile for each program are in the following directory, where `install` is the path of the Export installation directory, and `program_name` is the name of the sample program:

    install\htmlexport\programs\program_name

In addition to the sample programs, Micro Focus provides a reference implementation for HTML Export. For more information, see HTML Export Reference Implementation.

## C Sample Programs

The C sample programs demonstrate how to use the C implementation of HTML Export. The following sample programs are provided:

- tstxtract

- cnv2html

- cnv2htmloop

- onefile

- index

- io_samp

- htmlini

- callback

You can use the `tstxtract`, `cnv2html`, `cnv2htmloop`, and `htmlini` sample programs on Windows and UNIX. All other sample programs are for Windows only.

NOTE: The sample programs do not parse white space in file names. If your file names contain spaces, use quotation marks around the entire path name. Inserting quotation marks around the file name only does not work.

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 makefiles provided in the sample programs' directory. Ensure the HTML Export `include` directory is specified in the include path of the project. After the executables are compiled and built, you must place them in the same directory as the HTML Export 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.

## Compile the Visual Basic Sample Program

To compile Export Demo, use the Visual Studio project file (`demo_vb.vbp`) in the directory `install``\htmlexport\programs\ExportDemo`, where `install` is the path of the Export installation directory. The executable is in the same directory.

## COM Sample Program

The COM API is a COM interface to HTML Export and is available on 32-bit Windows platforms only. The interface is well suited for Visual Basic and Visual J++ programmers. The interface is an `IDispatch` interface, and can therefore be used with scripting environments such as Active Server Pages.

The following COM sample programs are provided:

- Template Wizard

- comsamp

- htmloop

To compile the Template Wizard, use the Visual Studio project file (`htmvbwzd.vbp`) in the `install\htmlexport\programs\wizard` directory, where `install` is the path name of the Export installation directory.

To compile the `comsamp` sample program, use the Visual Studio project file (`comsamp.vbp`) in the `install\htmlexport\programs\comsamp` directory.

To compile `htmloop`, use the Visual Studio project file (`htmloop2.dsw`) in the `install\htmlexport\programs\htmloop` directory.

_FT_HTML5_bannerTitle.htm