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
|
This is GEM 0.91
===================
You can get the current distribution from:
http://gem.iem.at
ftp://iem.at/pd/Externals/GEM
=============================================
NEW:::
------
Gem is now supported by W32, linux and macOS-X
the IRIX version might work (but most probably will not): if you want to use Gem under IRIX,feel free to make it work and report failure and success to me, so i can incorporate any needed changes into the main Gem-trunk.
for installation instructions see below
NEW (gem-0.87):::
-----------------
(note: this NEWs only refer to the packaging, not to features of Gem)
As with GEM-0.87, i have broken the distribution into various packages
gem-<gemver>.tgz :: quite everything (except binaries and auxiliary libraries)
gem-doc-<gemver>.tgz :: example-patches, manual, ...
gem-bin-<gemver>.zip :: W32-binary (containing a single file "Gem.dll")
gem-bin-doc-<gemver>.zip :: W32-binary + documentation
GemLibs-<OS>-<libver>.tgz :: auxiliary libraries (used to be "AuxLibs")
1) the core Gem-packages:
the core Gem-packages all extract into the same directory gem-<gemver>/
there are install-scripts for windoze (and probably IRIX)
these will install the documentation...
2) the GemLib-package:
I don't know, whether it has much sense, to break the core Gem-package (doc/src/bin),
but i do know, that the GemLibs should be in a distinct package (just for the sake of downloading)
the GemLibs have their own version numbering, starting with 1.
You can get the newest GemLib from the place mentioned above
COMPILING DEPENDENCIES:
=======================
current version: GEM-0.91
GemLibs >= 1
PD >= 0.34
-------------------------------------
-------------------------------------
INSTALLATION:
=============
To install GEM on W32:
a) (preferred method)
use the installer executable to install Gem into ...\pd\extra
to build the installer you will have to have NSIS installed
see build/win-nsis for details
b) do it by hand
1) unzip the GEM package
2) put the Gem.dll-file somewhere pd can find it (e.g.: ...\pd\extra)
3) when using pd>=0.37, copy the entire "help"-folder into the same place where the Gem.dll lies
rename the "help"-folder to "help-Gem"
you should now have following structure
(...)\Gem.dll
(...)\help-Gem\
(...)\help-Gem\accumrotate.pd
4) when using pd<0.37, copy the entire "help"-folder into the pd's reference path ( ...\pd\doc\5.reference)
rename the newly created "help"-folder to "Gem"
you should have following structure
(...)\pd\extra\Gem.dll
(...)\pd\doc\5.reference\Gem\
(...)\pd\doc\5.reference\Gem\accumrotate.pd
note: in prior versions of Gem, GLUT was needed; this is obsolete
-------------------------------------
To install GEM on linux:
chdir into <Gemdir>/src/
read the README.<os> (like README.linux) etc...
-------------------------------------
-------------------------------------
RUNNING:
========
just installing Gem is not enough !
you will have to tell pd that it should load that library !!
you cannot create any Gem-objects without having loaded the Gem-library into pd !!!
make sure you have the proper binary for you OS
- windows: Gem.dll
- macOS-X: Gem.pd_darwin
- linux : Gem.pd_linux
- irix : Gem.pd_irix
- ...
when starting pd, tell it to load Gem with the "-lib" flag
if your Gem-binary lives in pd/extra/, you could just try "pd -lib Gem"
if your Gem-binary lives somewhere else use something like "pd -lib /path/to/my/Gem"
you could also use "pd -path /path/to/my -lib Gem"
after loading Gem you will see a bit of a welcome message on the konsole
NOTE: there *must not* be any file extension with the "-lib"-flag:: "pd -lib Gem.dll" will miserably fail
NOTE: please note the spelling: it is "Gem" and not "gem" nor "GEM"
if you have problems loading any library including Gem, have a look at the pd-documentation
if you have problems loading just Gem (but other libraries work), send me a bug-report (see below)
BUG-REPORT:
===========
if your mail only says "hey, it does not work !", it is an annoyance and no bug-report
please specify at least the following things:
Operating-System (kernel-version,...)
video-card, driver
other hardware that is related to your problem (e.g.: camera)
does your system work with similar applications (e.g.: capture-software, openGL (games, "glxgears")
what is the output of pd when you start it with the "-verbose" flag (e.g.:"pd -verbose -lib Gem")
----
have fun
zmoelnig@iem.at
|
