PathAway Tools

Map Converter 1.0 - Command Line App

PathAway Batch Converter takes a jpeg or bmp map as the import file, and converts it to PathAway Palm format.

This is a zipped executable. Run the exe to extract the files.

Command Line Parameters:

PWMapConvert MapFileName,[ImageDepth],[PalmMapName],[x],[y],[wd],[ht],[GridCount],[GridGenerate],
[LatTL],[LongTL],[LatBR],[LongBR],[Compression],[ScaleMul],[ScaleDiv]

MapFileName: full path to map filename. Supports jpeg and bmp formats.

[PalmMapName]: full path to destination Palm File name. If blank will use the same name as the MapFileName.

[ImageDepth]: 4,8, or 16. Each number represents bit depth.

[x],[y],[wd],[ht]: Crop value for the map in pixels.

[GridCount]: number of sections to divide the map into. Values 2, 3, 4, divide the map into 2x2, 3x3, 4x4 respectively. Each file gets name postfix added to it A1, A2, B1, B2 etc. Letter value is longitude, numberic is latitude. Same as in a spreadsheet app.

[GridGenerate]: specify grid ID if only generating a section of the map. ie. If you just want the top left section, specify A1.

[LatTL],[LongTL],[LatBR],[LongBR]: Top-left bottom right coordinates. Can be in NSWE format, or decimal. negative values are West, and South.

[Compression] None = No Compression. Default = Compressed

[ScaleMul], [ScaleDiv]: Scale fraction. ScaleMul/ScaleDiv. No scaling up.

Map Converter 1.0 - DLL

The plugin DLL is a C language interface DLL.

Int32
PWMapConvert(char *fileName, char *PalmMapName, Int16 maxImageDepth, Int16 compressed, Int32 startX, Int32 startY, Int32 startWd, Int32 startHt,
char *pLocLatTL, char *pLocLongTL, char *pLocLatBR, char *pLocLongBR,
Int32 GridCount, Int32 GridGenX, Int32 GridGenY, UInt16 ScaleMul, UInt16 ScaleDiv);

FileName: full path to map filename. Supports jpeg and bmp formats. Will look for calibration files of the same name with different extensions to supplement parameters. Calibration files always override these settings. Supported calibration formats are .pwm, .jpr, .pca, and .cal. If using a calibration file only, enter the data as follows:
PWMapConvert("name.bmp", NULL, 8, 1,0,0,0,0,0,0,0,0,0,0,0,1,1);
//name, image depth and compression are required.

PalmMapName: full path to destination Palm File name. If NULL will use the same name as the MapFileName

ImageDepth: 4,8, or 16. Each number represents bit depth. ImageDepth is the highest depth to convert to. Image depth will only be decreased if its greater than the depth specified here.

compressed: 1=compressed, 0=uncompressed. Palm OS supports compression in OS version 3.3 or higher.

startX, startY, startWd, startHt: Crop value for the map in pixels. Specify 0 for all 4 values if no cropping.

pLocLatTL,pLocLongTL,pLocLatBR,pLocLongBR: Top-left bottom right coordinates. Can be in NSWE format, or decimal. Negative values are West, and South. Optional, can be NULL

GridCount: number of sections to divide the map into. Values 0, 2, 3, 4, divide the map into 2x2, 3x3, 4x4 respectively. Each file gets name postfix added to it A1, A2, B1, B2 etc. Letter value is longitude, numberic is latitude. Same as in a spreadsheet app. Enter 0 for no grid division.

GridGenX, GridGenY: specify grid ID if only generating a section of the map. ie. If you just want the top left section, specify GridGenX=0, GridGenY=0. Only used if grid count is greater than 1

ScaleMul, ScaleDiv: Scale fraction. ScaleMul/ScaleDiv. Scaling up (ScaleMul > ScaleDiv) is not currently supported. Specify 1,1 for no scaling.