| 1 |
Jpegpixi - JPEG pixel interpolator |
| 2 |
================================== |
| 3 |
|
| 4 |
|
| 5 |
What is it? |
| 6 |
----------- |
| 7 |
|
| 8 |
"Jpegpixi" is short for "JPEG pixel interpolator". The intent of the program |
| 9 |
is to interpolate pixels in JFIF images (commonly referred to as "JPEG |
| 10 |
images"). This is useful to correct images from a digital camera with CCD |
| 11 |
defects. For example, if one pixel is always bright green, this pixel can be |
| 12 |
interpolated away with jpegpixi. |
| 13 |
|
| 14 |
Jpegpixi is unique in that it tries to preserve the quality of the JFIF |
| 15 |
image as much as possible. Usual graphics programs decode JFIF images when |
| 16 |
they are loaded, and re-encode them when they are saved, which results in an |
| 17 |
overall loss of quality. Jpegpixi, on the other hand, does not decode and |
| 18 |
re-encode the image, but manipulates the encoded image data (known as the |
| 19 |
"discrete cosine transformation coefficients"). Therefore, the blocks |
| 20 |
(typically 8x8, 8x16, or 16x16 pixel areas) which contain the pixels to be |
| 21 |
interpolated are minimally disturbed, and other blocks remain pixel-by-pixel |
| 22 |
identical to the original image. |
| 23 |
|
| 24 |
Jpegpixi is a command line utility. It is Free Software, released under the |
| 25 |
GNU General Public License (GPL). The full text of the GPL is contained in |
| 26 |
the file `COPYING'. |
| 27 |
|
| 28 |
This software is based in part on the work of the Independent JPEG Group. |
| 29 |
See `README.jpeglib' for copyright and license information. |
| 30 |
|
| 31 |
|
| 32 |
Installation |
| 33 |
------------ |
| 34 |
|
| 35 |
The file `INSTALL' contains general installation instructions. If you have not |
| 36 |
yet read it, please do so now. |
| 37 |
|
| 38 |
To build jpegpixi, you must have the JPEG library by the Independent JPEG Group |
| 39 |
(version 6b or later) installed. It can be downloaded from |
| 40 |
<ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz>. |
| 41 |
|
| 42 |
You can specify the location of the JPEG library when you run the `configure' |
| 43 |
script with the option `--with-jpeglib' or the options `--with-jpeglib-include' |
| 44 |
and `--with-jpeglib-lib'. Please type `./configure --help' for more information. |
| 45 |
|
| 46 |
The files `optpixi.c' and `optpixi.h' are built from `jpegpixi.opag', and the |
| 47 |
files `opthotp.c' and `opthotp.h' are built from `jpeghotp.opag', with `opag', |
| 48 |
a command line option parser generator. If you want to modify `jpegpixi.opag' |
| 49 |
or `jpeghotp.opag', but don't have `opag' installed, you can download it from |
| 50 |
<http://www.zero-based.org/software/opag/>. Version 0.7.0 or later is required. |
| 51 |
You can also specify the location of the `opag' executable when you run the |
| 52 |
`configure' script with the option `--with-opag'. Please type `./configure |
| 53 |
--help' for more information. |
| 54 |
|
| 55 |
|
| 56 |
Usage |
| 57 |
----- |
| 58 |
|
| 59 |
Please read the manual page for detailed instructions. For a usage example, |
| 60 |
please see the "Example" section on the jpegpixi homepage at |
| 61 |
<http://www.zero-based.org/software/jpegpixi/>. |