The tsmAPI Library: Tutorials

COMPILING A TSMAPI PROGRAM

This tutorial describes how you can compile programs that have been developed with the tsmApi library. As of tsmApi 2.1, there are 11 library files that are part of the tsmApi distribution. These are:

lib/libtsmApi.a - the library for the tsmApi itself.
lib/libvrml2.a - provides functions for parsing VRML 2.0 format files and managing the subsequent scene graph.
lib/libpthrutil.a - this library provides a number of multi-threading utility functions.
lib/libtiff.a - this is the standard TIFF library that provides routines for reading and writing TIFF format image files. This library is freely-available from ftp://ftp.sgi.com/graphics/tiff.
libjpeg.a - provides support for reading and writing JPEG format images. This is required by the TIFF library.
libz.a - this is a general purpose data compression library. It is required by the TIFF library.
libxml.a - this is the standard libxml library for creating and parsing XML format files.
libungif.a - provides gif image reading support
libnspr4.a - the Netscape Portable Run-Time, for platform-independent threading, file access, and network models.
libghttp.a - the GNOME http support library
libgeotiff.a - the GeoTIFF reading/writing library

Thie following Makefile gives you an example of compiling a single tsmUtils program under the Solaris and Irix platforms. You will need to configure the TSMN32, TSMO32, TSMSOL, TSMWIN definitions appropriately to point to your tsmApi installation directory.

TARGET   = make_geovrml.c

TSMN32   = tsmApi-2.1/irix-6.5-n32-inst
TSMO32   = tsmApi-2.1/irix-6.5-o32-inst
TSMSOL   = tsmApi-2.1/solaris-5.6-inst
TSMWIN   = tsmApi-2.1/mingw32-inst

IRIXLIBS = -ltsmApi -lgeotiff -lungif -lghttp -lxml -lvrml2 -lpthrutil \
           -ltiff -ljpeg -lz -lnspr4 -lc -lpthread -lm
SUNLIBS  = -ltsmApi -lgeotiff -lungif -lghttp -lxml -lvrml2 -lpthrutil \
           -ltiff -ljpeg -lz -lnspr4 -ldl -lsocket -lnsl -lposix4 \
           -lc -lpthread -lm
WINLIBS  = -ltsmApi -lgeotiff -lungif -lghttp -lxml -lvrml2 -lpthrutil \
           -ltiff -ljpeg -lz -lnspr4 -lwsock32 -lwinmm -lm

irix-n32:
	cc -n32 $(TARGET) -I$(TSMN32)/include -o $(TARGET:.c=) \
	-L$(TSMN32)/lib $(IRIXLIBS)

irix-o32:
	cc $(TARGET) -I$(TSMO32)/include -o $(TARGET:.c=) \
	-L$(TSMO32)/lib $(IRIXLIBS)

cygwin:
	gcc $(TARGET) -I$(TSMWIN)/include -o $(TARGET:.c=.exe) \
	-L$(TSMWIN)/lib $(WINLIBS)

solaris:
	gcc $(TARGET) -I$(TSMSOL)/include -o $(TARGET:.c=) \
	-L$(TSMSOL)/lib $(SUNLIBS)

clean:
	rm -f *~ $(TARGET:.c=)

After this, you should have a binary called foo which you can run. Note that we linked against all of the tsmApi libraries, the DPSS libraries, and a couple of system libraries (pthread and math).

Next Tutorial: Opening a Dataset Connection

The tsmApi Home Page / The tsmApi Tutorials Page

Martin Reddy, <reddy@ai.sri.com> / Yvan Leclerc, <leclerc@ai.sri.com>
Last modified: Thu Jan 11 14:47:03 PST 2001