rdyncall-demos: rdyncall demos: Platform installation notes for required...

In rdyncall: Improved Foreign Function Interface (FFI) and Dynamic Bindings to C Libraries (e.g. OpenGL)

Description

The demos of the rdyncall package (see demo(package="rdyncall")) use shared libraries such as SDL, OpenGL and Expat via dynports - a dynamic binding approach which requires, that prebuilt binary shared library files are already installed.

Depending on the host system, some libraries are officially a part of the OS or Distribution, some others need to be installed to get the demos running.

As of the current version of this package, the installation of additional shared C libraries need to be done manually. It follows an overview of the required libraries and installation notes for various operating-systems and distributions.

Overview of Libraries

The following Libraries are used as 'run-time' pre-compiled binaries for the particular target OS and Hardware platform. Some notes on installation of additional run-time libraries required for some rdyncall demos:

Lib	Description	URL
expat	XML Parser	http://www.libexpat.org
GL	Open Graphics Library	http://opengl.org, http://www.mesa3d.org
GLU	OpenGL Utility Library	see links above
glew	OpenGL Extension Wrangler Library	http://glew.sourceforge.net/
SDL	Multimedia Framework	http://libsdl.org/
SDL_mixer	Music Format playing	http://www.libsdl.org/projects/SDL_mixer/
SDL_image	Image Format loading	http://www.libsdl.org/projects/SDL_image/
SDL_ttf	True Type Font rendering	http://www.libsdl.org/projects/SDL_ttf/
SDL_net	Network I/O	http://www.libsdl.org/projects/SDL_net/

In short: Place the shared libraries ( *.DLL, *.so or *.dylib) in a standard location or modify LD_LIBRARY_PATH(unix) or PATH(windows) so that dynfind can find the libraries.

On Mac OS X framework folders are supported as well. Place the *.framework folder at /Library/Frameworks.

Detailed platform-specific installation instructions follow up.

Windows Installation Notes

Download the *.zip files, unpack them and place the *.DLL files to a place within PATH.

32-Bit versions:

Lib	Download Link
expat	http://expat.sourceforge.net (TODO:test installer)
GL	pre-installed
GLU	pre-installed
glew	http://sourceforge.net/projects/glew/files/glew/1.7.0/glew-1.7.0-win32.zip/download
SDL	http://www.libsdl.org/release/SDL-1.2.14-win32.zip
SDL_image	http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.10-win32.zip
SDL_mixer	http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.11-win32.zip
SDL_ttf	http://www.libsdl.org/projects/SDL_ttf/release/SDL_ttf-2.0.10-win32.zip
SDL_net	http://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.7-win32.zip

64-Bit version:

Lib	Downdload Link
expat	no prebuilt found (TODO: build)
GL	pre-installed
GLU	pre-installed
glew	http://sourceforge.net/projects/glew/files/glew/1.7.0/glew-1.7.0-win64.zip/download
SDL	http://mamedev.org/tools/20100102/sdl-1.2.14-r5428-w64.zip
SDL_image	pre-built n/a
SDL_mixer	pre-built n/a
SDL_ttf	pre-built n/a
SDL_net	pre-built n/a

The prebuilt version of SDL from http://www.drangon.org/mingw did not work (exiting with OpenGL errors). If you know of other resources for prebuilt 64-bit packages for SDL and expat, please report.

Mac OS X Installation Notes

Download the *.dmg files, mount them (by double-click) and copy *.framework folders to /Library/Frameworks.

Lib	Download link
expat	pre-installed
GL	pre-installed
GLU	pre-installed
glew	port install glew
SDL	http://www.libsdl.org/release/SDL-1.2.14.dmg
SDL_image	http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.10.dmg
SDL_mixer	http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.11.dmg
SDL_ttf	http://www.libsdl.org/projects/SDL_ttf/release/SDL_ttf-2.0.10.dmg
SDL_net	http://www.libsdl.org/projects/SDL_net/release/SDL_net-1.2.7.dmg

Linux/Debian Installation Notes

Debian Package installation via aptitude

aptitude install <pkg-names>..

Lib	Debian Package name(s)
expat	libexpat1 (version 1.5.2 - already installed?)
GL	libgl1-mesa-glx and libgl1-mesa-dri
GLU	libglu1-mesa
glew	libglew1.5
SDL	libsdl1.2debian and libsdl1.2debian-<SOUNDSYS>
SDL_image	libsdl-image1.2
SDL_mixer	libsdl-mixer1.2
SDL_ttf	libsdl-ttf2.0
SDL_net	libsdl-net1.2

Depending on your sound system, <SOUNDSYS> should be explaced with one of the following: alsa, all, esd, arts, oss, nas or pulseaudio. Tested with Debian 5 and 6 (lenny and squeeze).

Linux/Fedora Installation Notes

pkcon install <pkgname>..

Lib	RPM Package name
expat	expat
GL	mesa-libGL
GLU	mesa-libGLU
glew	glew
SDL	SDL
SDL_image	SDL_image
SDL_mixer	SDL_mixer
SDL_ttf	SDL_ttf
SDL_net	SDL_net

Tested with Fedora 13 and 14 on x86 and x86_64.

Linux/openSUSE Installation Notes

zypper in <pkgname>..

Lib	Package Name
SDL	libSDL
SDL_image	libSDL_image
SDL_mixer	libSDL_mixer
SDL_net	libSDL_net
SDL_ttf	libSDL_ttf
glew	libGLEW1_6

openSUSE installation notes have not been confirmed.

NetBSD Installation Notes

Installation via pkgsrc:

pkg_add <pkgname>..

Lib	pkgsrc name
expat	expat
GL	Mesa
GLU	glu
glew	glew
SDL	SDL
SDL_image	SDL_image
SDL_mixer	SDL_mixer
SDL_ttf	SDL_ttf
SDL_net	SDL_net

OpenBSD Installation Notes

Using packages:

pkg_add <pkgname>..

Lib	port name
expat	expat
SDL	SDL
SDL_image	sdl-image
SDL_mixer	sdl-mixer
SDL_ttf	not available
SDL_net	sdl-net

The SDL dynport failed on OpenBSD 4.8 - so no multimedia demos here - using the R 2.7 from the ports tree. This must have been something to do with pthread discrepancies between SDL and R.

FreeBSD Installation Notes

Using packages:

pkg_add -r <pkgname>..

Lib	pkgname
expat	expat2
GL	xorg
glew	glew
SDL	sdl
SDL_image	sdl_image
SDL_mixer	sdl_mixer
SDL_ttf	sdl_ttf
SDL_net	sdl_net

Solaris Installation Notes

OpenCSW offers prebuilt binaries for Solaris. The installation of OpenCSW packages is done via pkgutil.

pkgutil -i <pkgname>..

See http://www.opencsw.org for details on the OpenCSW project.

Lib	pkgname
expat	expat
GL	mesalibs
GLU	mesalibs
glew	glew
SDL	libsdl1_2_0
SDL_image	sdlimage
SDL_mixer	sdlmixer
SDL_net	sdlnet
SDL_ttf	sdlttf

rdyncall documentation built on May 2, 2019, 6:15 p.m.