tangrams / paparazzi

Sneaky version of Tangram-ES that loads a YAML scene file, takes snapshots, and runs away
MIT License
5 stars 2 forks source link

Tangram Paparazzi

Repurposed version of Tangram-ES to take pictures of maps (static maps). Designed to run on servers in a reliable, multi-thread and headless fashonable way.

Although most of the worse power comes from ZeroMQ, is thanks to the impressive work of Kevin Kreiser in prime_server that all that power is rightly and effectivelly channeled into a easy to use library. Thanks Kevin Kreiser!

This project currently compiles in Amazon GPU Server, Rasbian, Ubuntu and Darwin OSX.

Install Paparazzi

git clone --recursive https://github.com/tangrams/paparazzi.git
cd paparazzi
./paparazzi.sh install

If you are trying things on the code and just want to compile do

./paparazzi.sh make all

Note: if you want to make a xcode project do: ./paparazzi.sh make xcode

Runing Paparazzi

Once paparazzi is compile you can use the paparazzi.sh script to:

./paparazzi.sh start [N_THREADS]
./paparazzi.sh stop
./paparazzi.sh restart [N_THREADS]
./paparazzi.sh add [N_THREADS]
./paparazzi.sh status

URL calls

You can test by making a dummy URL call like this:

http://localhost:8080/?lat=40.7053&lon=-74.0098&zoom=16&width=1000&height=1000&scene=https://tangrams.github.io/tangram-sandbox/styles/default.yaml

Paths

Query arguments

Arguments Req Description
scene=[url] Y Specify a valid url to the YAML scene file
width=[number] Y Width of the final image
heigth=[number] Y Height of the final image
lat=[LAT] Y Latitud
lot=[LON] Y Longitud
zoom=[zoom] Y Zoom Level
tilt=[deg] N Tilt degree of the camera
rotation=[deg] N Rotation degree of the map