imgkap 1.16
Tool to manipuate raster nautical charts in KAP format
This repository is a Github clone of the original code created by M'dJ in 2011 and maintained by Pavel Kalian
Usage
imgkap [option] [inputfile] [lat0 lon0 [x0;y0] lat1 lon1 [x1;y1] | headerfile] [outputfile]
Usage of imgkap Version 1.16 by M'dJ + H.N
Convert kap to img :
>imgkap mykap.kap myimg.png
-convert mykap into myimg.png
>imgkap mykap.kap mheader.kap myimg.png
-convert mykap into header myheader (only text file) and myimg.png
Convert img to kap :
>imgkap myimg.png myheaderkap.kap
-convert myimg.png into myresult.kap using myheader.kap for kap informations
>imgkap mykap.png lat0 lon0 lat1 lon1 myresult.kap
-convert myimg.png into myresult.kap using WGS84 positioning
>imgkap mykap.png lat0 lon0 x0;y0 lat1 lon1 x1;y1 myresult.kap
-convert myimg.png into myresult.kap
>imgkap -s 'LOWEST LOW WATER' myimg.png lat0 lon0 lat1 lon2 -f
-convert myimg.png into myimg.kap using WGS84 positioning and options
Convert kml to kap :
>imgkap mykml.kml
-convert GroundOverlay mykml file into kap file using name and dir of image
>imgkap mykml.kml mykap.kap
-convert GroundOverlay mykml into mykap file
WGS84 positioning :
lat0 lon0 is a left or right,top point
lat1 lon1 is a right or left,bottom point cater-cornered to lat0 lon0
lat to be between -85 and +85 degree
lon to be between -180 and +180 degree
different formats are accepted : -1.22 1°10'20.123N -1d22.123 ...
x;y pixel points can be used if lat lon defines not the image edges.
lat0 lon0 x0;y0 must be in the left or right, upper third
lat1 lon1 x1;y1 must be in the right or left, lower third
Options :
-w : no image size extension to WGS84 because image is already WGS84
-r x0f;y0f-x1f;y1f "2 pixel points -> 4 * PLY"
: define a rectangle area in the image visible from the .kap
-r x0f;y0f-x1f;y1f-x2f;y2f-x3f;y3f... "3 to 12 pixel points -> PLY"
: define a up to 12 edges polygon visible from the .kap
-n : Force compatibility all KAP software, max 127 colors
-c : reduce colors of image to 127 colors / for test purposes only
-f : fix units to FATHOMS
-e : fix units to FEET
-s name : fix sounding datum
-t title : change name of map
-j projection : change projection of map (Default: MERCATOR)
-d datum : change geographic datum of map (Default: WGS84)
-l scale : Override the calculated scale, 1:<SCALE> (Default: automatically calculated from the image size and geographic extent)
-p color : color of map
color (Kap to image) : ALL|RGB|DAY|DSK|NGT|NGR|GRY|PRC|PRG
ALL generate multipage image, use only with GIF or TIF
color (image or Kap to Kap) : NONE|KAP|MAP|IMG
NONE use colors in image file, default
KAP only width KAP or header file, use RGB tag in KAP file
MAP generate DSK and NGB colors for map scan
< 64 colors: Black -> Gray, White -> Black
IMG generate DSK and NGB colors for image (photo, satellite...)