ms2img -- mapsoft2 converter for raster images
ms2img <options> <input file> <output file>ms2conv converts raster images (PNG, TIFF, GIF, JPG). Can be used to change image format, colormap or scale.
Show help message.
Show help message as POD template.
Be verbose.
Explicitely set image format: jpeg, png, gif, tiff, pnm
When writing TIFF, convert image to one of following forms: argb, rgb, argb64, rgb64, grey, pal (default depends on the image).
Set compression algorythm for writing TIFF files: none, ccit_rle, ccit_rlew, ccit_fax3, ccit_fax4, lzw (default), jpeg, packbits
When writing greyscale TIFF, use MINISWHITE colors (default: 0).
Set JPEG quality for writing jpeg and tiff files (default 95).
When writing PNG, convert image to one of following forms: argb, rgb, grey, agrey, pal (default depends on the image).
Colormap size for reducing image colors (0..256, default 255, if 0 - use all colors). Image colors are reduced when saving to GIF, to PNG with --png_format=pal, to TIFF with --tiff_format=pal.
Alpha channel: none (default) -- remove it; full -- treat it equally with other channels; gif -- keep only fully-transparent color, if needed. When saving GIF file (which supports only fully transparent color) "full" works in the same way as "gif".
Analog of pnmcolormap options -spreadbrightness and -spreadluminosity. When a box in the color space is measured, color dimensions can be treated equally or with luminosity factors. Values: norm (default) or lumin.
Analog of pnmcolormap options -center, -meancolor, and -meanpixel. When a box in the color space is chosen, it can be represented by its geometrical center, or by averaging pixels or colors in it. Values: center, meanpix (default), meancol.
Analog of pnmcolormap options -splitpix, -splitcol, -splitdim. How to choose a box in the color space for splitting: by its maximum dimension, maximum number of pixels or colors in it. Values: maxdim (default), maxpix, maxcol.
Save colormap to PNG file.
Load colormap from PNG file.
Add a color to colormap (useful to add transparent color to non-transparent colormap) TODO: allow multiple colors.
Downscaling factor, double value (default: 1.0)
Invert image
Do auto color levels. Color components are transformed as f(x) = a-c/(a-x) in such a way that the darkest color becomes black, lightest one becomes white, average color becomes the value set by the option argument. Argument is one floating-point number (for all components) or three comma-separated numbers in the range 0..1, reasonable value is near 0.5. If --invert option is set then the transformation happens after the inversion. Color min/max/avr values are calculated in the central part determined by the --border option.
Skip some fraction on white/black colors in the autolevel calculation. Argument is one or two (for white and black) numbers in the range 0..1. Default is 0,0.
Remove dust using IR channel. Argument is a file with the IR channel
Shift of the IR channel, [x,y] in pixels.
Threshold for the IR channel, default 0.06.
Crop image to a rectangular area (intersection with the image coordinate range). Argument is json array with 4 numbers: [<x>,<y>,<w>,<h>]
Crop image automatically, remove all 'bad' lines from each side within region specified by --border.
Use another image for autocrop calculations.
Border for --autolevel and --autocrop calculations (pixels, default 50)
filters are applied in the following order: invert, autolevel, crop, autocrop.
Vladislav Zavjalov <slazav@altlinux.org>