map.h

CD_高级PALM编程

/********************************************************************
* FILE:				Map.h
*
* DESCRIPTION:	The header file for the map module.
*
* VERSION:		1.0
**********************************************************************/

#ifndef __MAP_H
#define __MAP_H

typedef UInt32 TMapID;
typedef Char TMapLabel[32];

#define mapIDNull ( 0 )



typedef struct _TMapInfoType 
{
	RectangleType mapBounds;	// How big is the map we're viewing?
	BitmapType *mapBitmapP;
	MemHandle mapBitmapH;
	TMapID mapID;
	
} TMapInfoType, *TMapInfoTypePtr;

typedef enum _EMapPOIType
{
	mapPOILayerTypeUnknown = 0,
	mapPOILayerTypeCafe = 1,
	mapPOILayerTypeRestaurant = 2
	// and others to follow
} EMapPOIType;

typedef struct _TMapPOILayerItem
{
	EMapPOIType type;
	TMapLabel label;
	TMapID map;
	PointType pos;
} TMapPOILayerItem, *TMapPOILayerItemPtr;

typedef enum _EMapLayerType
{
	mapLayerNone = 0,
	mapLayerPOI = 1
	// More to follow
} EMapLayerType, EMapLayerTypePtr;

typedef struct _TMapLayer
{
	EMapLayerType type;
	TMapLabel name;
	DmResID icon;
	UInt16 count;
	TMapPOILayerItem *layerDataPtr;
} TMapLayer, *TMapLayerPtr;


/*
 * Map IDs
 */
#define mapBoulderCreek24	0
#define mapBoulderCreek12	1


extern TMapInfoTypePtr MapFetchMap
(
	TMapID mapID,	// (in) Map to fetch
	Err *errP		// (out) what error occurs
									       
);


extern Err MapReleaseMap
(
	UInt32 TMapID,
	TMapInfoTypePtr infoP	// (in) location of map info to clear
									       
);

extern PointType *MapCoordToScreenCoord	// (out) screen-relative coordinates
(
	PointType	*mapPoint,			// (in) point on map
	const RectangleType	*screenRect			// (in) map area on screen
);

extern PointType *ScreenCoordToMapCoord	// (out) screen-relative coordinates
(
	PointType	*screenPoint,			// (in) point on map
	const RectangleType	*screenRect		// (in) map area on screen
);

extern PointType *MapCoordToTapCoord	// (out) screen-relative coordinates
(
	PointType	*mapPoint,			// (in) point on map
	PointType	*mapOriginP,					// (in) scroll point of map
	const RectangleType	*screenRect			// (in) map area on screen
);

extern PointType *TapCoordToMapCoord	// (out) screen-relative coordinates
(
	PointType	*tapPoint,			// (in) point on map
	PointType	*mapOriginP,				// (in) scroll point of map	
	const RectangleType	*screenRect		// (in) map area on screen
);

TMapLayerPtr MapFetchLayer
(
	TMapID mapID,
	EMapLayerType layer,
	Err *errP
);

Err MapReleaseLayer
(
	TMapID mapID,
	TMapLayerPtr layerP
);



#endif