3.07 KB

Set of programs to manipulate data in blc_channels. They do not have any lib dependency.

Acquire input values

from keyboard

i_keyboard changes values with the keyboard arrows or specific keys:

Waiting for one key in '0123456789abcdef'. Quitting with 'q'

This means that a channel (/i_keyboard31058) of 16 ( by default there is 16 characters in the string) 'UIN8' has been created. Press Up and Down to increase or decrease the first value. Use Right and Left or one key of the key list to select another value to change. Esc sets the value back to neutral values (default 50% i.e. 127)

i_keyboard has many options (use i_keyboard -h to list them) we illustrate some:

i_keyboard  -d -tFL32 -k abcd -o/toto

Creates a channel '/toto' of 4 float values corresponding to 'a', 'b', 'c', 'd' between 0 and 1 and display the pourcentage in text mode.

100%(1.00) [/toto] |
| 49 49 49 49
| [] [] [] []
 0%(0.000)  >
>|#a| b| c| d|

Instead of -k abcd you can define the size (-s) of desired channel and the keys are automatically generated ( max 64).

We see the initial values are set to 49% (i.e. 0.5) and we can chenge them with the arrow. You could change the initial value by changing the neutral value (-N). You can change the min and max with -m and -M. The default step of one keypressed in 0.004 (~1/256) or 1 with UIN8 type. It can be changed with -S.

Sometime you do not want intermediate values but only toggle between max and min. Then use -T.

from files

i_fread <filename.tsv> reads a line of data from the file in tsv (i.e. '0.3 0.55 0.56 ' is a vector of 3 values) and creates a channel (a vector) containing these data. If there are many lines, it updates the data as fast as possible with each time. It is very fast you can be either be synchronized or using -p to requiert a minimal time between each update. You can also use a first column describing the time in µs to read the line. Finaly you can limit the number of line read by using -n.

To load sound or images, see i_sndfile and i_pngfile

from oscillator

i_oscillator -o/toto generates sinusoidale oscillations and put it in the channel /toto. You can specify the frequency with -f and the refresh rate with -r. The refresh rate defines how often you will update the value of the oscillator but will not change the frequency.

You can use a buffer to keep the historic of the oscillation.

from mouse

i_mouse but you need to be sudo for now ...

Generate outputs

to the terminal

In development ... o_display <blc_channel-in>

to a file

o_fwrite <channel> -f <filename.tsv> create a tsv file with the data of the channel. The options are symetrical with i_fread.

To save sounds or images see [o_sndfile](] and [o_pngfile](]