mosaik2 - creates real photo mosaics. ready for large data sets. 

mosaik2 is a Command Line Interface program for Linux.

website at https://f7a8.github.io/mosaik2/
hosted at https://github.com/f7a8/mosaik2/


Dependend software    Debian packages
for building

1. make               make
2. gcc                gcc
3. libssl             libssl-dev
4. libgd              libgd-dev

Optional, but recommended
5. libexif            libexif-dev
6. curl dev           libcurl4-gnutls-dev
8. phash              - (www.phash.org v0.9.6, try `make phash`)

Build

1. enter in the directory
2. run `make`
3. run `make install`


USAGE

I.   find ~/Pictures -type f -iregex '.*\.jpe?g$' -size +10000c -size -100000000c > first_mosaik2.file_list
II.  mosaik2 init first_mosaik2_db
III. mosaik2 index first_mosaik2_db < first_mosaik2.file_list
IV.  mosaik2 gathering my_first_mosaik2.jpeg first_mosaik2_db < source_image.jpeg
V.   mosaik2 join my_first_mosaik2.jpeg first_mosaik2_db



Usage Description
I.   create a text file with filenames
II.  initialize a mosaik2 database named first_mosaik2. You can create multiple
     mosaik2 databases to handle a large volume of images by processing them in
     parallel.
III. The index process scans all images provided from "first_mosaik2.file_list"
     to the mosaik2 database "first_mosaic". Those informations, like tiny
     thumbnails, are needed to compute the final mosaic.
     "first_mosaik2", all files from the "first_mosaik2.file_list" are indexed.
IV.  The provided motive image "source_image.jpeg" is used to find find best 
     matching candidates.
V.   The results of (multiple) gatherings are merged here and the final
     candidate images are loaded to the final mosaic image together.


Integrated third party software

Min-Heap and Max-Heap into libmosaik2.h and libmosaik2.c from https://de.wikibooks.org/wiki/Algorithmen_und_Datenstrukturen_in_C/_Heaps under CC BY-SA 3.0. The payload data type was changed from int to mosaik2_database_candidate.