|
11 years ago | |
---|---|---|
example | 11 years ago | |
example-fboTexture | 11 years ago | |
src | 11 years ago | |
.gitignore | 11 years ago | |
README.md | 11 years ago | |
license.md | 11 years ago |
README.md
ofxPiMapper
This project is an attempt to create optimized version of an openFrameworks projection mapping addon for the Raspberry Pi.
ofxPiMapper is mainly intended for people who want to use the Raspberry Pi as a cheaper way to create standalone mapping installations. Let's say someone has 10 generative mapping pieces and at last get's an offer to exhibit them in an art or any other kind of gallery. 10 Mac computers? No! PiMapper is here to save you!
The addon itself is intended to be flexible as the separate components of it can be reusable. Use the full version of it to set up your mapping and then switch to no-gui version once everything is set up to save processor power and memory.
As ofxPiMapper is optimized for the Pi, there is no doubt that it will run smoothly on other machines. It has been tested on OS X.
Licence
ofxPiMapper is distributed under the MIT License.
Installation
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:
cd ~/openFrameworks/addons
git clone https://github.com/kr15h/ofxPiMapper.git
To test the addon, you will have to compile and run it:
cd ~/openFrameworks/addons/ofxPiMapper/example
make && make run
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.
Dependencies
ofxUI - will be replaced with custom solution as it consumes a lot of processing power.
ofxXmlSettings
Compatibility
Tested with 0.8.0, 0.8.1 (OS X and Raspbian)
Known issues
When launching the example with make run
keyboard and mouse input is being lost sometimes. Executing the example directly by using ./bin/example
might solve the problem. Not sure how and why.
Version history
Version 0.1.3 (2014-05-16):
- Added sources view (for selected surface)
- Added possibility to select image sources
- Save and load surfaces with image sources
- Joint and surface movement using arrow keys
- Added fullscreen toggle
- Adjusted the example to work with new changes
Version 0.1.2 (2014-05-12):
Restructured GUI mechanism for flexibility later.
- Added possibility to add multiple surfaces
- Add GUI for surface manager instead per surface
- Ability to select and drag whole surfaces as well as select/deselect surfaces
Version 0.1.1 (2014-05-10):
Added simple GUI with joints. Updated the example application so that it allows the user to do texture mapping, projection mapping and enter presentation mode.
Version 0.1 (2014-05-09):
First usable version. For now there is a triangle surface class that you can use to map an ofTexture object.
- Added triangle surface
- Added simple example