ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
• Programming with Motif:
° Getting started with Motif programming
° Motif ArcGIS control programming
• Programming with GTK:
° Getting started with GTK programming
° GTK ArcGIS control programming
• Event handling on ArcGIS controls
• Walkthroughs discussing additional areas of the C++ API can be found in
the developer help system under Development Environments > C++ >
Walkthroughs. They include how to write custom commands, tools, and
events.
• Error handling
INITIALIZING THE SOLARIS AND LINUX ARCGIS ENGINE
With your machine ready for C++ development, there is only a single step to
prepare for ArcGIS Engine development, and that is to source the /arcgis/init_engine.sh (or .csh, depending on your shell of
choice). If you prefer, that can be done in your shell’s RC file (.cshrc or .bashrc,
for example). Otherwise, you must source that file once per shell.
If you have the engine installed and registered, but you are getting the error
message “Error: Could not open include file .”, try sourcing the
init_engine script.
If your GCC compiler on Linux has not been
installed in a standard location, some of your
compiled applications may not be able to find
libstdc++.so at runtime. In this case, you will
need to add this library’s directory (usually lib)
to your LD_LIBRARY_PATH
environment variable.
You are also able to mix and match by coding in
one development environment and compiling in
another. For example, you can write code in
Visual Studio but compile and build it via a
script utilizing the command-line tools. Keep in
mind, however, that Motif and GTK code will not
compile or run on Windows.
Supported compilers
On Windows, the Visual Studio 6.0 and Visual Studio .NET 2003 compilers are
supported by the ArcGIS C++ API.
On Solaris, the Sun Workshop (Forte) 6 update 2 compiler is supported.
On Linux, the supported compiler is GCC version 3.2.
Development environments
As an ArcGIS C++ API developer, you can choose any development environment
as long as you use a supported compiler. However, if you want to use an
integrated development environment (IDE) on Windows, either
Visual Studio 6.0 or Visual Studio .NET 2003 (7.1) is recommended. If you
don’t want to use an IDE, you can write your code in any text editor and compile
it from the command line. If you choose this option, it is recommended that you
use the Windows nmake utility, the Solaris make utility, or the Linux make utility,
accessed from the corresponding command prompt. Your choice of development
environment depends entirely on your personal preference and the tools available.
This section focuses on each of these options, as well as the option of using
Motif or GTK in your Solaris and Linux applications.
212 • ArcGIS Engine Developer Guide