SnailSnap

With mollex we have extracted the snail shells from the photos of the "Museum für Naturkunde Berlin" and generated new pictures. SnailSnap is now an extension, so that you can take a selfie of yourself and create a mosaic of snail shells. By tapping on the snail shell you can see meta information about the snails.

How to Run

1. Download the right version for your operating system from SnailSnap Demo
2. Download the finished snail images generated with mollex and place them next to the executable
3. Rename the file "credentials_example.txt" to "credentials.txt" in the folder "resources" and fill in your data if you want to send emails
4. Start the executable

How to Build

Build Status

Branch	Linux	Windows
master
develop

Data

• Coding da Vinci Daten Seite
• Metadaten
• Mediendateien
• Gallerie-Ansicht

Instruction

• Install Qt
• Clone it
• Initialize submodules (if SmtpClient or JCVoronoi fail to build, you're missing this)
• Run CMake
• Build it
• Place the data folder (containing the snail images, the meta file and the optional descriptions) next to the built executable
• Run it
• If it doesn't work for some reason, check these steps again, and if it still doesn't work create an issue where you tell Lukas to improve the readme.

Command Line Arguments

• Important
  • -n or --maxNumOfMolluscs - Number of snails to build the mosaic from. A good value is 7500.
• Optional
  • -d or --data - Path to the data folder, if it's not placed directly next to the executable.
  • -c or --useCam - Whether the camera should be used to capture images. Pass false to use a file dialog to open an existing image. Default is true.
• Unnecessary
  • -o or --output - Output of the processed image. Just for debugging.

Dependencies

• Qt

• SMTP client for Qt - included as submodule

• OpenSSL - only needs to be installed on Windows. Warning: Use a version < 1.1, since some needed libs are missing in version 1.1.

      /^\    /^\
     {  O}  {  O}
      \ /    \ /
      //     //       _------_
     //     //     ./~        ~-_
    / ~----~/     /              \
   /         :   ./       _---_    ~-
  |  \________) :       /~     ~\   |
  |        /    |      |  :~~\  |   |
  |       |     |      |  \___-~    |
  |        \ __/`\______\.        ./
   \                     ~-______-~\.
   .|                                ~-_
  /_____________________________________~~____ jurcy