View source for SLOrk/Instruments/DrumCircle

== Description ==

Drum Circle (DC) plays on the idea that the computer can act as a drum (make sound when hit) and takes advantage of the onboard sms sensor.  When running DC, a graphical interface in Open GL displays a pattern of different size balls located around a circle.  There is a clock hand that points to a given ball, and when hit, a note is played. At this point, the clock hand advances to the next ball in counter-clockwise motion.  A melody or bass line can be played by continuously hitting the computer to trigger notes in sequence.  

== Usage ==
DC can be used for a variety of different sounds and purposes.  The sound generation is detached from the graphics interface making sound generation modification easy.  The first two performances of DC included a polyphonic sample playback sound as well as a polyphonic blow bottle synthesizer in Chuck.  Currently, the blow bottle patch is set up in svn.


=== Installation ===
* Copy the folder dc to any directory you like (can be found in [slork/users/njb/])
* Done!

=== Running ===

To run DC, two chuck patches and a separate OpenGL program must be running simultaneously.
The two separate Chuck files can be run individually (sms.ck, polyBlow.ck) or by a separate chuck file that adds the other two (dc.ck). For simplicity, the instructions below do as such.


* Start miniAudicle and open dc.ck 
* Start the virtual machine and add the shred
* Open Terminal
* Navigate to the dc folder
* Type: ./dc


=== Execution ===

Once Chuck and the Drum Cirlce graphics program is running, simply hit the computer and play through the note sequence. See key mapping for more advanced control.


==== Key mapping ====

All control is managed through the graphics interface with the following controls:
*s -full screen
*e -rotate pattern up
*r -rotate pattern down
*> -adds a circle
*< -subtracts a circle
*[ -rotate graphics back
*] -rotate graphics forward
*+ -move graphics forward
*- -move graphics backward
*q -quits

== Advanced users ==
*The main sound generation can be found at: polyBlow.ck
*The main graphics file can be found at: dc.cpp
**The note pattern is a global array at the top