MapInfo client application samples
The MapInfo client was developed to enable the MapInfo community to connect to image services served from ArcGIS Image Server. The MapInfo client for ArcGIS Image Server is compatible with MapInfo versions 8.0 and 8.5.
The MapInfo client application requires the Image Server C DLL file (ISClientC.dll) and the XML SDK C wrapper DLL (XMLProperties.dll). They must be present in their respective Image Server installation folders and subsequently distributed with the MapInfo client application.
System requirements
The source files for the ArcGIS Image Server MapInfo client are in the C:\Program Files\ArcGIS\ImageServer10.0\Developer Kit\Client Applications\Samples\ArcGIS Image Server MapInfo Client folder.
Software requirements
To start customizing the MapInfo client application the following are required:
| • | MapInfo 8 or 8.5 |
| • | Map Basic 7.5 |
| • | ArcGIS Image Server Client Core (ClientCore.msi) |
| • | ArcGIS Image Server MapInfo client source code |
Customizing the ArcGIS Image Server MapInfo client
Following are the list of source files that are available in the C:\Program Files\ArcGIS\ImageServer10.0\Developer Kit\Client Applications\Samples\ArcGIS Image Server MapInfo Client\Source folder.
| • | ImageServer.MB - Main Image Server MapBasic source code |
| • | ImageServer.MBO - MapBasic object module of ImageServer.MB |
| • | ImageServer2.MB - Secondary Image Server MapBasic source code |
| • | ImageServer2.MBO - MapBasic object module of ImageServer2.MB |
| • | MapInfo_UI.MB - MapInfo user interface related source code for the client application |
| • | MapInfo_UI.MBO - MapBasic object module of MapInfo_UI.MB |
| • | ImageServer.h - MapBasic header file |
| • | Globals.MB - MapBasic source declaring all main global variables in use |
| • | Globals.MBO - Mapbasic object module of Globals.MB |
| • | ISClient.H - MapBasic header file of Image Server definitions |
| • | MapInfo_Misc.MB - MapInfo miscellaneous source code |
| • | MapInfo_Misc.MBO - MapBasic object module of MapInfo_Misc.MB |
| • | Registry.MB - Registry related functions in MapBasic |
| • | Registry.MBO - MapBasic object module of Registry.MB |
| • | ImageServer.str - MapInfo client language definition file |
| • | ImageServer.def - MapInfo client language definition file |
| • | ISClientC.dll - Image Server C DLL |
| • | XMLProperties.dll - Image Server SDK-XML handling DLL |
| • | XMLProperties.h - XML properties header file |
| • | ImageServerGM.lib |
| • | ImageServer_Icons.DLL - Resource DLL for icons |
Deployment guidelines
The MapInfo client needs the following files installed.
Check for the following registry entry of MapInfo installation in the registry:
HKEY_LOCAL_MACHINE\SOFTWARE\Mapinfo\Mapinfo\Professional\800\ProgramDirectory
Note: The version number can change depending on the version of MapInfo installed.
The default location for the client installation is %ProgramFiles%\ESRI\ImageServer_MapInfo. The startup.wor file must be placed in the MapInfo installation folder.
The following source files must be placed in the destination folder as specified below.
Source |
Destination |
ImageServer.MBX |
%ProgramFiles%\ESRI\ImageServer_MapInfo\ ImageServer.MBX |
ImageServer.str |
%ProgramFiles%\ESRI\ImageServer_MapInfo\ ImageServer.str |
ImageServer_Icons.dll |
%ProgramFiles%\ESRI\ImageServer_MapInfo\ ImageServer_Icons.dll |
Startup.wor |
%ProgramFiles%\MapInfo\Professional\startup.wor |
Following are the steps that need to be automated by the installation program.
Installing client application
The startup.wor file allows programs to be loaded automatically. It can be found in the Mapinfo program directory. The installation will have to take care of two scenarios when installing the client.
| 1. | Check for the startup.wor file. |
| 2. | If the file already exists open the file and add the following line. |
Run Application "%ProgramFiles%\ESRI\ImageServer_MapInfo\ImageServer.MBX"
where %ProgramFiles% is replaced by the actual path.
| 3. | If the startup.wor file is not found create a new file and add the following: |
!Workspace !Version 600 !Charset Neutral Run Application "%ProgramFiles%\ESRI\ImageServer_MapInfo\ImageServer.MBX"
Uninstalling client application
| 1. | Remove all installed files from installation location. |
| 2. | Uninstallation will not remove the Startup.wor file. It will just remove the following line from the Startup.wor file. |
Run Application "%ProgramFiles%\ESRI\ImageServer_MapInfo\ImageServer.MBX"
Deploying ISClient Core
In addition to deploying the MapInfo client application the user should also make sure the client core is installed on the target machine. To do this, include ClientCore.msi along with the MapInfo client deployment.