Browse Source

Update readme for v0.2.4

master
Krisjanis Rijnieks 10 years ago
parent
commit
296b5585fb
  1. 59
      README.md

59
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. 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 ```bash
cd ~/openFrameworks/addons cd ~/openFrameworks/addons
git clone https://github.com/kr15h/ofxPiMapper.git 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: To test the addon, you will have to compile and run it:
```bash ```bash
cd ~/openFrameworks/addons/ofxPiMapper/example 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 Usage
----- -----
Right now a keyboard and a mouse has to be used in order to do the mapping with ofxPiMapper.
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.
###Modes ###Modes
@ -105,30 +125,16 @@ s | Save composition
z | Undo z | Undo
BACKSPACE | Delete surface 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 Compatibility
------------ -------------
Tested with 0.8.1 - 0.8.4 (OS X and Raspbian) Tested with 0.8.4 (OS X and Raspbian)
Known issues 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: 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 apt-get update && sudo apt-get dist-upgrade
sudo rpi-update sudo rpi-update
``` ```
@ -168,6 +174,9 @@ A short wishlist for the next releases:
- Streaming source for RPi (fb sharing, network streams...) - Streaming source for RPi (fb sharing, network streams...)
- Even better code structure - Even better code structure
### Version 0.2.4 (2015-05-31)
- Fix RPi compile bug
### Version 0.2.3 (2015-05-22) ### Version 0.2.3 (2015-05-22)
- Add undo functionality - Add undo functionality

Loading…
Cancel
Save