Chroma-Lights

Chroma lights is a frame work for running annimations for led lights over OSC.

Setup

1. Install virtualenv (skip if you have it already)

sudo easy_install virtualenv

2. Create your virtualenv for chroma-scripts

virtualenv env # or replace 'env' with whatever folder  you want your environment in

3. Activate the environment

source env/bin/activate

4. Install dependencies

pip install -r dependencies.txt

Windows Setup

0. Install Python 2.x from http://www.python.org/getit/

1. Download and run Processing for Windows from http://processing.org/download/

2. Install the oscP5 library from http://www.sojamo.de/libraries/oscP5/

3. Run chroma-scripts\emulator\source\lights_emulator\lights_emulator.pde in processing

4. Add "C:\Python2x" and "C:\Python2x\Scripts" to your PATH environment variable

5. Install the setup tools as described here: http://pypi.python.org/pypi/setuptools

6. Download and fully extract this file: http://pypi.python.org/pypi/pip#downloads

7. Go to the extracted directory and run

python setup.py install

pip install virtualenv

8. Change directory to chroma-scripts and run

virtualenv env

env\Scripts\activate

pip install -r dependencies.txt

python run.py random

Note: be sure (env) is displayed at the beginning of every command line when running scripts, or else it will not work!

9. Check your emulator. It should be displaying random colors.

Running

You'll want to activate your virtualenv if it's not already. In your chrome-scripts folder (after having set everything up above before), source env/bin/activate. In order to run the animations locally, we provide a lights emulator written in Processing.

To run the light emulator: $ emulator/lights_emulator

To run an animation: $ ./run.py [animation name]

Contributing

To contribute add a new folder in the animation directory. This folder should be have a unique name for the animation. The folder must contain the following two files:

main.py:

import sys
sys.path.append("./osc")
from oscapi import ColorsOut
...

manifest.json:

{
	"name":"Random Colors",
	"description":"Random colors on 3 second intervals",
	"creator":"RJ and Reed"
}

Each light recieves an input that is a tuple (r,g,b) where each of r, g, b can be 0-1023.

Construct an array of tuples and send them to the OSC server with

pix = [(1023.0,0.0,0.0)]*24
out = ColorsOut()
out.write(pix)

To add simple effects, such as automatic fade-in and fade-out of pixels, use the animations library in place of ColorsOut

from animations import FadeAnimation
pix = [(1023.0,0.0,0.0)]*24
out = FadeAnimation()
out.FADEINRATE = 2.0 #optional
out.FADEOUTRATE = 8.0 #optional, makes things 'trail off'
out.start()
out.write(pix)

Tips and Tricks

Chroma is bright, and can easily be the predominant lighting in the room. Fast blinking of the lights can be intense, so be considerate.

• Avoid instantaneous changes in both intensity and color
• Use the provided animation framework to transition between colors