log69 logo
blog
tomld
aaphoto
help
gallery
links
donate
contact

lang
aaphoto

Free and open source
Automatic photo adjusting software
Corrects the colors of the image and generates a new image file on the disk

Two main functions:
Automatic color correction and resizing

green grass

General description

Auto Adjust Photo tries to give a solution for the automatic color correction of photos. This means setting the contrast, color balance, saturation and gamma levels of the image by analization.

This can be a solution for those kind of users who are not able to manage and correct images with complicated graphical softwares, or just simply don't intend to spend a lot of time with manually correcting the images one-by-one.

The program handles the following image formats:
mif, pnm / pgm / ppm, bmp, ras, jp2, jpc, jpg, png

For more information see the help

Menu extension on Windows platform:

sample image



Download (click on the icon):

aaphoto v0.42
aaRGB v0.64 (color-correction engine)
Last update = 27/09/2013
changelog git repo

download linux version Linux
command-line
static
636 kb
download windows version Windows
local menu
static
506 kb
download freebsd version FreeBSD
it can be installed from official ports
package: pkg_add -r aaphoto
source: cd /usr/ports/graphics/aaphoto && make install clean
download debian version Debian
package: apt-get install aaphoto
Source codes:
aaphoto_sources_all.tar.gz (development version)
aaphoto_sources.tar.gz (development version)
aaphoto_sources_v0.42.tar.gz
aaphoto_sources_v0.41.tar.gz
aaphoto_sources_v0.40.tar.gz
aaphoto_sources_v0.39.tar.gz
SHA1SUMS
SHA1SUMS.asc (sign)

Dependencies (Debian stable sources):
libjasper libjpeg libpng libz


License
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Usage
[HELP]
USAGE: aaphoto [options] [source files]

The following image types are supported (thanks to JasPer, JPEG and PNG): mif, pnm / pgm / ppm, bmp, ras, jp2, jpc, jpg, png

Quality settings can be applied only to jp2, jpc, jpg formats

The following options are supported:
-h --help Print this help
-v --version Print version information
-a --autoadjust Auto adjust the colors of the image
-o --output Set output directory
--overwrite Overwrite mode, the original source file is replaced
--jpg JPEG image output
--jp2 JPEG 2000 image output
--png PNG image output with alpha channel support
--bmp BMP image output
-r --resize Resize image taking the longer side in % or pixels
--rotate90 Rotate image with 90 degrees clockwise
--rotate180 Rotate image with 180 degrees
--rotate270 Rotate image with 90 degrees counter-clockwise
--flipx Mirror image horizontally
--flipy Mirror image vertically
--noexif Save image without EXIF info
-q --quality Set image quality from 1 to 100
-t --threads Set number of working threads (default: autodetect)
-s --silent Silent mode, no information printed during operation
--quiet ...same as above
-V --verbose Print verbose information about processing
--test Print detailed test information into image

EXAMPLES:
aaphoto image.jpg
aaphoto -a -r600 -q85 *.jpg
aaphoto mydir
aaphoto -V --resize70% image.png
aaphoto --quality60 image.jp2

REMARKS:
- auto adjust parameter is set by default if no other parameters are given
- _new filename will be generated without --overwrite parameter
- on directory input every file will be processed in it but not recursively
- order of parameters does not matter
- resizing can be set in percentage too
- resize parameter should be less or equal than original
- resize uses the best (and slowest) resampling method
- default jpeg compression quality is 95%
- EXIF information is restored in jpeg images by default


Remarks:
- The program analyzes the histogram of the image and tries to set the most optimal black and white point of the image. Removes the veiled effect caused by the shifted colors, adjusts the color balance and saturation, and corrects the gamma factor.

- Main goal is simplicity - therefore no efforts are being made toward increasing the current functions in a huge way; there are already a plenty of well-known projects that are capable of the advanced functions and provide it for the users.

- aaRGB color-correction engine currently implemented to Irfanview image viewer. Though Irfanview is not published under GPL license, I provide the right for usage by my own copyright

- aaRGB is licensed for lifetime usage and redistribution to Andrew Lu of the FastStone project.

- The static binaries are compiled with libs from the current Debian stable branch.

- The source compiled fine on further platforms: OpenBSD, OpenSolaris, Mac OS X, Aros

- The following libraries are used by this program:
libgomp - OpenMP for parallel programming, http://gcc.gnu.org/onlinedocs/libgomp/
libjasper - JasPer software, http://www.ece.uvic.ca/~mdadams/jasper/
libjpeg - IJG JPEG software, http://www.ijg.org/
libpng - PNG software, http://www.libpng.org/
libz - Compression library, http://www.zlib.net/