Using the IGC Libraries and API in C++ |
If you are using C++ to create your plugin, you must link your plugin with the IGC dynamic library and the IGC C++ static library. The names of these libraries depend on the operating system that you are using:
| Library Type | Library Name on Windows | Library Name on Unix, Linux or Mac OS X |
|---|---|---|
| IGC Dynamic Library | IGC.dll | libIGC.so, libIGC.dylib, or libIGC.sl |
| IGC C++ Static Library | IGC.lib | libIGC_cpp.a |
The IGC dynamic library is located in the directory in which Iguana is installed. The IGC C++ static library is built on your computer from the source and project files that are supplied in the IGC subdirectory of the directory in which Chameleon is installed.
 | |||
|
When you are running a plugin in C++, if you have the wrong version of the IGC dynamic library on your system, you may see an error message similar to the following:
For more details on this error message, see Language-Specific Iguana Communication Library Error Messages. | |||
 |
An API is provided to enable your plugin to interact with the IGC libraries. To view the reference documentation for this API, follow this link: CHM, CHMnet and IGC Libraries Data Structures. Data structures in this reference whose names start with IGC can be used in plugins.
For details on how characters are encoded in C++ plugins, see IGCcharacterEncoding Class Reference.
 | ||
|
If you are creating a 64-bit plugin on Windows, you must add the directory in which your 64-bit version of Iguana is installed to your PATH environment variable. In this environment variable, this directory must appear before the directory in which Chameleon is installed. If you are running Iguana on Windows, you have created a 32-bit plugin to interface with 32-bit Iguana and you upgrade to the 64-bit version of Iguana, be sure to save a copy of the 32-bit version of IGC.dll and ensure that your 32-bit plugin refers to it. This will allow you to continue using your 32-bit plugin with 64-bit Iguana. A 32-bit plugin will not work with the 64-bit version of IGC.dll that is included with the 64-bit version of Iguana. | ||
 |
| ||
|
When you are compiling a 64-bit C++ plugin using Visual Studio 2008, you must build using the Debug|x64 or the Release|x64 project configuration. | ||
|