C/C++ Interface
C/C++ Interface
The C/C++ Interface makes it possible to integrate Rainbow PDF Server Based Converter V3.0 into C/C++ programs.
The following header files are included in [Install directory]/include.
| Header file | Contents | Location |
|---|---|---|
| dfvifc.h | Header for C++ | [Install directory]/include |
| dfvifc_c.h | Header for C |
The following library files are included in [Install directory]/lib or [Install directory]/lib.
| Library file | Contents | Location |
|---|---|---|
| DfvInterface.dll | C/C++ Interface Library for Windows | [Install directory] |
| libDfvInterface.so | C/C++ Interface Library for Solaris / Linux | [Install directory]/lib |
In the Windows version the following library file for link is included in [Install directory]/lib.
| Library file | Contents | Location |
|---|---|---|
| DfvInterface.lib | Library for DLL linking | [Install directory]/lib |
Rainbow PDF Server Based Converter V3.0 Windows version is built using Microsoft Visual C++ 6.0. MFC is not used. Please use a compatible compiler for your program.
Rainbow PDF Server Based Converter V3.0 Solaris version is built using Forte Developer 7 C++ 5.4 or Sun Studio 11. Please use a compatible compiler for your program.
Rainbow PDF Server Based Converter V3.0 Linux version is built using GCC 3.2.X. Please note that the C++ binaries are incompatible with GCC 3.2 (or later) and earlier versions of GCC releases including 3.1.1, 3.0 and 2.9. Your program must be compiled using GCC 3.2 or later. Rainbow PDF Server Based Converter V3.0 Linux 64bit version is built using GCC 3.4.X. Your program must be compiled using GCC 3.4 or later. For more detailed information about GCC, please refer to the GCC home page.
[Install directory]/samples/cpp and [Install directory]/samples/c includes some simple sample programs.
In order to build a sample with the command line of Visual C++ in the Windows environment, execute the compiler from the console as follows.
> cd [Install directory]/samples/cpp > cl -GX -I ..\..\include sample.cpp ..\..\lib\DfvInterface.lib /MT
[Install directory]/lib must be appended to the PATH environment variable in order to execute this program. The sample executes as follows.
The following command-line shows how to build the sample in the Solaris environment. Be sure to specify libXfoInterface.so to the linker as the library. [Install directory]/lib must be appended to LD_LIBRARY_PATH environment variable.
$ cd [Install directory]/samples/cpp
$ LD_LIBRARY_PATH=../lib:${LD_LIBRARY_PATH}
$ export LD_LIBRARY_PATH
$ CC sample.cpp -I../include -L../lib -lDfvInterface -oSamplecppcmd -mt
In order to execute the built sample program, a setup of other environment variables is necessary. Please refer to Environment Variables for more details.
The following command-line shows how to build the sample in the Linux environment using GCC.
$ cd [Install directory]/samples/cpp
$ LD_LIBRARY_PATH=../lib:${LD_LIBRARY_PATH}
$ export LD_LIBRARY_PATH
$ g++ sample.cpp -I../include -L../lib -lDfvInterface -oSamplecppcmd -lstdc++ -lpthread
In order to execute the built sample program, a setup of other environment variables is necessary. Please refer to Environment Variables for more details.
As mentioned previous, the GCC version is very important. Please check your GCC version using --version command-line option.
$ g++ --version g++ (GCC) 3.2.2 Copyright (C) 2002 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Please refer to the document that was generated by Doxygen.