====== Howto Convert GIFs to Animations  ======

This Howto explains how to convert a GIF-file to a animation file, displayable in the Camp firmware.
This tutorial has been tested with Ubuntu 14.04 LTS

<note important>The space on rad1o is limited. The recommended an1-file size is < 400kb.</note>
===== Requirements =====

  * Image Magick (Ubuntu install: sudo apt-get install imagemagick)
* Perl GD2 library (Ubuntu install: sudo apt-get install libgd-gd2-perl)
  * img2lcd script (download from https://github.com/rad1o/f1rmware/raw/master/tools/img2lcd.pl)
  * lcd2ani script (download from https://raw.githubusercontent.com/rad1o/f1rmware/master/tools/lcd2ani.pl)
  * Conversion script (download from: https://gist.github.com/deltaflyer/62050c8f958587ba78ed)

===== Tasks =====

  * Select a gif that is close to the size of the display (130x130px)
  * Create a new folder called //gifconversion//
  * Put the gif file into the folder //gifconversion//
  * Download all scripts (img2lcd.pl / lcd2ani.pl / convert.sh) and place them in the folder //gifconversion//
  * Open a terminal and browse into the directory //gifconversion//
  * Start the conversion script by running in the console ''bash < conversion.sh FILE.gif''
  * Now an output file //out.an1// is produced.
  * turn off the rad1o
  * connect the rad1o with the USB cable to the computer
  * push and hold ''UP'' while you turn on the rad1o. it will now boot in ''MSC'' mode, appearing as a mass storage device (like a USB stick) to the computer
  * place out.an1 on the device and execute the command ''sync'' afterwareds
  * wait until the left bottom LED stops flashing
  * unmount the device
  * restart your rad1o
  * In the menu select ''play_animation'' and select ''OUT''. The animation should now start up

===== Result =====

  * A running animation

===== Examples ====

Example Animation stored as base64-encoded file

* Download animation as base64-encoded file from https://gist.github.com/deltaflyer/fd4afb6e2eb1dc5b7e22
* Paste the content into a file as file ''file.an1.gz.base64''
* Decode the content on the Linux command line ''base64 -d file.an1.gz.base64 > file.an1.gz''
* Unpack the file ''gunzip file.an1.gz''
* Put the file on your rad1o in the mass storage mode (see above)
* In the menu select ''play_animation'' and select ''FILE''. The animation should now start up

More files

  * Pikachu: https://gist.github.com/deltaflyer/fd4afb6e2eb1dc5b7e22
  * Nyan-Cat: https://gist.github.com/deltaflyer/ea4023e219a6221b61b0
  * Dancing Banana: https://gist.github.com/deltaflyer/c34d8ed01b770a9e0adf
  * Pikachu Guitar: https://gist.github.com/deltaflyer/adfa2ec006ab58ab02e5
  * 20+ .an1 Files: http://www69.zippyshare.com/v/kgyJIDHl/file.html
  * DeepDream Animation of the Camp Logo (customizable with your nick): https://github.com/w1kke/rad1o_deepdream_animation