NAME

       jpegpixi - interpolate pixels in JFIF (JPEG) image files

SYNOPSIS

       jpegpixi [OPTION]... SOURCE DEST [[D:]X,Y[,S]|[,SX,SY]]...

DESCRIPTION

       Jpegpixi  interpolates  pixels  or  pixel  blocks  in  JFIF  images  files (commonly referred to as "JPEG
       images"). This is useful to correct images from a digital camera with CCD defects. Only DCT blocks  which
       contain  pixels  to  be  interpolated  are  decoded and re-encoded, and the re-encoding is performed with
       exactly the same parameters with which the image  has  originally  been  encoded.  Therefore,  the  image
       quality is preserved as much as possible.

       SOURCE  and  DEST  are  the  filenames of the source file and the destination file, respectively. In both
       cases, - can be used, which refers to standard input or standard output.

       The destination filename is followed by any number of pixel or pixel block specifications. It starts with
       an optional direction specifier (D), which can be 2 for 2-dimensional interpolation (the default), V or v
       for 1-dimensional vertical interpolation (e.g. to remove horizontal stripes), or H or h for 1-dimensional
       horizontal interpolation.  X,Y are the coordinates of the pixel or the upper-left  corner  of  the  pixel
       block.   S  is the size of the pixel block (1 by default). Alternatively, separate sizes can be specified
       for the width (SX) and the height (SY).

       All numbers (X, Y, S, SX, SY) can be expressed as absolute coordinates/sizes or percentages of the  image
       size. If a number is followed by a percent character (%), it is interpreted as a percentage, otherwise as
       an absolute number.

OPTIONS

       -f FILE, --blocks-file=FILE
              Read  pixel  block  specifications from file FILE in addition to the command line. The file should
              contain one specification ([D:]X,Y[,S]|[,SX,SY]) per line. Empty lines are ignored. The  file  may
              also contain comments, which start with an octothorpe (#) and extend to the end of the line.

       -m METHOD, --method=METHOD
              Use interpolation method METHOD (default: linear).  See section INTERPOLATION METHODS below.

       -v, --verbose
              Display the coordinates and size of each pixel block that is interpolated.

       -i, --info
              Display  information about the image, such as the size of the image, the colorspace in which it is
              encoded, and sampling rates for the different components.

       -s, --strip
              Do not copy comment and extra markers from the source to the destination file. This strips preview
              images, EXIF data, and similar information.

       --help Display a short help text and exit immediately.

       --version
              Display version information and exit immediately.

INTERPOLATION METHODS

       0, av, average
              The pixels adjacent to the pixel block are averaged. The resulting color is assigned to all pixels
              in the block. For 1-dimensional interpolation,  this  is  done  separately  for  one  pixel  wide,
              horizontal or vertical stripes.

       1, li, linear
              The  pixels  which  have  a  distance  of  1 from the pixel block are used to calculate a bilinear
              surface (2-dim), or a group of linear curves (1-dim), which is then used to assign colors  to  the
              pixels in the block.

       2, qu, quadratic
              The  pixels  which  have  a  distance  of  2  or less from the pixel block are used to calculate a
              biquadratic surface (2-dim), or a group of quadratic curves (1-dim), which is then used to  assign
              colors to the pixels in the block.

       3, cu, cubic
              The pixels which have a distance of 3 or less from the pixel block are used to calculate a bicubic
              surface  (2-dim),  or  a group of cubic curves (1-dim), which is then used to assign colors to the
              pixels in the block.

BUGS

       Please report bugs to <martin-jpegpixi@zero-based.org>.

COPYRIGHT

       Copyright © 2002, 2003, 2004, 2005 Martin Dickopp

       Jpegpixi is free software; it may be copied and/or modified under the terms of  the  GNU  General  Public
       License  version  2  or  (at  your  option)  any  later  version.  There  is  NO  warranty;  not even for
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       jpeghotp(1)

       The jpegpixi homepage: http://www.zero-based.org/software/jpegpixi/

jpegpixi 1.1.1                                     20-Nov-2005                                       JPEGPIXI(1)