-
Notifications
You must be signed in to change notification settings - Fork 6
/
README
255 lines (150 loc) · 8.62 KB
/
README
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
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
'Csoundo' is a Csound library for Processing.
Jacob Joaquin, Conor Robotham, Rory Walsh
Copyright (c) 2010 jacobjoaquin@gmail.com
http://csoundblog.com/
Update to Processing 2.0, and addition of Android support by Conor Robotham, 2012.
Note
----
Csoundo development is still in its early stages. Though people have
been successful in running Csoundo on Linux, OSX and Windows, there
are still many issues that need to be addressed. See the 'issues'
tracker on the github site.
What is Processing?
-------------------
"Processing is an open source programming language and environment
for people who want to create images, animations, and interactions.
Initially developed to serve as a software sketchbook and to teach
fundamentals of computer programming within a visual context,
Processing also has evolved into a tool for generating finished
professional work. Today, tens of thousands of students, artists,
designers, researchers, and hobbyists who use Processing for learning,
prototyping, and production."
http://processing.org/
What is Csound?
---------------
"Csound is a sound and music synthesis system, providing facilities
for composition and performance over a wide range of platforms. It
is not restricted to any style of music, having been used for many
years in the creation of classical, pop, techno, ambient, experimental,
and (of course) computer music, as well as music for film and
television."
http://csound.sourceforge.net/
Running on OS X
---------------
1) Install Csound.
Only one version of the pre-built Csound binaries has been confirmed
to work on OS X, and only confirmed to work on Intel machines:
csound5.12.4-OSX10.5-Universal.dmg
http://sourceforge.net/projects/csound/files/csound5/csound5.12/csound5.12.4-OSX10.5-Universal.dmg/download
2) Copy the Csoundo folder into your Processing 'libraries' folder.
See instructions at Processing.org:
http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
3) Copy or make a symlink to the csnd.jar file. The csnd.jar is
located here:
/Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar
Make a copy of csnd.jar in this folder:
yoursketchbook/libraries/csoundo/library
Alternatively, you can create a symbolic link using the terminal
app.
$ cd yoursketchbook/libraries/csoundo/library
$ ln -s /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar csnd.jar
Running on Linux
----------------
I do not have linux installed. If you have better instructions,
please email me, and I will incorporate them into the Csoundo
knowledge base.
1) Install Csound:
http://csound.sourceforge.net/
2) Copy the Csoundo folder into your Processing 'libraries' folder.
See instructions at Processing.org:
http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
3) Copy or make a symlink to the csnd.jar here:
yoursketchbook/libraries/csoundo/library
To create a symbolic link:
$ cd yoursketchbook/libraries/csoundo/library
$ ln -s /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar csnd.jar
Running on Windows
------------------
There have been reports of Csoundo working on various versions of
Windows. I do not have Windows installed. If you have better
instructions, please email me, and I will incorporate them into the
Csoundo knowledge base.
1) Install Csound:
http://csound.sourceforge.net/
2) Copy the Csoundo folder into your Processing 'libraries' folder.
See instructions at Processing.org:
http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
3) Copy the csnd.jar here:
yoursketchbook/libraries/csoundo/library
------------------------------------------
Csoundo Android
------------------------------------------
Quick setup for advanced users:
1.Add csoundo and CsoundAndroid folder to the processing libraries folder.
2.Open the CsoundAndroid folder and change the sdk.dir path in the local.properties file.
3.Backup and replace the Processing pde.jar with the
provided pde.jar.(Processing/lib/pde.jar)
CONTENTS:
A. PROCESSING ANDROID.
B. CSOUNDO ANDROID.
C. OVERVIEW OF A CSOUNDO SKETCH FOLDER
D. CODE REQUIREMENTS
E. EXTRA NOTES:
Detailed steps for setting up:
A. PROCESSING ANDROID.(Referenced from wikipidea entry)
1. Download Android SDK: http://developer.android.com/sdk/index.html
2. Run the SDK Manager and download the following items:
Tools/Android SDK Tools(Already Installed)
Tools/Android SDK Platform-tools
Android 2.3.3(API 10)/SDK Platform
Android 2.3.3(API 10)/Google APIs
Extras/Googe USB Driver
3.Download Processing 2.0b6. (Csoundo tested, previous 2.0 beta versions may be compatible. Tested 2.0b3)
4.If required, download the latest USB drivers for your
android phone.(See manufacturer website)
5.Run Processing and click on the box in the top right hand corner labeled JAVA. Change to ANDROID. A window will appear requiring you to navigate to and select your Android SDK.
6.Connect your android phone via USB cable. Go to file>Examples.. and try an android example. Click the play icon or hit Ctrl+R.
B. CSOUNDO ANDROID
1.Place csoundo folder in your Processing libraries
folder. Thats: \Documents\Processing\libraries
2.Open the main processing folder(the program) and go to the lib folder. Backup the pde.jar file to another location and place the provided pde.jar into the lib folder, overwriting the original. (AndroidBuild file provided for reference is the source code of the modified class within the pde.jar)
3.1 Install CSOUND Version 5.18, or see EXTRA NOTES if you already have a CSOUND Version.
3.2 Copy the built CsoundAndroid folder provided into this folder.
3.3 Open the local.properties file(With TEXTPAD or
another editor) within the CsoundAndoid folder and
change sdk.dir path for the android-sdk on your computer.
4.Open the csoundo examples folder from processing and test a sketch. You must comment/uncomment the csoundo instantiation to switch between Java and Android mode.
C. OVERVIEW OF A CSOUNDO SKETCH FOLDER
*The only required files for a developer are the main .pde file inside the main sketch folder, and the .csd file of the same name, in the data folder.
1.Inside your sketch folder, is the main .pde file of the same name, along with any other .pde or java files used in the project.
2.The csound .csd file is located in the data folder, and must be named exactly as the project name(caps-sensitive)
3.icon-36, icon-48 and icon-72 are optional, and the default Processing icon will be used if they are left out.(Csoundo icons are provided)
4.A sketch.properties file is created automatically inside the sketch folder, used by Processing.
5.A __CSOUNDO__.csd file will be created and overwritten inside the data folder for every Java Build. Editing this file will have no effect.
6.An AndroidManifest file will be automatically created by Processing in the sketchfolder upon Android run.
D. CODE REQUIREMENTS
Csd file
1.1Within the .csd file the following options must be specified.(Modify bravely)
<CsOptions>
-o dac -+rtaudio=null -d -+msg_color=0 -m0 -b512
</CsOptions>
1.2 The above are the Android Mode Options, Use cs.setOptions within your .pde code to set Java Mode csound options.(Otherwise working default options will be applied)
2.Use the chnget inside a csoundo instrument to specify a reference channel for Processing. e.g. kfreq chnget "pitch"
Pde file
3. import csoundo.*; must be included at the top of your main .pde sketch file.
4. Csoundo cs; Csoundo object must be declared outside
any methods.(Usually before setup())
5. The cs object must be instantiated in the setup method using the Android Constructor:
cs = new Csoundo(this, super.getApplicationContext());
or the Java Constructor:
cs = new Csoundo(this, "MySketch.csd");
6. cs.run(); Method must be called in setup method.
7. Csoundo methods can then be called in the setup or draw methods. e.g cs.setChn("pitch", pitchVar); inside the draw method.
E. EXTRA NOTES:
- If you are not running CSOUND Version 5.18 it is recommended that you replace the csnd.jar file within Csoundo with the csnd.jar file from within your version of Csound. (Processing\libaries\Csoundo\library\csnd.jar)
- modified pde.jar has only been tested with 2.6 beta and 2.3 beta, and likely will need to be updated for future versions.
-It is recommended to debug in Java first and, if possible, add Android specific methods last.
- for future versions of CsooundAndroid you can place it in the directory specified above, but, unless they have changed the way they release it, you will need to build it from the command line console to create the build.xml file required. cd to android-sdk/tools and run command:
android update lib-project --target 1 --path C:\Users
\Conor\Desktop\csound-android-5.18.03\CsoundAndroid
Change path accordingly.