From 296b5585fbb394e2cc6865f881011b4b269288d0 Mon Sep 17 00:00:00 2001 From: Krisjanis Rijnieks Date: Sun, 31 May 2015 13:04:59 +0200 Subject: [PATCH] Update readme for v0.2.4 --- README.md | 59 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 34 insertions(+), 25 deletions(-) diff --git a/README.md b/README.md index 5b3bae7..ffed1ef 100644 --- a/README.md +++ b/README.md @@ -37,32 +37,52 @@ Installation ------------ If you don't have a clue on how to set up your Pi - go to the [Raspberry Pi website](http://www.raspberrypi.org/downloads/) and follow the instructions there. I have been using Raspbian so far as well as [Satellite CCRMA](https://ccrma.stanford.edu/~eberdahl/satellite/) without problems. -Another thing you need is a working [openFrameworks](http://openframeworks.cc) installation. Follow [this guide](http://openframeworks.cc/setup/raspberrypi/Raspberry-Pi-Getting-Started.html) to set it up. +Another thing you need is a working [openFrameworks](http://openframeworks.cc) installation. There are 2 openFrameworks setup guides now as there are 2 versions of Raspberry Pi: -Clone this into your `openFrameworks/addons` folder. If your openFrameworks installation on the Pi resides in the home directory, you have to type the following in the terminal: + - [Raspberry Pi 1 oF Setup Guide](http://openframeworks.cc/setup/raspberrypi/) + - [Raspberry Pi 2 oF Setup Guide](http://forum.openframeworks.cc/t/raspberry-pi-2-setup-guide/18690) + +Clone this (the ofxPiMapper) repository into your `openFrameworks/addons` folder. If your openFrameworks installation on the Pi resides in the home directory, you have to type the following in the terminal: ```bash cd ~/openFrameworks/addons git clone https://github.com/kr15h/ofxPiMapper.git ``` -Before moving on, make sure that you have all the dependencies installed. Refer to the **Dependencies** section to see what you need. +Dependencies +------------ +Before moving on, make sure that you have all the dependencies installed. + + - ofxGui (available in oF by default) + - ofxXmlSettings (available in oF by default) + - [ofxIO](https://github.com/bakercp/ofxIO) + - [ofxOMXPlayer](https://github.com/jvcleave/ofxOMXPlayer) + +To install dependencies, `cd` into `openFrameworks/addons` directory and execute the following: + +```bash +git clone https://github.com/jvcleave/ofxOMXPlayer.git && git clone https://github.com/bakercp/ofxIO.git +``` + +And you are good to go! + +First Test +---------- To test the addon, you will have to compile and run it: ```bash cd ~/openFrameworks/addons/ofxPiMapper/example -make +make && make run ``` -After it compiles, run it with either `make run` or `./bin/example` +After it compiles, run it with either `make run` or `./bin/example`. You can exit the application by pressing `ESC` or `Ctrl + C`. -It will take a while first, but once it runs, press 1, 2, 3 and 4 keys to switch between modes of the software. Switch to mode 3 at first to select a surface. Afterwards you will be able to edit the texture mapping of it in mode 2 and choose a source in mode 4. Mode 1 is the presentation mode. It is activated on start by default. +It will take a while first (not so long on the RPi 2), but once it runs, press 1, 2, 3 and 4 keys to switch between modes of the software. Switch to mode 3 at first to select a surface. Afterwards you will be able to edit the texture mapping of it in mode 2 and choose a source in mode 4. Mode 1 is the presentation mode. It is activated on start by default. Usage ----- - -I'm thinking on a more clever design that would not require keyboard so much, maybe. Now the example application acts as a wrapper for the ofxPiMapper addon and anyone can re-map keyboard keys by modifying the app code. +Right now a keyboard and a mouse has to be used in order to do the mapping with ofxPiMapper. ###Modes @@ -105,30 +125,16 @@ s | Save composition z | Undo BACKSPACE | Delete surface -Dependencies ------------- - - ofxGui - - ofxXmlSettings - - [ofxIO](https://github.com/bakercp/ofxIO) - - [ofxOMXPlayer](https://github.com/jvcleave/ofxOMXPlayer) - -To install dependencies, `cd` into `openFrameworks/addons` directory and execute the following: - -``` -git clone https://github.com/jvcleave/ofxOMXPlayer.git && git clone https://github.com/bakercp/ofxIO.git -``` - -And you are good to go! Compatibility ------------- -Tested with 0.8.1 - 0.8.4 (OS X and Raspbian) +------------- +Tested with 0.8.4 (OS X and Raspbian) Known issues ------------ Keyboard and mouse input is being lost sometimes on the Raspberry Pi. Not sure how and why. Probably because of bad drivers and it seems that Raspberry Pi keyboard and mouse code in openFrameworks is not quite ready yet. Some claim that the following commands solves the issue: -``` +```bash sudo apt-get update && sudo apt-get dist-upgrade sudo rpi-update ``` @@ -168,6 +174,9 @@ A short wishlist for the next releases: - Streaming source for RPi (fb sharing, network streams...) - Even better code structure +### Version 0.2.4 (2015-05-31) + - Fix RPi compile bug + ### Version 0.2.3 (2015-05-22) - Add undo functionality