JPEGPIXI

Section: User Commands (1)
Updated: 20-Nov-2005
Index Return to Main Contents
 

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/


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
INTERPOLATION METHODS
BUGS
COPYRIGHT
SEE ALSO

linux.jgfs.net manual pages