annotate R/dynport.rnw @ 34:2682a627168c

- breaking changes: * restrict 'Z' conversions to immutable types * restrict 'p' to mutable types (and handles)
author Tassilo Philipp
date Sun, 12 Apr 2020 19:37:37 +0200
parents 0cfcc391201f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
1 % \VignetteIndexEntry{Dynamic R Binding to shared C libraries in a portable way}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
2 % \VignetteKeyword{dynport}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
3 % \VignetteKeyword{bindings}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
4 \documentclass{article}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
5 \usepackage{url}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
6 \begin{document}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
7 \title{Dynports: Dynamic R Bindings of shared C libraries in a portable way}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
8 \author{Daniel Adler}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
9 \maketitle
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
10
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
11 \section{Introduction}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
12
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
13 A \emph{dynport} is mapped in R as a dynamically created R namespace
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
14 containing wrapper functions, constants and type information objects
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
15 (used in conjunction with utility functions from the package) to gain
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
16 control over a large range of functionality offered by system service
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
17 and binary components.
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
18 These bindings can be written by hand but - as these are
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
19 very structured using formal signatures - this process
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
20 is also automated.
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
21 Here is a list of dynports for the initial release:
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
22
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
23 \begin{tabular}{lll}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
24 dynport & library & details\\
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
25 \hline
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
26 GL & OpenGL 1.0 & Portable 3D Graphics System Library \\
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
27 glew & GL Extension Wrangler & Provides OpenGL 3.0 \\
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
28 SDL & Simple DirectMedia Layer & Multimedia and user-interface. \\
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
29 SDL\_ttf & SDL Font Rendering Library & True Type Font Rendering \\
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
30 SDL\_image & SDL Image I/O Library & Image Loading and Saving in many formats \\
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
31 \end{tabular}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
32
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
33 \end{document}
0cfcc391201f initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
34