1 |
Pidim: a collection of ALSA MIDI filters |
2 |
|
3 |
= What is Pidim = |
4 |
|
5 |
Pidim is a collection of small Gtk+ applications which purpose is to filter |
6 |
and generate MIDI events, based on the ALSA Sequencer interface, with MIDI |
7 |
control available. The Pidim collection should run on any Linux operating |
8 |
system (providing ALSA). Pidim is Free Software, released under the GNU |
9 |
General Public License V2, Copyright © 2010 Benoît Rouits <brouits@free.fr>. |
10 |
|
11 |
= Bulding and installing Pidim = |
12 |
|
13 |
Before building Pidim, you will need to install the developement packages |
14 |
of the following libraries: |
15 |
- Gtk+ 2.x |
16 |
- Glib 2.x |
17 |
- libasound2 1.x |
18 |
|
19 |
You also need to have a working ALSA configuration. |
20 |
|
21 |
To build Pidim from the SVN sources, type in a shell: |
22 |
prompt$ ./autogen.sh |
23 |
prompt$ ./configure |
24 |
prompt$ make |
25 |
|
26 |
To install then, run: |
27 |
prompt# make install (as superuser) |
28 |
|
29 |
= Using Pidim = |
30 |
|
31 |
The generated collection of programs are named with pidim_ as prefix. |
32 |
By default, they are located as /usr/local/bin/pidim_* |
33 |
|
34 |
To run multiple instances of a program, simply call it with an instance |
35 |
name as parameter (e.g. prompt$ pidim_arpeggiate 1 & pidim_arpeggiate 2). |
36 |
|
37 |
= Common use = |
38 |
|
39 |
Each program can bind to a channel and operate on it. Optionally, it can |
40 |
bind a controller on the desired channel to modify on-the-fly a relevant |
41 |
value of the filter. These two parameters are to be chosen at the bottom |
42 |
part of the window. Each program has tooltips over the labels to help to |
43 |
deal with the parameters. Simply hover the mouse on the desired label to |
44 |
see the help tooltip. |
45 |
|
46 |
= Specific use = |
47 |
|
48 |
- pidim_arpeggiate: enter the arpeggio in ABC syntax, where 'C' is the |
49 |
reference input note. Press [ENTER] to activate the arpeggio. |
50 |
- pidim_transpose: the transposition value is specified in semitones. |
51 |
- pidim_split_port: the split-note is specified as a MIDI key number. |
52 |
- pidim_split_chan: same as pidim_split_port (but split over channels). |
53 |
- pidim_ctrl_swap: swap the specified controller number with its value. |
54 |
|
55 |
= Disclaimer = |
56 |
|
57 |
This program is free software; you can redistribute it and/or modify |
58 |
it under the terms of the GNU General Public License as published by |
59 |
the Free Software Foundation; either version 2 of the License, or |
60 |
(at your option) any later version. |
61 |
|
62 |
This program is distributed in the hope that it will be useful, |
63 |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
64 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
65 |
GNU General Public License for more details. |
66 |
|
67 |
You should have received a copy of the GNU General Public License along |
68 |
with this program; if not, write to the Free Software Foundation, Inc., |
69 |
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
70 |
|
71 |
|