ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
Compiling your application
Once Makefile.Solaris or Makefile.Linux is ready to compile your application, you
can compile from the command line by typing “make -f Makefile.Solaris” or
“make -f Makefile.Linux”, as appropriate.
Running your application
You can either invoke your application directly or through the makefile. If you
choose to invoke it directly, you will need to provide command-line parameters
from the command line. To use the makefile to run an ArcGIS Engine commandline
application, you must set up the command-line parameters in the makefile.
Update your makefile to include variables for each input parameter and a run
target.
An example of these modifications is shown below:
# Setting up the program argument
INPUT = /mycomputer/data/inputfile
...
# Setting up a run target
run:
$(PROGRAM) $(INPUT)
Once Makefile.Solaris or Makefile.Linux is ready for use with your application,
you will be able to run from the command line by typing “make -f
Makefile.Solaris run” or “make -f Makefile.Linux run”, as appropriate.
ARCGIS MOTIF DEVELOPMENT WITH MAKE AND THE SOLARIS/
LINUX COMMAND PROMPT
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.
If desired, you can utilize the template
Makefile.SolarisMotif or Makefile.LinuxMotif
provided with ArcGIS Engine in ArcGIS Developer
Help. Refer to the next section for details on
these sample files.
Setting up a compiler for use from the command prompt
Sun WorkShop (Forte) 6 update 2 (CC) for Solaris; GCC version 3.2 (g++) for
Linux
Initializing 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.
Setting up your application
Setting up an ArcGIS Engine C++ Motif application is exactly like setting up an
ArcGIS Engine C++ application—there are only a few additional libraries to add
to the makefile. For those of you familiar with ArcGIS Engine C++ programming,
you will only need to add motifctl, aoctl, Xm, Xt, and X11 as libraries to
link against (that is, add them with the -l flag, as shown in Step 3 below). If you
are not familiar with ArcGIS Engine C++ programming, all the steps you need to
take in preparing your application are discussed below.
Open your favorite text editor and begin writing your code. Use a makefile to set
the following include directories, library options, and compiler options.
Chapter 4 • Developer environments • 219