/
README_WINDOWS.txt
196 lines (139 loc) · 8.02 KB
/
README_WINDOWS.txt
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
------------------------------------------------------------------------
PsyCollider 3.2 (Supercollider 3.2 for Windows)
------------------------------------------------------------------------
This is the Windows version of James McCartney's SuperCollider synthesis
engine (scsynth) and programming language (sclang).
Supercollider's main homepage is at
http://supercollider.sourceforge.net/
To get further information on SuperCollider usage or development, you
should subscribe to the mailing lists:
http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml
------------------------------------------------------------------------
System Requirements
------------------------------------------------------------------------
* Windows 2000/XP/Vista
* Windows Installer
Most common sound cards will work fine - the sound card should be one
that is supported by PortAudio (http://www.portaudio.com/). If you have
issues with latency, consult http://www.portaudio.com/docs/latency.html for
advice how to tune your operating system to achieve the best results
(in short: use ASIO drivers wherever possible).
------------------------------------------------------------------------
How to install, and how to launch
------------------------------------------------------------------------
To install, simply run "setup.exe" and PsyCollider will install on your
System (default location is Program Files\PsyCollider).
Start PsyCollider from your start menu.
NOTE: Your system must provide both audio input and audio output. Otherwise
the synthesis server will not start (see also sc-users mailinglist discussion)
Paths and files you may want to be aware of:
$PSYCOLLIDER_HOME$\startup.sc : system wide startup file
$USER_HOME$\SuperCollider\startup.sc : user startup file
$USER_HOME$\SuperCollider\Extensions : user extension folder for classes, plugins and help files
------------------------------------------------------------------------
Note: THE FOLLOWING INFORMATION IS FOR DEVELOPERS ONLY!
Most people don't need to know how to build SC3 from scratch...
------------------------------------------------------------------------
Building
------------------------------------------------------------------------
To compile SuperCollider for yourself...
Check out the latest source from supercollider.sourceforge.net
The following libraries are needed for compiling
* libsndfile (included in the sc code tree)
* portaudio
* portmidi
* pthread-Win32
* fftw3
* python
You need Visual C++ 2008 (9.0) or the Express edition to build it.
Let's call ROOT the folder you checked out the SuperCollider code tree (contains "build", "Source" etc.)
(Note that the SuperCollider code folder should be named "SuperCollider3" to avoid problems.)
1: Python
----------------------
1) go to "http://python.org" and download and install the latest Python version (tested 2.5.1).
NOTE: get the Windows installer and make sure its the Unicode version and NOT the Ansii version.
2) go to "http://wxpython.org" and download and install the corresponding wxPython binary (tested 2.8.6.1)
NOTE: again you need the Unicode version.
NOTE: make sure you have an environment variable set called PYTHONPATH pointing to the base directory of you installation (Should be done by python installer).
2: Portaudio + ASIO
----------------------
- reminder : you do NOT need to build portaudio. this is taken care of by the msvc project.
1) go to "http://www.portaudio.com/" and download pa_snapshot_v19.tar.gz
(main page --> CVS (left menu) --> pa_snapshot_v19.tar.gz in the "v19-devel" branch section)
2) uncompress it in the ROOT folder. normally, the portaudio folder has the correct name "portaudio".
folders must be like that :
...
ROOT\..\portaudio\docs
ROOT\..\portaudio\src
....
3) go to steinberg.net --> support --> 3rd party Developers (menu on the right) --> ASIO SDK Download.
If you agree on legal junk, you can enter a valid email address (please note that i do NOT know if you can safely Disagree with Steinberg sending your email address to commercial partners and receive the SDK info anyway...).
4) once you receive the email (it took 5 minutes here), you can download asiosdk2.zip, copy and uncompress it to a temp folder. you must then copy some parts of the asio2 sdk to the PortAudio source tree.
5) unpack the zip and put it next to portaudio.
...
ROOT\..\asio-sdk\common
ROOT\..\asio-sdk\driver
...
3: Portmidi
-----------
- reminder : you do NOT need to build portmidi. this is taken care of by the msvc project.
1) checkout version 8 from http://portmedia.svn.sourceforge.net/svnroot/portmedia/portmidi/trunk/
the folder structure needs to be like this:
...
ROOT\..\portmidi\pm_common\
ROOT\..\portmidi\portmidi.dsp\
...
4: Pthread-win32
------------------------
- reminder : you do NOT need to build pthread-win32. this is taken care of by the msvc project.
1) go to : "ftp://sources.redhat.com/pub/pthreads-win32" and get "pthreads-snap-yyyy-mm-dd.tar.gz". (known to work with "pthreads-snap-2005-01-25.tar.gz")
uncompress it and rename the folder to "pthread-win32" so that the source tree looks like :
...
ROOT\..\pthread-win32\tests
ROOT\..\pthread-win32\announce
ROOT\..\pthread-win32\attr.c
...
NOTE : the home page is "http://sources.redhat.com/pthreads-win32"
5: fftw3
-----------------------
1) go to: "http://www.fftw.org/install/windows.html" and download the "PRECOMPILED WINDOWS DLL".
...
ROOT\..\fftw3
...
You also need to run the instructions in the readme that accompany the fftw3 download, which tell you
how to generate "lib" files for your system.
6: libsndfile
-----------------------
NOTE: THIS SECTION ABOUT LIBSNDFILE MAY BE OUT OF DATE. Libsndfile windows headers are now included by default. Please first try skipping this section, then come back if it doesn't work.
Some libsndfile files are included in the sc3 source distribution - however, you need to do a couple of things to get libsndfile stuff compiling correctly on your system:
* go to http://www.mega-nerd.com/libsndfile/#Download section and download the "Windows zip file including precompiled binaries"
* that zip file contains a readme with some instructions. Follow them.
* When done, place the following files into SuperCollider's "libsndfile" folder:
...
ROOT\xtralibs\win\libsndfile\libsndfile-1.def
ROOT\xtralibs\win\libsndfile\libsndfile-1.dll
ROOT\xtralibs\win\libsndfile\libsndfile-1.exp
ROOT\xtralibs\win\libsndfile\libsndfile-1.lib
ROOT\xtralibs\include\libsndfile\sndfile.h
...
7: actually building and running the thing!
-------------------------------------------
Once all the above is done, the Solution "SC3win.sln" should compile without problems (lots of warnings though...).
As a result you will have the plugins in build\plugins (scx files) and PySCLang in ($PYTHONHOME)\lib\site-packages
(The building of the "PySClang" target should also result in a few necessary files being copied into the "build"
folder. Namely Psycollider.py, startup.sc, keywords.list, libsndfile.dll, libfftw3f-3.dll.)
Then open a Terminal and run: python.exe Psycollider.py
------------------------------------------------------------------------
Environment
------------------------------------------------------------------------
Environment variables add directories to the default search path for plugins and synth definitions, respectively. Directory names are separated by ';' and must be set through the Control Panel.
* SC_PLUGIN_PATH, SC_SYNTHDEF_PATH
------------------------------------------------------------------------
Reporting bugs
------------------------------------------------------------------------
Please report bugs either to the sc-users or sc-dev mailing lists.
------------------------------------------------------------------------
Outro
------------------------------------------------------------------------
thanks to james mccartney, for making this great piece of audio
software publically and freely available.