|
0
|
1 \name{rdyncall-demos}
|
|
|
2 \alias{rdyncall-demos}
|
|
|
3 \title{rdyncall demos: Platform installation notes for required libraries}
|
|
|
4 \description{
|
|
|
5 The demos of the \pkg{rdyncall} package (see \code{demo(package="rdyncall")})
|
|
|
6 use shared libraries such as SDL, OpenGL and Expat via \code{\link{dynport}}s -
|
|
|
7 a dynamic binding approach which requires, that prebuilt binary shared library
|
|
|
8 files are already installed.
|
|
|
9
|
|
|
10 Depending on the host system, some libraries are officially a part of the
|
|
|
11 OS or Distribution, some others need to be installed to get the demos running.
|
|
|
12
|
|
|
13 As of the current version of this package, the installation of additional
|
|
|
14 shared C libraries need to be done manually. It follows an overview of
|
|
|
15 the required libraries and installation notes for various operating-systems and distributions.
|
|
|
16 }
|
|
|
17 \section{Overview of Libraries}{
|
|
|
18 The following Libraries are used as 'run-time' pre-compiled binaries
|
|
|
19 for the particular target OS and Hardware platform.
|
|
|
20 Some notes on installation of additional run-time libraries
|
|
|
21 required for some rdyncall demos:
|
|
|
22
|
|
|
23 \tabular{lll}{
|
|
|
24 \strong{Lib} \tab \strong{Description} \tab \strong{URL} \cr
|
|
|
25 \code{expat} \tab XML Parser \tab \url{http://www.libexpat.org} \cr
|
|
|
26 \code{GL} \tab Open Graphics Library \tab \url{http://opengl.org}, \url{http://www.mesa3d.org} \cr
|
|
|
27 \code{GLU} \tab OpenGL Utility Library \tab see links above\cr
|
|
|
28 \code{glew} \tab OpenGL Extension Wrangler Library \tab \url{http://glew.sourceforge.net/} \cr
|
|
|
29 \code{SDL} \tab Multimedia Framework \tab \url{http://libsdl.org/} \cr
|
|
|
30 \code{SDL_mixer} \tab Music Format playing \tab \url{http://www.libsdl.org/projects/SDL_mixer/} \cr
|
|
|
31 \code{SDL_image} \tab Image Format loading \tab \url{http://www.libsdl.org/projects/SDL_image/} \cr
|
|
|
32 \code{SDL_ttf} \tab True Type Font rendering \tab \url{http://www.libsdl.org/projects/SDL_ttf/} \cr
|
|
|
33 \code{SDL_net} \tab Network I/O \tab \url{http://www.libsdl.org/projects/SDL_net/} \cr
|
|
|
34 }
|
|
|
35
|
|
|
36 In short: Place the shared libraries ( \code{*.DLL}, \code{*.so} or \code{*.dylib}) in a \emph{standard location} or
|
|
|
37 modify LD_LIBRARY_PATH(unix) or PATH(windows) so that \code{\link{dynfind}} can find the libraries.
|
|
|
38
|
|
|
39 On Mac OS X framework folders are supported as well.
|
|
|
40 Place the \code{*.framework} folder at \code{/Library/Frameworks}.
|
|
|
41
|
|
|
42 Detailed platform-specific installation instructions follow up.
|
|
|
43 }
|
|
|
44 \section{Windows Installation Notes}{
|
|
|
45 Download the \code{*.zip} files, unpack them and place the \code{*.DLL} files to a place within \code{PATH}.
|
|
|
46
|
|
|
47 32-Bit versions:
|
|
|
48
|
|
|
49 \tabular{ll}{
|
|
|
50 \strong{Lib} \tab \strong{Download Link} \cr
|
|
|
51 \code{expat} \tab \url{http://expat.sourceforge.net} (TODO:test installer) \cr
|
|
|
52 \code{GL} \tab pre-installed \cr
|
|
|
53 \code{GLU} \tab pre-installed \cr
|
|
|
54 \code{glew} \tab \url{http://sourceforge.net/projects/glew/files/glew/1.7.0/glew-1.7.0-win32.zip/download} \cr
|
|
|
55 \code{SDL} \tab \url{http://www.libsdl.org/release/SDL-1.2.14-win32.zip} \cr
|
|
|
56 \code{SDL_image} \tab \url{http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.10-win32.zip} \cr
|
|
|
57 \code{SDL_mixer} \tab \url{http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.11-win32.zip} \cr
|
|
|
58 \code{SDL_ttf} \tab \url{http://www.libsdl.org/projects/SDL_ttf/release/SDL_ttf-2.0.10-win32.zip} \cr
|
|
|
59 \code{SDL_net} \tab \url{http://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.7-win32.zip} \cr
|
|
|
60 }
|
|
|
61
|
|
|
62 64-Bit version:
|
|
|
63
|
|
|
64 \tabular{ll}{
|
|
|
65 \strong{Lib} \tab \strong{Downdload Link} \cr
|
|
|
66 \code{expat} \tab no prebuilt found (TODO: build) \cr
|
|
|
67 \code{GL} \tab pre-installed \cr
|
|
|
68 \code{GLU} \tab pre-installed \cr
|
|
|
69 \code{glew} \tab \url{http://sourceforge.net/projects/glew/files/glew/1.7.0/glew-1.7.0-win64.zip/download} \cr
|
|
|
70 \code{SDL} \tab \url{http://mamedev.org/tools/20100102/sdl-1.2.14-r5428-w64.zip} \cr
|
|
|
71 \code{SDL_image} \tab pre-built n/a \cr
|
|
|
72 \code{SDL_mixer} \tab pre-built n/a \cr
|
|
|
73 \code{SDL_ttf} \tab pre-built n/a \cr
|
|
|
74 \code{SDL_net} \tab pre-built n/a \cr
|
|
|
75 }
|
|
|
76
|
|
|
77 The prebuilt version of SDL from \url{http://www.drangon.org/mingw} did not work (exiting with OpenGL errors).
|
|
|
78 If you know of other resources for prebuilt 64-bit packages for SDL and expat, please report.
|
|
|
79 }
|
|
|
80 \section{Mac OS X Installation Notes}{
|
|
|
81 Download the \code{*.dmg} files, mount them (by double-click) and copy \code{*.framework} folders to \code{/Library/Frameworks}.
|
|
|
82 \tabular{ll}{
|
|
|
83 \strong{Lib} \tab \strong{Download link} \cr
|
|
|
84 \code{expat} \tab pre-installed \cr
|
|
|
85 \code{GL} \tab pre-installed \cr
|
|
|
86 \code{GLU} \tab pre-installed \cr
|
|
|
87 \code{glew} \tab \code{port install glew} \cr
|
|
|
88 \code{SDL} \tab \url{http://www.libsdl.org/release/SDL-1.2.14.dmg} \cr
|
|
|
89 \code{SDL_image} \tab \url{http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.10.dmg} \cr
|
|
|
90 \code{SDL_mixer} \tab \url{http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.11.dmg} \cr
|
|
|
91 \code{SDL_ttf} \tab \url{http://www.libsdl.org/projects/SDL_ttf/release/SDL_ttf-2.0.10.dmg} \cr
|
|
|
92 \code{SDL_net} \tab \url{http://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.7.dmg} \cr
|
|
|
93 }
|
|
|
94 }
|
|
|
95 \section{Linux/Debian Installation Notes}{
|
|
|
96
|
|
|
97 Debian Package installation via aptitude
|
|
|
98
|
|
|
99 \preformatted{aptitude install <pkg-names>..}
|
|
|
100
|
|
|
101 \tabular{ll}{
|
|
|
102 \strong{Lib} \tab \strong{Debian Package name(s)} \cr
|
|
|
103 \code{expat} \tab \code{libexpat1} (version 1.5.2 - already installed?)\cr
|
|
|
104 \code{GL} \tab \code{libgl1-mesa-glx} and \code{libgl1-mesa-dri} \cr
|
|
|
105 \code{GLU} \tab \code{libglu1-mesa} \cr
|
|
|
106 \code{glew} \tab \code{libglew1.5} \cr
|
|
|
107 \code{SDL} \tab \code{libsdl1.2debian} and \code{libsdl1.2debian-<SOUNDSYS>} \cr
|
|
|
108 \code{SDL_image} \tab \code{libsdl-image1.2} \cr
|
|
|
109 \code{SDL_mixer} \tab \code{libsdl-mixer1.2} \cr
|
|
|
110 \code{SDL_ttf} \tab \code{libsdl-ttf2.0} \cr
|
|
|
111 \code{SDL_net} \tab \code{libsdl-net1.2} \cr
|
|
|
112 }
|
|
|
113 Depending on your sound system, \code{<SOUNDSYS>} should be explaced with one of the following: alsa, all, esd, arts, oss, nas or pulseaudio.
|
|
|
114 Tested with Debian 5 and 6 (lenny and squeeze).
|
|
|
115 }
|
|
|
116 \section{Linux/Fedora Installation Notes}{
|
|
|
117 \preformatted{pkcon install <pkgname>..}
|
|
|
118 \tabular{ll}{
|
|
|
119 \strong{Lib} \tab \strong{RPM Package name} \cr
|
|
|
120 \code{expat} \tab \code{expat} \cr
|
|
|
121 \code{GL} \tab \code{mesa-libGL} \cr
|
|
|
122 \code{GLU} \tab \code{mesa-libGLU} \cr
|
|
|
123 \code{glew} \tab \code{glew} \cr
|
|
|
124 \code{SDL} \tab \code{SDL} \cr
|
|
|
125 \code{SDL_image} \tab \code{SDL_image} \cr
|
|
|
126 \code{SDL_mixer} \tab \code{SDL_mixer} \cr
|
|
|
127 \code{SDL_ttf} \tab \code{SDL_ttf} \cr
|
|
|
128 \code{SDL_net} \tab \code{SDL_net} \cr
|
|
|
129 }
|
|
|
130 Tested with Fedora 13 and 14 on x86 and x86_64.
|
|
|
131 }
|
|
|
132 \section{Linux/openSUSE Installation Notes}{
|
|
|
133 \preformatted{zypper in <pkgname>..}
|
|
|
134 \tabular{ll}{
|
|
|
135 \strong{Lib} \tab \strong{Package Name} \cr
|
|
|
136 \code{SDL} \tab \code{libSDL} \cr
|
|
|
137 \code{SDL_image} \tab \code{libSDL_image} \cr
|
|
|
138 \code{SDL_mixer} \tab \code{libSDL_mixer} \cr
|
|
|
139 \code{SDL_net} \tab \code{libSDL_net} \cr
|
|
|
140 \code{SDL_ttf} \tab \code{libSDL_ttf} \cr
|
|
|
141 \code{glew} \tab \code{libGLEW1_6} \cr
|
|
|
142 }
|
|
|
143 openSUSE installation notes have not been confirmed.
|
|
|
144 }
|
|
|
145 \section{NetBSD Installation Notes}{
|
|
|
146
|
|
|
147 Installation via pkgsrc:
|
|
|
148
|
|
|
149 \preformatted{pkg_add <pkgname>..}
|
|
|
150
|
|
|
151 \tabular{ll}{
|
|
|
152 \strong{Lib} \tab \strong{pkgsrc name} \cr
|
|
|
153 \code{expat} \tab \code{expat} \cr
|
|
|
154 \code{GL} \tab \code{Mesa} \cr
|
|
|
155 \code{GLU} \tab \code{glu} \cr
|
|
|
156 \code{glew} \tab \code{glew} \cr
|
|
|
157 \code{SDL} \tab \code{SDL} \cr
|
|
|
158 \code{SDL_image} \tab \code{SDL_image} \cr
|
|
|
159 \code{SDL_mixer} \tab \code{SDL_mixer} \cr
|
|
|
160 \code{SDL_ttf} \tab \code{SDL_ttf} \cr
|
|
|
161 \code{SDL_net} \tab \code{SDL_net} \cr
|
|
|
162 }
|
|
|
163 }
|
|
|
164 \section{OpenBSD Installation Notes}{
|
|
|
165 Using packages:
|
|
|
166
|
|
|
167 \preformatted{pkg_add <pkgname>..}
|
|
|
168
|
|
|
169 \tabular{ll}{
|
|
|
170 \strong{Lib} \tab \strong{port name} \cr
|
|
|
171 \code{expat} \tab \code{expat} \cr
|
|
|
172 \code{SDL} \tab \code{SDL} \cr
|
|
|
173 \code{SDL_image} \tab \code{sdl-image} \cr
|
|
|
174 \code{SDL_mixer} \tab \code{sdl-mixer} \cr
|
|
|
175 \code{SDL_ttf} \tab not available \cr
|
|
|
176 \code{SDL_net} \tab \code{sdl-net} \cr
|
|
|
177 }
|
|
|
178
|
|
|
179 The SDL dynport failed on OpenBSD 4.8 - so no multimedia demos here - using the R 2.7 from the ports tree.
|
|
|
180 This must have been something to do with pthread discrepancies between SDL and R.
|
|
|
181 }
|
|
|
182 \section{FreeBSD Installation Notes}{
|
|
|
183 Using packages:
|
|
|
184
|
|
|
185 \preformatted{pkg_add -r <pkgname>..}
|
|
|
186
|
|
|
187 \tabular{ll}{
|
|
|
188 \strong{Lib} \tab \strong{pkgname} \cr
|
|
|
189 \code{expat} \tab \code{expat2} \cr
|
|
|
190 \code{GL} \tab \code{xorg} \cr
|
|
|
191 \code{glew} \tab \code{glew} \cr
|
|
|
192 \code{SDL} \tab \code{sdl} \cr
|
|
|
193 \code{SDL_image} \tab \code{sdl_image} \cr
|
|
|
194 \code{SDL_mixer} \tab \code{sdl_mixer} \cr
|
|
|
195 \code{SDL_ttf} \tab \code{sdl_ttf} \cr
|
|
|
196 \code{SDL_net} \tab \code{sdl_net} \cr
|
|
|
197 }
|
|
|
198
|
|
|
199 }
|
|
|
200 \section{Solaris Installation Notes}{
|
|
|
201
|
|
|
202 OpenCSW offers prebuilt binaries for Solaris.
|
|
|
203 The installation of OpenCSW packages is done via \code{pkgutil}.
|
|
|
204
|
|
|
205 \preformatted{pkgutil -i <pkgname>..}
|
|
|
206
|
|
|
207 See \url{http://www.opencsw.org} for details on the OpenCSW project.
|
|
|
208
|
|
|
209 \tabular{ll}{
|
|
|
210 \strong{Lib} \tab \strong{pkgname} \cr
|
|
|
211 \code{expat} \tab \code{expat} \cr
|
|
|
212 \code{GL} \tab \code{mesalibs} \cr
|
|
|
213 \code{GLU} \tab \code{mesalibs} \cr
|
|
|
214 \code{glew} \tab \code{glew} \cr
|
|
|
215 \code{SDL} \tab \code{libsdl1_2_0} \cr
|
|
|
216 \code{SDL_image} \tab \code{sdlimage} \cr
|
|
|
217 \code{SDL_mixer} \tab \code{sdlmixer} \cr
|
|
|
218 \code{SDL_net} \tab \code{sdlnet} \cr
|
|
|
219 \code{SDL_ttf} \tab \code{sdlttf} \cr
|
|
|
220 }
|
|
|
221
|
|
|
222 }
|
