AddBitmapToMap()

static int CApplicationAPI::AddBitmapToMap ( LpError  lpError, LPCTSTR  lpszBitmapPath, long  lX, long  lY, UINT &  nBitmapID, DWORD  dwMaxTime = DEFAULT_MAX_TIME  )

static

The function shows picture on BrowseMap.

Parameters

lpError	Additional error information returned from Drive.
lpszBitmapPath	Full path to desired picture.
lX	X-coordinate of picture position on BrowseMap.
lY	Y-coordinate of picture position on BrowseMap.
nBitmapID	Picture ID that can be used later to manipulate with picture. Value is set by AddBitmapToMap function.
dwMaxTime	Maximum time (in milliseconds) function can take. If dwMaxTime=0 function execution is not time limited.

Returns

1 if successful, other value otherwise.

Picture must be of 32 bit bmp format.

X and Y coordinates represents geographical longitude and latitude taken in meters.

BrowseMap is map shown on after clicking Browse Map menu button. BrowseMap allows browse the loaded maps and change zoom.

See Coordinates conversion section in TROUBLESHOOTING page.

Possible error codes returned from Drive are:

• 0 - Function not succeeded.
• 1 - Function succeeded.
• 2 - Drive not succeeded.
• 3 - Function reached timeout.