Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 142 lines (65 sloc) 4.595 kb
2227ad2 Jacob Joaquin Cleaning up for a release.
authored
1 'Csoundo' is a Csound library for Processing.
2
3 Copyright (c) 2010 Jacob Joaquin
4 jacobjoaquin@gmail.com
5 http://csoundblog.com/
6
7 Note
8 ----
9 Csoundo development is in early Alpha. Though people have been successful in running Csoundo on Linux, OS X and Windows, there are still many issues that are preventing people from getting Csoundo to work on their computers. For example, Csoundo only works with the floats version of Csoundo, not doubles. (see "Known Issues" at the end)
10
11
12
13 What is Processing?
14 -------------------
15
16 "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."
17
18 http://processing.org/
19
20
21
22 What is Csound?
23 ---------------
24
25 "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."
26
27 http://csound.sourceforge.net/
28
29
30
31 Running on OS X
32 ---------------
33 1) Install Csound.
34
35 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:
36
37 csound5.12.4-OSX10.5-Universal.dmg
38 http://sourceforge.net/projects/csound/files/csound5/csound5.12/csound5.12.4-OSX10.5-Universal.dmg/download
39
40
41 2) Copy the Csoundo folder into your Processing 'libraries' folder. See instructions at Processing.org:
42
43 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
44
45
46 3) Copy or make a symlink to the csnd.jar file. The csnd.jar is located here:
47
48 /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar
49
50 Make a copy of csnd.jar in this folder:
51
52 yoursketchbook/libraries/csoundo/library
53
54 Alternatively, you can create a symbolic link using the terminal app.
55
56 $ cd yoursketchbook/libraries/csoundo/library
57 $ ln -s /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar csnd.jar
58
59
60
61 Running on Linux
62 ----------------
63
64 I do not have linux installed. If you have better instructions, please email me, and I will incorporate them into the Csoundo knowledge base.
65
66 1) Install Csound:
67
68 http://csound.sourceforge.net/
69
70
71 2) Copy the Csoundo folder into your Processing 'libraries' folder. See instructions at Processing.org:
72
73 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
74
75
76 3) Copy or make a symlink to the csnd.jar here:
77
78 yoursketchbook/libraries/csoundo/library
79
80 To create a symbolic link:
81
82 $ cd yoursketchbook/libraries/csoundo/library
83 $ ln -s /Library/Frameworks/CsoundLib.framework/Resources/Java/csnd.jar csnd.jar
84
85
86 4) Make modifications to the 'processing' lauch script.
87
88 There is currently one known method for running Csoundo on linux. That is, to make to modifications to the 'processing' launcher script in the root folder of Processing.
89
90 A. Towards the very end, right before the line "# Start Processing in the same directory as this script", add this code (your csound plugins folder may vary):
91
92 #make sure that OPCODEDIR is set..
93 export OPCODEDIR=/usr/local/lib/csound/plugins
94 log OPCODEDIR
95
96 B. Replace the last line "java processing.app.Base "$SKETCH" &" to the following:
97
98 java -Djava.library.path=/usr/local/lib processing.app.Base "$SKETCH" &
99
100
101 Thanks to Rory Walsh for this info.
102
103
104
105 Running on Windows
106 ------------------
107
108 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.
109
110 1) Install Csound:
111
112 http://csound.sourceforge.net/
113
114
115 2) Copy the Csoundo folder into your Processing 'libraries' folder. See instructions at Processing.org:
116
117 http://wiki.processing.org/w/How_to_Install_a_Contributed_Library
118
119
120 3) Copy the csnd.jar here:
121
122 yoursketchbook/libraries/csoundo/library
123
124
125
126 Known Issues
127 ------------
128
129 * Csound Doubles is not yet supported. To find out which version you are running, run csound, and about 5 lines down, you'll get a message like this: "Csound version 5.12 (float samples) Jun 4 2010"
130
131 To track other issues, go here:
132
133 http://github.com/jacobjoaquin/Csoundo/issues
134
135
136
137
138
139
140
31ef440 Jacob Joaquin first commit
authored
141
Something went wrong with that request. Please try again.