| 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 |
|
Parent Directory
| 
Revision Log