README
1Auto Adjust Photo
2Copyright (C) 2006-2013 Andras Horvath
3E-mail: mail@log69.com - suggestions & feedbacks are welcome
4URL: http://log69.com - the official site
5aaphoto (command-line) version - v0.42
6aaRGB (color-correction engine) version - v0.64
7last update = 26/09/2013
8
9The following libraries are used by this program:
10libgomp - OpenMP for parallel programming,
11http://gcc.gnu.org/onlinedocs/libgomp/
12libjasper - JasPer software, http://www.ece.uvic.ca/~mdadams/jasper/
13libjpeg - IJG JPEG software, http://www.ijg.org/
14libpng - PNG software, http://www.libpng.org/
15libz - Compression library, http://www.zlib.net/
16
17[LICENSE]
18This program is free software; you can redistribute it and/or modify it under
19the terms of the GNU General Public License as published by the Free Software
20Foundation; either version 3 of the License, or (at your option) any later
21version.
22
23This program is distributed in the hope that it will be useful, but WITHOUT ANY
24WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
25PARTICULAR PURPOSE. See the GNU General Public License for more details.
26
27You should have received a copy of the GNU General Public License along with
28this program. If not, see <http://www.gnu.org/licenses/>.
29
30[DESCRIPTION]
31Auto Adjust Photo is a tiny command-line image manipulation tool for automatic
32color correction of photos. It tries to make the picture look better. The
33program does this by analyzing the input image and then sets the most optimal
34contrast, gamma, color balance and saturation for it.
35
36[HELP]
37USAGE: aaphoto [options] [source files]
38
39The following image types are supported (thanks to JasPer, JPEG and PNG):
40mif, pnm / pgm / ppm, bmp, ras, jp2, jpc, jpg, png
41
42Quality settings can be applied only to jp2, jpc, jpg formats
43
44The following options are supported:
45 -h --help Print this help
46 -v --version Print version information
47 -a --autoadjust Auto adjust the colors of the image
48 -o --output Set output directory
49 --overwrite Overwrite mode, the original source file is replaced
50 --jpg JPEG image output
51 --jp2 JPEG 2000 image output
52 --png PNG image output with alpha channel support
53 --bmp BMP image output
54 -r --resize Resize image taking the longer side in % or pixels
55 --rotate90 Rotate image with 90 degrees clockwise
56 --rotate180 Rotate image with 180 degrees
57 --rotate270 Rotate image with 90 degrees counter-clockwise
58 --flipx Mirror image horizontally
59 --flipy Mirror image vertically
60 --noexif Save image without EXIF info
61 -q --quality Set image quality from 1 to 100
62 -t --threads Set number of working threads (default: autodetect)
63 -s --silent Silent mode, no information printed during operation
64 --quiet ...same as above
65 -V --verbose Print verbose information about processing
66 --test Print detailed test information into image
67
68EXAMPLES:
69 aaphoto image.jpg
70 aaphoto -a -r600 -q85 *.jpg
71 aaphoto mydir
72 aaphoto -V --resize70% image.png
73 aaphoto --quality60 image.jp2
74
75REMARKS:
76- auto adjust parameter is set by default without any other parameters
77- _new file name will be generated without --overwrite parameter
78- every file is processed on directory input but not recursively
79- order of parameters does not matter
80- resize value can be set in percentage too
81- resize parameter should be less or equal than original
82- resize uses the best (and slowest) resampling method
83- default jpeg compression quality is 95%
84- EXIF information is restored in jpeg images by default
85- number of threads is set to the number of online processors by default
86
87