Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 258 lines (151 sloc) 8.859 kB
09bdb9f @rorywalsh updated readme to notify users they must use Processing 2.0b7
rorywalsh authored
1 'Csoundo' is a Csound library for Processing v2.0b7
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
2
53bc4f9 @rorywalsh yet more house keeping
rorywalsh authored
3 Jacob Joaquin, Conor Robotham, Rory Walsh
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
4
53bc4f9 @rorywalsh yet more house keeping
rorywalsh authored
5 Copyright (c) 2010 jacobjoaquin@gmail.com
6 http://csoundblog.com/
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
7
628615a @rorywalsh quickt test
rorywalsh authored
8 Note
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
9 ----
82d56b3 @jacobjoaquin Formatted README
authored
10
53bc4f9 @rorywalsh yet more house keeping
rorywalsh authored
11 Csoundo development is still in its early stages. Though people have
12 been successful in running Csoundo on Linux, OSX and Windows, there
13 are still many issues that need to be addressed. See the 'issues'
14 tracker on the github site.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
15
09bdb9f @rorywalsh updated readme to notify users they must use Processing 2.0b7
rorywalsh authored
16 Special thanks to Conor Robotham for updated the libarry for Processing
17 2.0, and addition of Android support.
18
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
19
20 What is Processing?
21 -------------------
22
82d56b3 @jacobjoaquin Formatted README
authored
23 "Processing is an open source programming language and environment
24 for people who want to create images, animations, and interactions.
25 Initially developed to serve as a software sketchbook and to teach
26 fundamentals of computer programming within a visual context,
27 Processing also has evolved into a tool for generating finished
28 professional work. Today, tens of thousands of students, artists,
29 designers, researchers, and hobbyists who use Processing for learning,
30 prototyping, and production."
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
31
32 http://processing.org/
33
34
35
36 What is Csound?
37 ---------------
38
82d56b3 @jacobjoaquin Formatted README
authored
39 "Csound is a sound and music synthesis system, providing facilities
40 for composition and performance over a wide range of platforms. It
41 is not restricted to any style of music, having been used for many
42 years in the creation of classical, pop, techno, ambient, experimental,
43 and (of course) computer music, as well as music for film and
44 television."
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
45
46 http://csound.sourceforge.net/
47
48
49
50 Running on OS X
51 ---------------
82d56b3 @jacobjoaquin Formatted README
authored
52
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
53 1) Install Csound.
54
82d56b3 @jacobjoaquin Formatted README
authored
55 Only one version of the pre-built Csound binaries has been confirmed
56 to work on OS X, and only confirmed to work on Intel machines:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
57
58 csound5.12.4-OSX10.5-Universal.dmg
59 http://sourceforge.net/projects/csound/files/csound5/csound5.12/csound5.12.4-OSX10.5-Universal.dmg/download
60
61
82d56b3 @jacobjoaquin Formatted README
authored
62 2) Copy the Csoundo folder into your Processing 'libraries' folder.
63 See instructions at Processing.org:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
64
65 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
66
67
82d56b3 @jacobjoaquin Formatted README
authored
68 3) Copy or make a symlink to the csnd.jar file. The csnd.jar is
69 located here:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
70
71 /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar
72
73 Make a copy of csnd.jar in this folder:
74
75 yoursketchbook/libraries/csoundo/library
76
82d56b3 @jacobjoaquin Formatted README
authored
77 Alternatively, you can create a symbolic link using the terminal
78 app.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
79
428c659 @jacobjoaquin Formatted README
authored
80 $ cd yoursketchbook/libraries/csoundo/library
81 $ ln -s /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar csnd.jar
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
82
83
84
85 Running on Linux
86 ----------------
87
82d56b3 @jacobjoaquin Formatted README
authored
88 I do not have linux installed. If you have better instructions,
89 please email me, and I will incorporate them into the Csoundo
90 knowledge base.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
91
92 1) Install Csound:
93
94 http://csound.sourceforge.net/
95
96
82d56b3 @jacobjoaquin Formatted README
authored
97 2) Copy the Csoundo folder into your Processing 'libraries' folder.
98 See instructions at Processing.org:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
99
100 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
101
102
103 3) Copy or make a symlink to the csnd.jar here:
104
105 yoursketchbook/libraries/csoundo/library
106
107 To create a symbolic link:
108
428c659 @jacobjoaquin Formatted README
authored
109 $ cd yoursketchbook/libraries/csoundo/library
110 $ ln -s /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar csnd.jar
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
111
112
113 Running on Windows
114 ------------------
115
82d56b3 @jacobjoaquin Formatted README
authored
116 There have been reports of Csoundo working on various versions of
117 Windows. I do not have Windows installed. If you have better
118 instructions, please email me, and I will incorporate them into the
119 Csoundo knowledge base.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
120
121 1) Install Csound:
122
123 http://csound.sourceforge.net/
124
125
82d56b3 @jacobjoaquin Formatted README
authored
126 2) Copy the Csoundo folder into your Processing 'libraries' folder.
127 See instructions at Processing.org:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
128
129 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
130
131
132 3) Copy the csnd.jar here:
133
134 yoursketchbook/libraries/csoundo/library
135
136
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
137 ------------------------------------------
138 Csoundo Android
139 ------------------------------------------
140 Quick setup for advanced users:
141
142 1.Add csoundo and CsoundAndroid folder to the processing libraries folder.
143
144 2.Open the CsoundAndroid folder and change the sdk.dir path in the local.properties file.
145
146 3.Backup and replace the Processing pde.jar with the
147 provided pde.jar.(Processing/lib/pde.jar)
148
149
150 CONTENTS:
151
152 A. PROCESSING ANDROID.
153
154 B. CSOUNDO ANDROID.
155
156 C. OVERVIEW OF A CSOUNDO SKETCH FOLDER
157
158 D. CODE REQUIREMENTS
159
160 E. EXTRA NOTES:
161
162
163 Detailed steps for setting up:
164
165 A. PROCESSING ANDROID.(Referenced from wikipidea entry)
166
167 1. Download Android SDK: http://developer.android.com/sdk/index.html
168
169 2. Run the SDK Manager and download the following items:
170 Tools/Android SDK Tools(Already Installed)
171 Tools/Android SDK Platform-tools
172 Android 2.3.3(API 10)/SDK Platform
173 Android 2.3.3(API 10)/Google APIs
174 Extras/Googe USB Driver
175
176 3.Download Processing 2.0b6. (Csoundo tested, previous 2.0 beta versions may be compatible. Tested 2.0b3)
177
178 4.If required, download the latest USB drivers for your
179 android phone.(See manufacturer website)
180
181 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.
182
183 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.
184
185 B. CSOUNDO ANDROID
186
187 1.Place csoundo folder in your Processing libraries
188 folder. Thats: \Documents\Processing\libraries
189
190 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)
191
192 3.1 Install CSOUND Version 5.18, or see EXTRA NOTES if you already have a CSOUND Version.
193 3.2 Copy the built CsoundAndroid folder provided into this folder.
194 3.3 Open the local.properties file(With TEXTPAD or
195 another editor) within the CsoundAndoid folder and
196 change sdk.dir path for the android-sdk on your computer.
197
198 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.
199
200 C. OVERVIEW OF A CSOUNDO SKETCH FOLDER
201
202 *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.
203
204 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.
205
206 2.The csound .csd file is located in the data folder, and must be named exactly as the project name(caps-sensitive)
207
208 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)
209
210 4.A sketch.properties file is created automatically inside the sketch folder, used by Processing.
211
212 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.
213
214 6.An AndroidManifest file will be automatically created by Processing in the sketchfolder upon Android run.
215
216 D. CODE REQUIREMENTS
217
218 Csd file
219 1.1Within the .csd file the following options must be specified.(Modify bravely)
220 <CsOptions>
221 -o dac -+rtaudio=null -d -+msg_color=0 -m0 -b512
222 </CsOptions>
223 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)
224
225 2.Use the chnget inside a csoundo instrument to specify a reference channel for Processing. e.g. kfreq chnget "pitch"
226
227 Pde file
228 3. import csoundo.*; must be included at the top of your main .pde sketch file.
229
230 4. Csoundo cs; Csoundo object must be declared outside
231 any methods.(Usually before setup())
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
232
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
233 5. The cs object must be instantiated in the setup method using the Android Constructor:
234 cs = new Csoundo(this, super.getApplicationContext());
235 or the Java Constructor:
236 cs = new Csoundo(this, "MySketch.csd");
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
237
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
238 6. cs.run(); Method must be called in setup method.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
239
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
240 7. Csoundo methods can then be called in the setup or draw methods. e.g cs.setChn("pitch", pitchVar); inside the draw method.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
241
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
242 E. EXTRA NOTES:
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
243
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
244 - 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)
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
245
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
246 - 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.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
247
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
248 -It is recommended to debug in Java first and, if possible, add Android specific methods last.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
249
cc0f4f0 @rorywalsh Updated source, added Csound Android modules, added netbeans project …
rorywalsh authored
250 - 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:
251 android update lib-project --target 1 --path C:\Users
252 \Conor\Desktop\csound-android-5.18.03\CsoundAndroid
253 Change path accordingly.
2227ad2 @jacobjoaquin Cleaning up for a release.
authored
254
255
256
31ef440 @jacobjoaquin first commit
authored
257
Something went wrong with that request. Please try again.