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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
This is GEM - Graphics Environment for Multimedia
=================================================
You can get the current distribution from:
https://gem.iem.at
https://git.iem.at/pd/Gem
https://github.com/umlaeute/Gem
if you want to compile the newest (bleeding edge, and possibly unstable) source
code yourself, you can get a copy from the public git repository:
https://git.iem.at/pd/Gem.git
There is also a mirror on github:
https://github.com/umlaeute/Gem
usually, you will only need the read-only repository, which you can get with
$ git clone https://git.iem.at/pd/Gem.git
=============================================
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
-------------------------------------
-------------------------------------
INSTALLATION:
=============
-------------------------------------
To build & install GEM run:
$ ./configure
$ make
$ make install
note: when using a git-clone of the Gem sources, you first need to run
`./autogen.sh` (which is a wrapper around `autoreconf -fiv`).
note: that you might want to help Gem to find the Pd-headers, e.g. by doing
$ ./configure --with-pd=/usr/include/pd
try
$ ./configure --help=recursive
to see more options.
-------------------------------------
To install GEM on W32:
a) installer (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) archive (do it by hand)
1) unzip the GEM package
2) put the subfolders of Gem-<version>\ into a directory where Pd will
find it. If you are using an up-to-date version of Pd (>=0.43), put them
into the folder "Application Data\Pd\" in your home directory.
For older versions of Pd, put them into the "extra" folder of your Pd
installation.
e.g. if you installed Pd as "C:\Program Files\Pd-0.43-0" you should
end up with:
"C:\Program Files\Pd-0.43-0\extra\Gem"
and eventually with
"C:\Program Files\Pd-0.43-0\extra\pix_drum"
"C:\Program Files\Pd-0.43-0\extra\pix_mano"
...
there is no need to copy the README.txt found in Gem-<version>\
3) please note that the archive comes with all plugins
in most cases, you won't need all of them, and having plugins
installed that you don't need, will considerably slow down load
time of patches and might leed to undesired side-effects.
therefore, if loading is too slow (or you experience weird
things), it might be a good idea to disable plugins you don't
need.
disabling plugins is as simple as deleting them (or moving them
into a subfolder)
plugins are files of the form: "gem_<type><NAME>.dll"
e.g. "gem_filmQT.dll" is a plugin for reading films using the
QuickTime framework.
in order to use videoPYLON, videoHALCON and videoAVT, you need
to install proprietary libraries yourself; if you haven't done
so or don't own a device that can interact with those libraries,
you can safely remove these plugins.
if you have no clue what this is about, these plugins are most
likely not for you (so remove them)
-------------------------------------
-------------------------------------
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, Gem.m_i386, Gem.m_*
- macOS-X: Gem.pd_darwin, Gem.d_fat, Gem.d_ppc, Gem.d_*
- linux : Gem.pd_linux, Gem.l_i386, Gem.l_ia64, Gem.l_*
- freeBSD: Gem.pd_freebsd, Gem.b_i386, Gem.b_*
- 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.
e.g. this will fail miserably:
"pd -lib Gem.dll"
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-REPORTS:
============
please do not hesitate to report any crashes, weirdnesses or other issues, using
our bugtracker at https://bugs.gem.iem.at
or the gem-dev mailinglist (subscription at http://lists.puredata.info)
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")
please do not use the puredata bugtracker for reporting Gem-specific bugs.
----
have fun
zmoelnig@iem.at
|
