Provided by: jpegpixi_1.1.1-4.1_amd64 bug

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/