aboutsummaryrefslogtreecommitdiff
path: root/README.txt
blob: bd576d703f880b3dad1047bbeb979ffe382624c9 (plain)
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
==============================================================================
the zexy external
==============================================================================

outline of this file::
==============================================================================
 +  general
 +  installation
   +  linux
   +  w32
   +  irix
   +  osX
 +  using
 +  authors



general::
==============================================================================
the zexy external is a collection of externals for miller.s.puckette's 
realtime-computermusic-environment called "puredata" (or abbreviated "pd")
this zexy external will be of no use, if you don't have a running version of 
pd on your system.
check out for http://pd.iem.at to learn more about pd and how to get it 

note: the zexy external is published under the Gnu General Public License 
that is included (GnuGPL.txt). some parts of the code are taken directly 
from the pd source-code, they, of course, fall under the license pd is 
published under.



installation::
==============================================================================

linux :
------------------------------------------------------------------------------

short:
#1> cd src/
#2> make
#3> make install
(this will automatically call autoconf and ./configure if needed (see "long"))

long:
#1>  cd src/
#2>  ./bootstrap.sh
#3>  ./configure
#4>  make
#5>  make install

this will install the zexy external into /usr/local/lib/pd/externs
(the path can be changed either via the "--prefix"-flag to "configure"
or by editing the makefile
alternatively you can try "make everything" (after ./configure)
note: if you don't want the parallel-port object [lpt]
 (e.g.: because you don't have a parallel-port) you can disable it 
 with "--disable-lpt"


macOS-X:
------------------------------------------------------------------------------
see installation/linux

there is nothing special in the code, so it should compile out of the box:
"cd" to zexy/src
run "./bootstrap.sh; ./configure; make" (for further details please see "1) linux")

building with a special version of Pd:
        to build zexy with your special version of Pd, you should specify the path to your Pd ressources
        (e.g. "./configure --with-pd=/Applications/Pd.app/Contents/Resources")
fat-binaries
        if you want to build a multi-arch binary you have to specify this as well
        (e.g. "./configure --enable-fat-binary=i386,ppc --with-extension=d_fat")

note on generating dependencies:
 on older systems the automatic creation of build dependencies
 might fail with following error:
    cpp0: invalid option -smart
 a simple workaround is to not use the "-E" flag for the preprocessor
 try:
   make CPP=cc


win32 :
------------------------------------------------------------------------------

#1 extract the zexy-0_x.zip to your pd-path (this file should be located 
   at <mypdpath>/pd/zexy/)
#2 execute the "z_install.bat", this should copy all necessary files 
   to the correct places

to compile: 
 + w/ MSVC use makefile.nt or zexy.dsw; 
 OR
 + with GCC configure your pd path, eg:
	#> ./configure --prefix=/c/program/pd; make; make install
 OR
 + cross-compilation for windows on linux using mingw (assumes that the 
   crosscompiler is "i586-mingw32msvc-cc")
	#> ./configure --host=i586-mingw32msvc --with-extension=dll \
	   --disable-PIC --with-pd=/path/to/win/pd/
	#> make CFLAGS="-fno-unit-at-a-time"
     notes: configure tries to set the CFLAGS to "-g -O2" if the compiler
            accepts this; however, this optimization sometimes generates 
	    binaries that cannot be loaded by pd; it seems that disabling
	    the "unit-at-a-time" optimization (which gets enabled by "-O2")
	    is the cause of this problem. turning it off might help

irix :
------------------------------------------------------------------------------

though i have physical access to both SGI's O2s and indys,
i haven't tried to compile the zexy externals there for years.
the configure-script should work here too;
if not, try "make -f makefile.irix"
Good luck !



making pd run with the zexy external::
==============================================================================
make sure, that pd will be looking at this location 
(add "-path <mypath>/pd/externs" either to your .pdrc or each time 
you execute pd)
make sure, that you somehow load the zexy external (either add "-lib zexy" 
(if you advised pd somehow to look at the correct place) 
or "-lib <myzexypath>/zexy" to your startup-script (.pdrc or whatever) 
or load it via the object "zexy" at runtime



authors::
==============================================================================
this software is 
copyleft 1999-2007 by IOhannes m zmoelnig <zmoelnig [at] iem [dot] at>
with some contributions by winfried ritsch, franz zotter, guenter geiger, 
miller.s.puckette and surely some others