aboutsummaryrefslogtreecommitdiff
path: root/MIDIvice/README.txt
blob: a57ec6e502641868e7efad03a666a6402d7eed3e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
the MIDIvice library
====================

VERSION:
0.1

--------------------

GENERAL::
the MIDIvice library is a collection of externals for miller.s.puckette's realtime-computermusic-environment called "puredata" (or abbreviated "pd")
this MIDIvice-library will be of no use, if you don't have a running version of pd on your system.
check out for http://puredata.info to learn more about pd and how to get it 

LICENSE::
the MIDIvice library is published under the Gnu General Public License that is included (LICENSE.txt). 
some parts of the code are taken directly from the pd source-code, they, of course, fall under the license pd is published under.

AUTHORS::
this software is copyleft 2002-2008 by IOhannes m zmoelnig <zmoelnig@iem.at>, Institute of Electronic Music and Acoustics, University of Music and Dramatic Arts, Graz, Austria

--------------------

PURPOSE::
MIDIvice attempts to make handling of complex(!!!) MIDI-devices easier under Pd. It's like hiding all the SysEx-crap. 
Such devices include 
 - mixing-consoles
 - controllable patch-bays
 - Synthesizers (for doing SampleDumps etc.)

Such devices do NOT include: 
- Synthesizers (for playing purposes; there is enough support under pd, i think)
- hardware, that gives your PC the possibility of doing MIDI (so really, i am not going to write another device-driver for your USBMIDI thing)

SUPPORTED DEVICES::
- MotorMix(tm) by cm-labs(r) -  http://www.cmlabs.net
       8-channel motorfader-box with lots of buttons, LCDisplay and pan-pots.
       the MotorMix-specification were supplied by cm-labs (Many thanks !!).
       You can now download it from ftp://ftp.iem.at/pub/pd/Externals/MIDIvice/motormix.pdf

  objects:
  MotorMix - ping and reset the MotorMix
  motormix_rotary   - get movements of the rotaries
  motormix_encoder  - get movement and push-state of the special "encoder"-rotary
  motormix_faderIn  - get movements of the faders
  motormix_faderOut - move the motorfaders
  motormix_button   - get button press/releases
  motormix_LED      - switch on/off the button-LEDs (ot let them blink)
  motormix_LCDtext  - display some text on the MotorMix-LCDisplay
  motormix_LCDgraph - display some simple graphics on the MotorMix-LCDisplay
  motormix_7seg     - display something on MotorMix's 7segment dispay

--------------------

TODO::
support for FriendChip digital patchbays
support for TCelectronics M-5000
...
feel free to send me your wish-list (probably with MIDI-specifications)

BUGS:
none known (right now)
motormix_button/LED could be more intuitive...

--------------------

INSTALLING::
linux :
change to directory source
adapt the makefile to match your system (where is pd installed ?)
"make clean"
"make"
"make install"
this will install the MIDIvice library into <mypdpath>/pd/extra
documentation will be installed to <mypdpath>/pd/doc/5.reference/MIDIvice
alternatively you can try "make everything"

win32 :
i haven't had time to compile and test the MIDIvice-library under Windos yet.
Good luck !

darwin :
TODO

irix :
though i have physical access to both SGI's O2s and indys,  i haven't tried to compile the MIDIvice library there.
Good luck !

--------------------

RUNNING::
add the "MIDIvice" library to your startup-path
see doc/ for more information