-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
203 lines (131 loc) · 7.49 KB
/
INSTALL
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
Here is how to install RTcmix and its instrument packages.
If you have trouble, please join the rtcmix-discuss mailing list
<http://music.columbia.edu/mailman/listinfo/rtcmix-discuss>, and
ask for help.
1. Download RTcmix-[version].tar.gz and unpack it anywhere you like (in your
home directory, or in /usr/local/src, for example) by typing
tar xfz RTcmix-[version].tar.gz
(or: gunzip -c RTcmix-[version].tar.gz | tar xf - )
2. Look in RTcmix-[version]/insts. If it contains "base", "std", "jg", "stk",
"bgg" and "vccm" directories, then you can skip this step. If you have only
"base", then you need to download the instrument packages named above.
Unpack them into the "insts" directory of your RTcmix.
3. cd into the top level of the RTcmix directory, and run the configure script:
./configure
There are some options you might want to give this script. Here's a
description of them. If you already ran configure without the options,
it's okay to run it again with the options you want.
--with-alsa Use the ALSA driver, rather than OSS, on Linux
(ignored on OS X)
--with-jack Enable support for the JACK sound server
--with-perl Build the Perl-enabled RTcmix (PCMIX)
--with-python Build the Python-enabled RTcmix (PYCMIX)
--with-netplay Enable code that lets you play RTcmix over a network
--with-fftw Use the FFTW3 library, instead of the builtin FFT code
--with-osc Compile support for receiving OSC (Open Sound Control)
If you have more than one version of Perl or Python on your system, you
can tell RTcmix which one to use by giving its path with the option, e.g.:
--with-python=/usr/local/bin/python
Give these options in any order, following the configure script name:
./configure --with-alsa --with-perl --with-python
NOTE: If you're running a Mac OS X earlier than 10.3 and want to enable
Python, see the instructions below.
For additional configure options, run "./configure --help". Some of the
standard GNU options are not yet enabled for RTcmix.
If you want to use the optional FFTW (Fastest Fourier Transform in the West)
support, you must install the fftw3f library that is part of the fftw
package (see fftw.org). Configure this package with "--enable-float"
before making and installing. Configure RTcmix with "--with-fftw".
If you want to use the optional OSC (Open Sound Control) support, you must
install the liblo library <http://plugin.org.uk/liblo>. On OS X, configure
this library with "--disable-ipv6".
To build RTcmix with FFTW, Jack or liblo support, you must have the pkgconfig
package installed. Any recent Linux distribution has this, but OS X doesn't.
Get it from Fink or DarwinPorts, or compile it from source:
<http://pkgconfig.freedesktop.org/releases/pkg-config-0.20.tar.gz>.
4. There are some special settings that you can make in the "site.conf" file,
though most people will never need to do this.
5. Make the package. Be sure you're still in the top RTcmix directory and type:
make
6. If the package builds without errors, install it:
make install
7. Add the bin directory inside of the RTcmix directory to your $PATH. For
example, if you're using the bash shell, put something like this in .profile:
PATH="/path/to/rtcmix/bin:$PATH"
export PATH
8. Try running some of the scores in docs/sample_scores. To run any score,
type "CMIX < scorefile.sco". If these seem to work, your installation
is probably ok.
See the README files in the docs dir for information on recent features.
For some help getting started, check out the documentation and tutorials
at rtcmix.org.
--------------------------------------------------------------------------------
Platform Notes
Linux
-----
- Some Linux distributions (e.g., Ubuntu) do not include all the
development supporting files that you need to build RTcmix. You have
to install these packages before trying to build RTcmix. Specifically,
you need to install flex and bison, as well as the ALSA header files,
and probably also the X11 header files.
- On some distributions (e.g., Ubuntu), you may need to enable compilation
with the -fPIC flag. You'll know this if you see an error message during
make that includes a phrase like "recompile with -fPIC." To do this,
after running configure, edit defs.conf and add -fPIC to the OPT line.
Then make clean and make. This will be fixed in a future version of RTcmix.
- If you configure --with-alsa and the output of the configure command
includes...
checking alsa/asoundlib.h usability... no
checking alsa/asoundlib.h presence... no
checking for alsa/asoundlib.h... no
configure: WARNING: ALSA asoundlib.h not present; using OSS instead of ALSA
checking for snd_pcm_open in -lasound... no
configure: WARNING: ALSA library not present; using OSS instead of ALSA
configure: creating ./config.status
then you need to install the ALSA development headers. For Ubuntu, the
incantation is: sudo apt-get install libasound2-dev.
- If you are set up to use ALSA, but you see this message when running
a score...
*** FATAL ERROR [rtsetparams]: AudioDevice: This format conversion is currently not supported!
then it probably means you need to specify the "plughw" audio device.
Put this line in your ~/.rtcmixrc:
device = "plughw"
Mac OS X
--------
- You must use OS X 10.1 or later, and you must have installed the
appropriate version of the Developer Tools (currently Xcode 4, available
to anyone with an Apple ID at https://developer.apple.com/xcode).
- If you want to use gnuplot with the plottable (and older fplot) script
functions, you have to install both the command-line gnuplot and the
AquaTerm program.
First download the AquaTerm-1.1.1.dmg (or later) binary package from
http://aquaterm.sourceforge.net, and install the package.
Then install gnuplot. You can build this from source (v. 4.0 or later,
see below). An alternative is to use one of several third-party package
managers that install various Unix programs in Mac OS X. In all cases,
you install the package manager, and then give some command to install
gnuplot.
a. Fink (http://www.finkproject.org) [fink install gnuplot]
b. MacPorts (http://www.macports.org)
c. Homebrew (http://brew.sh)
If you want or need to install gnuplot from source, get it here:
http://sourceforge.net/projects/gnuplot/files
Unpack the tarball in /usr/local/src. Build the package like this:
./configure --without-x
make
sudo make install
For any of these options, including the binaries, you'll probably have to
add /usr/local/bin to your shell path. For bash, do something like this
in your .profile:
PATH=/usr/local/bin:${PATH}
export PATH
- OS X 10.3 and later have a usable Python built in. (If you want to enable
the Python front end, and you are running a version of Mac OS X earlier
than 10.3, you will have to build Python from source, because the Python
supplied with the Developer Tools CD is incomplete. See the instructions
in RTcmix/src/parser/python/NOTES.)
SGI Irix
--------
- It's been a long time since any of us have compiled RTcmix on Irix, so
who knows whether it will work or even build. Let us know what you find.
-JGG, 8/1/04; rev. for v4, 6/17/05