log69 logo
blog
aaphoto
help
gallery
links
contact

lang
Help

How does it work?

This software is a command-line tool, it can be run from a terminal or console window. It takes parameters and filenames as input. For example:

aaphoto image.jpg

This creates an image called "image_new.jpg" that will be the color corrected one.


Installation from source code

Of the most recent version on Debian system.

su -c "apt-get install build-essential libjpeg-dev libjasper-dev libz-dev libpng-dev"

wget http://log69.com/downloads/aaphoto_sources.tar.gz

tar xf aaphoto_sources_all.tar.gz

cd aaphoto-*

./configure && make && su -c "make install"


Why do some pictures have less corrections than others?

Different images need different corrections, so the program adjusts these in different ways.

When a picture has good contrast, then it won't be adjusted, so the result will have less corrections.


Why does the result become worse in some cases?

The program does an analyzation and recalculates the colors of the image. An automated algorithm has to make decisions due to the tasks. But it's not so easy to produce good decisions on every input.

So i intend to work on a solution where the program needs to make less decisions -with the results having less dramatic adjustments- and so there having less worse outputs too.

The main goal is not to make the photo worse when it cannot be made any better.


Why doesn't the program have any extra switches that could change the correction process?

The main goal of the program is to prevent users from having to use a lot of parameters and input values.

The program was created to address this very problem, where the user can adjust every photo easily. The development efforts will continue this in the future.


Other remarks

- When pictures contain stamped dates or any kind of frames around them, then the whole distribution of their colors will be not naturally spread that will affect the results

- The input images should be whether 24-bit colored RGB or 8-bit Gray pictures, other formats will not be processed

- Instead of many files, try to give their folder as an input

- The --test switch draws several histograms into the result image that will show the state of the process before and after
1. histogram: original state
(yellow line shows where the histogram will be cut off for the contrast)
2. histogram: after contrast adjustment
(yellow line shows where gamma needs to be pulled)
3. histogram: before saturation adjustment
(yellow line shows how much saturation adjustment will be made)
4. histogram: state of the result
5. color circle: two line shows the direction and amount of colors for the black and white points