NAME¶

one bit instrument - how to make a gnarly synth with numm-run

SYNOPSIS¶

numm-run FILE

DESCRIPTION¶

In this tutorial we will learn how to live-code a one-bit synthesizer controlled by mouse position. It is intended as a gentle introduction to development with numm-run. To get started, create a text file with the following method stubs:

def audio_out(a):
    pass
def video_out(a):
    pass
    

Save the file as onebit.py, and then launch it with numm-run:

numm-run onebit.py

You should see a blank window appear. We will now make some sound and light by changing the value of a in the audio_out and video_out functions:

def audio_out(a):
    a[::100] = 2**15
def video_out(a):
    a.flat[::100] = 255
    

Save the file, and you should see and hear the sketch update. This is using numpy's array-indexing to turn every hundredth audio sample and pixel-color on. The audio sample rate is by default 44100Hz, so it produces a series of clicks that will be perceived as a 441Hz tone. We can turn this into an instrument by connecting mouse motion to frequency:

period = 100
def audio_out(a):
    a[::period] = 2**15
def video_out(a):
    a.flat[::period] = 255
def mouse_in(type,px,py,button):
    global period
    period = px*1000
    

Finally, let's use the keyboard to record and jump to notes. The first time you press a key, it records the period, and subsequant depressions play the saved period:

period = 100
record = {}
def audio_out(a):
    a[::period] = 2**15
def video_out(a):
    a.flat[::period] = 255
def mouse_in(type,px,py,button):
    global period
    period = px*1000
def keyboard_in(type,key):
    global period
    if record.has_key(key):
        period = record[key]
    elif record.has_key(key):
        record[] = period
    

SEE ALSO¶

numm-run(1), numm.getting-started(7), numm.spectral-analysis(7)