README

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. curl dev           libcurl4-gnutls-dev
4. libssl             libssl-dev
5. libgd              libgd-dev
6. libexif            libexif-dev

Build

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


USAGE

I.   find ~/Pictures -type f -iregex ".*\.jpe?g$" -size +10000c -fprintf  first_mosaik2.file_list "%p\t%s\t%T@\n"
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.   See README.file_list
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.