Back to files

IMAGE ROTATOR

Description

Image rotator is a command line tool that can detect the orientation of outdoor images and can rotate the images automatically.

For the detection of the orientation, an artifical neuronal network is used. False detections can occur.

W A R N I N G

As Rotator may overwrite Your image files with the rotated versions, it is strongly advised to make backup copies of all Your image data before running rotator.

Usage

Example: rotator *.jpg

Will run rotator on all jpg-files in the current directory. The files will be checked for correct orientation. If a rotation is required, rotator will replace the image with the rotated version. NO BACKUP OF THE SOURCE IMAGE WILL BE MADE! If the orientation cannot be determined or if rotator detects that the image is already correctly orientated, then the source file will remain untouched.

Command line options:

        --debug         
                turns on verbose mode (not advised for end users)
        
        --norotate
                No rotation will be done.
                Instead, rotator will set one of the following exit codes:
                0   - no rotation neccessary
                1   - The image should be rotated 90 degrees counter clockwise
                2   - The image should be rotated 90° clockwise
                4   - The orientation could not be detected
                252 - failure in the artifical neuronal network
                253 - failure while reading the image file
                254 - illegal command line arguments
                
        --mintrue
                Minimum value from the neuronal network, that is seen as boolean TRUE.
                (default: 0.9 - You should not need to change this setting)
                
        -t
                Same as mintrue
                
        --maxfalse
                Maximum value from the neuronal network, that is seen as boolean FALSE.
                (default: 0.2 - You should not need to change this setting)
                
        -f
                Same as maxfalse
                
        --verify
                not implemented

Compiling

ImageMagick-Libraries need to be installed for building rotator. Simply run make to build rotator.

The "Stuttgart Neuronal Network Simulator" SNNS is not neccessary, but if it's present, it will be used to transform "detector.c" from detector.net. Please note, that detector.c and detector.h will be removed by "make clean" and You will need either the original detector.c / detector.h or SNNS installed to rebuild it.