NAME

       metapixel - generator for photomosaics

SYNOPSIS

       metapixel-prepare [options] [srcdir] [destdir]

                         prepares the pictures in srcdir by creating resized images and a table file in destdir

       metapixel [options] [--metapixel input.jpg output.png --library destdir]

                 creates  a  photomosaic output.png using input.jpg as the input image and destdir/tables.mxt as
                 table file

DESCRIPTION

       This manual page documents briefly the metapixel and metapixel-prepare  commands.  For  more  information
       check the README file included in the distribution.

       metapixel  is a program for generating photomosaics. It can generate classical photomosaics, in which the
       source image is viewed as a matrix of equally sized rectangles for each of  which  a  matching  image  is
       substitued,  as  well  as  collage-style  photomosaics, in which rectangular parts of the source image at
       arbitrary positions (i.e. not aligned to a matrix) are substituted by matching images.

       metapixel-prepare is a utility that needs to be run before metapixel can be used. It prepares your source
       images so that they can be used by metapixel to create the actual photomosaic.

USAGE

       metapixel-prepare  srcdir destdir has to be run first. srcdir is the path to the directory containing the
       source images, e.g. ~/Pictures/Holidays. destdir, e.g. ~/.metapixel, is the path to the  directory  where
       you  want  to  store  the rescaled images and the tables.mxt index file. This directory should be created
       manually before running metapixel-prepare.

       metapixel --metapixel input.jpg  output.png  --library  destdir  is  then  used  to  transform  an  image
       (input.jpg) into a mosaic (output.png) using the source images (described by destdir/tables.mxt).

OPTIONS

       The options are described in the README file or by running metapixel or metapixel-prepare with the --help
       option.

SEE ALSO

       The README file is included in the Metapixel distribution.

AUTHOR

       This manual page was written by Chris Vanden Berghe <Chris@VandenBerghe.org> for the Debian  system  (but
       may  be  used by others). Permission is granted to copy, distribute and/or modify this document under the
       terms of the GNU General Public License, Version 2 any later  version  published  by  the  Free  Software
       Foundation.

       On   Debian   systems,   the   complete  text  of  the  GNU  General  Public  License  can  be  found  in
       /usr/share/common-licenses/GPL.

AUTHOR

       Chris Vanden Berghe.

                                                   May 5, 2004                                      METAPIXEL(1)