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.
|