Skip to content
Newer
Older
100644 111 lines (80 sloc) 2.69 KB
8fe0101 Trying to commit README which just failed
Chris McCormick authored Oct 15, 2009
1 ZenGarden
2 Copyright RjDj, 2009
3 By Martin Roth <mhroth@rjdj.me>
4
12449d4 README tweaks
chrism authored Oct 29, 2009
5 ZenGarden is a standalone library for running Pure Data patches.
6
1a28b72 Updated README with Python stuff
chrism authored Nov 12, 2009
7 It is beta quality software - expect bugs and don't expect everything to be
8 implemented.
12449d4 README tweaks
chrism authored Oct 29, 2009
9
10 https://github.com/mhroth/ZenGarden/
11
1a28b72 Updated README with Python stuff
chrism authored Nov 12, 2009
12 Mailing list:
13 http://groups.google.com/group/zengarden?pli=1
14
47612f5 Changed readme
chrism authored Oct 28, 2009
15 Requirements
16 ------------
17
18 libsndfile
12449d4 README tweaks
chrism authored Oct 29, 2009
19 - OSX: port install libsndfile
20 - Debian GNU/Linux: apt-get install libsndfile1-dev
afbf658 Got this building libzengarden.a for Nintendo DS. A stub testing prog…
chrism authored Dec 28, 2009
21 - Nintendo DS: *experimental* see below
9f88688 Gave runme.sh an optional argument. README and TODO list tweaks. Remo…
chrism authored Oct 29, 2009
22
23 java - for the java example - you need at least java5
24 - Debian: apt-get install sun-java6-jdk
47612f5 Changed readme
chrism authored Oct 28, 2009
25
1a28b72 Updated README with Python stuff
chrism authored Nov 12, 2009
26 python - for the python example
27 - ctypes (in Python 2.5 or greater)
28 - pygame - http://pygame.org/
29
12449d4 README tweaks
chrism authored Oct 29, 2009
30 Run
31 ---
32
1a28b72 Updated README with Python stuff
chrism authored Nov 12, 2009
33 The following commands both optionally take the full path to a Pd patch as
34 their first argument:
35
36 * `./runme-java.sh`
37 * `./runme-python.sh`
12449d4 README tweaks
chrism authored Oct 29, 2009
38
475e4c8 Making this thing build with a Makefile instead of buildscripts. To b…
chrism authored Oct 26, 2009
39 Build
40 -----
41
1a28b72 Updated README with Python stuff
chrism authored Nov 12, 2009
42 Here is how to build the library, JNI, etc. from scratch.
9f88688 Gave runme.sh an optional argument. README and TODO list tweaks. Remo…
chrism authored Oct 29, 2009
43 cd src
44 make
45
46 You can build individual components like so:
47 # build the library as a shared object file
48 make libzengarden
49 # build the Java Native Interface as a shared object file
50 make libjnizengarden
51 # build the Java hosted example
52 make examplegarden
475e4c8 Making this thing build with a Makefile instead of buildscripts. To b…
chrism authored Oct 26, 2009
53
afbf658 Got this building libzengarden.a for Nintendo DS. A stub testing prog…
chrism authored Dec 28, 2009
54 Build: Nintendo DS
55 ------------------
56
57 To build for Nintendo DS you first need to build libsndfile for NDS:
58 * Download it from http://www.mega-nerd.com/libsndfile/#Download
59 * Run the following commands in the directory where you unpacked the libsndfile source:
60
61 export PATH=$PATH:$DEVKITARM/bin/
62 ./configure --enable-shared=no --enable-static=yes --disable-largefile --disable-alsa --disable-sqlite --host=arm-eabi --disable-external-libs --disable-test-coverage
63 make
64 # you may experience some errors to do with tests, but the .a file should be built anyway
65 # now copy the libsndfile.a library into your ZenGarden development directory
66 cp src/.libs/libsndfile.a ../ZenGarden/src/
67 # finally, copy the sndfile.h header file to the ZenGarden development directory
68 cp src/sndfile.h ../ZenGarden/src/
69
70 Finally, to build a static library for the nintendo DS, invoke the following command:
71
72 OS=nds make libzengarden-static
73
74 This will create ../libs/nds/libzengarden.a and you can use this library to
75 statically link into your nintendo DS programs.
76
8fe0101 Trying to commit README which just failed
Chris McCormick authored Oct 15, 2009
77 Advantages
78 ----------
79
80 Why use ZenGarden?
81
1a28b72 Updated README with Python stuff
chrism authored Nov 12, 2009
82 * Clean code and API
8fe0101 Trying to commit README which just failed
Chris McCormick authored Oct 15, 2009
83 * Portable and embeddable
84 * Embedded devices, synthesizers
85 * Mobile phones
86 * Inside other languages
1a28b72 Updated README with Python stuff
chrism authored Nov 12, 2009
87 * LADSPA, VST, etc.
8fe0101 Trying to commit README which just failed
Chris McCormick authored Oct 15, 2009
88 * Compiling Pd as a library is non-trivial and requires modifications to Pd vanilla
9f88688 Gave runme.sh an optional argument. README and TODO list tweaks. Remo…
chrism authored Oct 29, 2009
89 * Less bloat
90 * No GUI
91 * No hardware specific audio driver code
8fe0101 Trying to commit README which just failed
Chris McCormick authored Oct 15, 2009
92
93 Layout
94 ------
95
9f88688 Gave runme.sh an optional argument. README and TODO list tweaks. Remo…
chrism authored Oct 29, 2009
96 src/
97 - Source code
98
99 src/me/
100 - Java JNI demo source
101
102 Xcode/
103 - Xcode project
8fe0101 Trying to commit README which just failed
Chris McCormick authored Oct 15, 2009
104
105 pd-patches/
106 - Demo Pd patches
107
108 pd-patches/unittest/
109 - Pd patches for doing unit testing of ZenGarden
110
Something went wrong with that request. Please try again.