USAGE: imagetransform <source> <dest> [<key> <value> ..]
  converts imagefiles depending on consecutive KeyValue-pairs.
  By default <dest> is full colour.
  Use "-" as <dest> or KEY "-exit" to suppress saving of imagefile.
  Step by step progress is written to stderr.
USAGE: imagetransform -
  writes explanation of imagetransform to stdout.
KEY         VALUE                DESCRIPTION
-aux        <filename>           fill auxillary R-, G-, B- and Y-images.
-AUX        <filename>           fill auxillary R-, G-, B- and Y-images,
                                 resize auxillary images to size of bitmaps.
-Add        aux                  sum of bitmaps and auxillary images.
-And        aux                  bitwise AND of bitmaps and auxillary images.
-Or-        aux                  bitwise OR of bitmaps and auxillary images.
-Blt        <level>              black if luminance less than <level>.
-Ceq        <level>              white if equal to <level>, otherwise black.
-Cgt        <level>              white if greater than <level>, otherwise black.
-Cge        <level>              white if greater or equal to <level>, otherwise black.
-Cge        <level>              white if greater or equal to <level>, otherwise black.
                                 otherwise black.
-Cgs[td]    <f>                  white if g.e. Avg+<f>*Std, otherwise black.
-Clt        <level>              white if less than <level>, otherwise black.
-Cle        <level>              white if less or equal to <level>,
                                 otherwise black.
-Cls[td]    <f>                  white if l.e. Avg-<f>*Std, otherwise black.
-Cne        <level>              white if not equal to <level>, otherwise black.
-blu[r]     <APERTURE>           simple blur filter.
-blm[apped] <APERTURE>           simple blur restricted by auxillary images;
                                 componentwise mix of original and smooth image.
-can[ny]    <APERTURE>[/<threshold1>/<threshold2>] edge detection.
                                 Default: 300.0/900.0
-cnt        <R>/<G>/<B>          count pixels with this colour and pixels with
                                 (R,G,B) all above or below (<R>,<G>,<B>).
                                 make all [un]equal pixels white [black].
-con[tours] <contourstep>[/<offset>] draw brightness contours in 11 colours.
                                 Default: 1.0/0.
                                 contourcolour[ 0]=(  0,  0,  0) Y= 0.000
                                 contourcolour[ 1]=(  0,  0,232) Y= 0.100
                                 contourcolour[ 2]=(125,  0,124) Y= 0.201
                                 contourcolour[ 3]=(255,  0,  0) Y= 0.300
                                 contourcolour[ 4]=(249,  0,249) Y= 0.400
                                 contourcolour[ 5]=(127,128,127) Y= 0.500
                                 contourcolour[ 6]=(  6,255,  6) Y= 0.600
                                 contourcolour[ 7]=(  0,255,255) Y= 0.700
                                 contourcolour[ 8]=(255,169,255) Y= 0.801
                                 contourcolour[ 9]=(255,255, 23) Y= 0.900
                                 contourcolour[10]=(255,255,255) Y= 1.000
-CON[TOURS] <contourstep>[/<offset>[/<white>/<black>]] draw brightness contours
                                 with luma info, white(black) in image becomes
                                 coloured pixel with luma <white>(<black>).
                                 Red-, magenta-, green-, cyan- and yellow-ish
                                 colours are used.
                                 Default: 1.0/0/216.0/108.0.
-8bi[t]     Y                    make <dest> with 1 bitplane from Y-bitmap.
-8bi[t]     R[GB]                make <dest> with 1 bitplane from RGB-bitmaps.
-cop[y]     <Z,R,G,B or Y>/<R,G,B,Y or A> copy 0 or <R,G,B or Y>bitmap
                                 to R,G,B,Y-bitmaps or all other bitmaps.
-dif[f]     absolute             AbsDiff of bitmaps and auxillary images.
-+-         <filename>           fill auxillary R-, G-, B- and Y-images,
                                 resize and calculate bitmaps.
            127+sgn(<source>-<filename>)*sqrt(64*abs(<source>-<filename>)).
-+-L[inear] <filename>           fill auxillary R-, G-, B- and Y-images,
                                 resize and calculate bitmaps.
            127+sgn(<source>-<filename>)*ceil(0.5*abs(<source>-<filename>)).
-dil[ate]   <iterations>         dilate image.
-equ[alize] histogram            histogram equalization.
-ero[de]    <iterations>         erode image.
-ff4        <x>/<y>/<R>/<G>/<B>[/<lo_diff>/<up_diff>] colour floodfill
                                 fixed range connectivity 4.
-ff8        <x>/<y>/<R>/<G>/<B>[/<lo_diff>/<up_diff>] colour floodfill
                                 fixed range connectivity 8.
-fl4        <x>/<y>/<R>/<G>/<B>[/<lo_diff>/<up_diff>] colour floodfill
                                 floating range connectivity 4.
-fl8        <x>/<y>/<R>/<G>/<B>[/<lo_diff>/<up_diff>] colour floodfill
                                 floating range connectivity 8.
-FF4        <x>/<y>/<R>/<G>/<B>[/<lo_diff>/<up_diff>] channelwise floodfill
                                 fixed range connectivity 4.
-FF8        <x>/<y>/<R>/<G>/<B>[/<lo_diff>/<up_diff>] channelwise floodfill
                                 fixed range connectivity 8.
-FL4        <x>/<y>/<R>/<G>/<B>[/<lo_diff>/<up_diff>] channelwise floodfill
                                 floating range connectivity 4.
