photostitch/README.markdown

   1 ## Overview
   2
   3 This sample is a AppEngine app and a worker setup that runs a photo stitching
   4 service.
   5
   6 The basic architecture currently is this:
   7
   8 1. The user uploads a zip file with images via a web form.
   9 2. The AppEngine app unzips this, chunks it up and uploads it to Google
  10 Storage.
  11 3. The AppEngine app then adds an item to a pull queue.
  12 4. The worker polls the queue and grabs a work item.
  13 5. The worker downloads the images, joins them, creates thumbnails and reuploads
  14 them to Google Storage.
  15 6. The worker stitches the images together using open source pano software.
  16 7. After each step, the worker writes a state file to communicate what is going
  17 on.
  18 8. The AppEngine app reads these state files from Google Storage and uses the
  19 info to render a page with links to past stitches.
  20
  21 ## Install
  22
  23 Right now installing this is a bit of a mess.
  24
  25 To set up the AppEngine app (photostitch dir):
  26
  27 1. Create a new AppEngine application.
  28 2. Modify Makefile to point to where your AppEngine SDK is.
  29 3. Download boto and apiclient, untar them into the photostitch/ directory.
  30    boto can be got from : https://github.com/boto/boto
  31    apiclient can be downloaded from :
  32 http://code.google.com/p/google-api-python-client/source/browse/#hg%2Fapiclient
  33 4. Deploy/push your application with 'make update'
  34
  35 For details on setting up and running the worker code, see worker/README.