Mercurial > pub > dyncall > bindings

comparison R/rdyncall/man/rdyncall-demos.Rd @ 0:0cfcc391201f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
initial from svn dyncall-1745
author Daniel Adler
date Thu, 19 Mar 2015 22:26:28 +0100
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:0cfcc391201f
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 }