-FL8        <x>/<y>/<R>/<G>/<B>[/<lo_diff>/<up_diff>] channelwise floodfill
                                 floating range connectivity 8.
-exi[t]     dontsave             do not write <dest>.
-fac[tor]   <factor>             multiply pixelvalues in bitmaps clipping.
-get        aux                  copy auxillary images to bitmaps.
-har[ris]   <blocksize>/<APERTURE>[/<expon>] corner detection.
-hei[ght]   [-]<height>          scaling to height=<height>[ and flipping].
-int[erpolation] <INTERPOLATION> used for scaling.
-Kg0        <chromalevel>        0x00 (black) if chromacity gt <level>.
-Kg1        <chromalevel>        0xff (white) if chromacity gt <level>.
-Kl0        <chromalevel>        0x00 (black) if chromacity lt <level>.
-Kl1        <chromalevel>        0xff (white) if chromacity lt <level>.
-lap[lace]  <APERTURE>           Laplace transform (d²/dx²+d²/dy²).
-mas[k]     <R>/<G>/<B>=<filename> copy auxillary images to bitmaps with a mask
                                 defined by pixels (<R>,<G>,<B>) in <filename>.
-min[imum]  value                minimum of bitmaps and auxillary images.
-mon[ochrome] g[rey]             convert RGB to grey (both Y-map and RGB).
-mon[ochrome] <Rwhite>/<Gwhite>/<Bwhite> convert grey Y-map to RGB-maps.
-not        invert               invert R,G,B and Y-bitmap.
-dif[f]     absolute             AbsDiff of bitmaps and auxillary images.
-Nrm[alize] <loR>/<loG>/<loB>/<loY>/<hiR>/<hiG>/<hiB>/<hiY> normalize image.
-Nrm[alize] <low>/<high>         normalize image.
-off[set]   <value>              add to pixelvalues in bitmaps clipping.
-rms        <division>           write mean and rms of components of
                                 <division>*<division> subpictures to stdout.
                                 Set the subpictures to their mean colour.
-sca[le]    [-]<factor>          arbitrary scaling[ and flipping].
-sca[le]    [-]<xfactor>/[-]<yfactor> anamorph scaling[ and flipping].
-set        aux                  copy bitmaps to auxillary images.
-sho[w]     destination          show resulting image and wait for key-press.
-smo[oth]   <APERTURE>           Gaussian filter.
-smm[apped] <APERTURE>           Gaussian filter restricted by auxillary images;
                                 componentwise mix of original and smooth image.
-sol[arize] <[R]step>[/<Gstep>/<Bstep>/<Ystep>] coarser LUT with fractional steps.
-sta[tist]  <filename>           write mean,std,low,hi to <filename>.
-sta[tist]  -                    write mean,std,low,hi to stdout.
-str[etch]  <low>/<hi>           increase contrast, <low>...<hi> level on
                                 scale 0.00=minimum, 1.00=maximum to 0...255 .
-st0        <low>/<hi>           increase contrast, <low>...<hi> level on
                                 scale 0.00=0, 1.00=maximum to 0...255 .
-st1        <low>/<hi>           increase contrast, <low>...<hi> level on
                                 scale 0.00=minimum, 1.00=255 to 0...255 .
-st2        <low>/<hi>           change contrast, <low>...<hi> level
                                 to 0...255 .
-swa[p]     aux                  swap bitmaps and auxillary images.
-til[e]     <xoffset>/<yoffset>  fill auxillary images, resized to bitmap,
                                 with tiles of original auxillary images.
-Tgg        <luma_threshold>/<chroma_threshold> luma GE <luma_threshold>,
                                 chroma GE <chroma_threshold>.
                                 defined by min/max RGB. The resulting
                                 Y-bitmap is copied to R- ,G- and B-bitmaps.
-Tgl        <luma_threshold>/<chroma_threshold> idem GE, LE.
-Tlg        <luma_threshold>/<chroma_threshold> idem LE, GE.
-Tll        <luma_threshold>/<chroma_threshold> idem LE, LE.
-Tg-        <luma_threshold>     luma GE <threshold>.
-Tl-        <luma_threshold>     luma LE <threshold>.
-T-g        <chroma_threshold>   chroma GE <threshold>.
-T-l        <chroma_threshold>   chroma LE <threshold>.
-Wgt        <level>              white if luminance greater than <level>.
-wei[ghted] <a>/<b>/<c>          compute <a>*bitmap+<b>*auxillary+<c>.
-wid[th]    [-]<width>           scaling to width=<width>[ and flipping].
-wxh        [-]<width>/[-]<height> anamorph scaling[ and flipping].
-wxh        <factor>             scale width and height with <factor>.
INTERPOLATION:
 a[rea]   CV_INTER_AREA - resampling using pixel area relation.
 c[ubic]  CV_INTER_CUBIC - bicubic interpolation.
 l[inear] CV_INTER_LINEAR - bilinear interpolation.
 n[earn]  CV_INTER_NN - nearest-neighbor interpolation.
APERTURE:
 Allowed values are 1, 3, 5 and 7. Prefered value is 3.
CHROMACITY:
 chroma=sqrt(u*u+v*v)/256.84209600; u=0.49(b-y); v=0.88(r-y);
 y=0.30r+-0.59g+0.11b. Range: <chromalevel> in 0.0 .. 1.0
SEE ALSO: http://opencv.willowgarage.com/documentation/index.html
USING: OpenCV version 1.1.0 (1.1.0)
SEE ALSO: image2image.

Copyright (C) 2011 by Harm J. Schoonhoven

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.