#ifndef __MAPTAP_CLIENT_H__
#define __MAPTAP_CLIENT_H__
// maptapClient.h version 1.0,  15 August 2003.  
// Copyright (c) 2003 Mobile Geographics LLC.
// Permission granted to use this code in any PalmOS application.

#define MapTapAtlasCreator 'Mmap'

// feature numbers
#define MapTapCallerFtr 0
#define MapTapAtlasSelFtr 1
#define MapTapScaleFtr 2
#define MapTapCenterFtr 3
#define MapTapPointsFtr 4
#define MapTapPointCountFtr 5
#define MapTapPointLabelsFtr 6
#define MapTapTitleFtr 7
#define MapTapTextFtr 8

// values to select atlas within MapTap Atlas
#define MapTapAtlasSelWorld 1
#define MapTapAtlasSelUSA 2

typedef struct {
	float x;
	float y;
} MapTapClientPoint;

typedef enum {MaptapWorld=0, MaptapUSA} MaptapAtlasSelectionType;

// all of these functions return false on failure, true on success.
Boolean MaptapAtlasPresent(void);
/* returns true if MapTap Atlas is installed on the PDA, false if not */

Boolean MaptapDefineMap(float x, float y, float scaleInverse, 
						MaptapAtlasSelectionType atlas);
/* defines center of map (in longitude/latitude), inverse scale factor, and
   atlas to use (MapTapAtlasSelWorld or MapTapAtlasSelUSA).  scaleInverse is 
   the denominator of the scale factor; e.g. for a 1:24,000 scale USGS topo
   quad, scaleInverse is 24000.
   
   A return of "false" means not enough memory was available to store the parameters.
*/

Boolean MaptapLaunchAtlas(UInt32 callerCode);
/* Launch MapTap Atlas and create a map using the parameters previously
   passed in MaptapDefineMap and MaptapSetTitle.  Pass the calling app's 
   4-letter creator code as callerCode; when the user taps the "Done" button
   the app with that callerCode will be launched.
*/

Boolean MaptapSetTitle(Char* textP);
/* Set a title for the map.  If no title is set, displays "MapTap Atlas" as the title.

   A return of "false" means not enough memory was available to store the parameters.

*/
#endif  //  __MAPTAP_CLIENT_H__