C - R

Transcription

C - R

the rdyncall package
A n i m p r o v e d
f o r e i g n f u n c t i o n
i n t e r f a c e f o r R
Daniel Adler
Georg-August
Universität Göttingen
Tassilo Philipp
Potion Studios
Game Development
useR! 2009, 9th of July, Rennes, France
Program of this talk
Binding Binary Functionality
Example: Binding R with libSDL using ".C(..)"
Improvements using ".dyncall(..)"
Implementation: the dyncall C library
Overview of the rdyncall R Package
'Dynports' concept
Availability
Compiled
Libraries
Dynamic
Languages
Compiled
Libraries
Dynamic
Languages
Compiled
Libraries
SDL
Simple Directmedia Layer
Dynamic
Languages
Compiled
Libraries
SDL
C
Dynamic
Languages
Compiled
Libraries
SDL
C
Dynamic
Languages
Compiled
Libraries
glew
C
SDL
C
C
C
C
Dynamic
Languages
Compiled
Libraries
glew
C
SDL
C
C
C
C
Dynamic
Languages
Compiled
Libraries
glew
C
SDL
C
C
C
C
Dynamic
Languages
Compiled
Libraries
glew
C
SDL
C
C
C
C
Dynamic
Languages
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
Dynamic
Languages
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
Dynamic
Languages
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
Call(args)
Foreign Function Interface
Results
Dynamic
Languages
Binding libSDL using ".C(..)"
C Function: SDL_Surface* SDL_SetVideoMode(int w, int h, int bpp, uint flags);
R calls C:
surface <- .C(funaddr, 640L, 480L, 32L, 0L)
R calls C:
fails
R calls C:
fails
Expected
void
C Interface:
SDL_SetVideoMode(int* w, int* h, int* bpp, int* flags);
R to C mapping:
Limitations:
R Vector mode
C Pointer Type
logical
int*
integer
int*
double
double*
character
char**
raw
unsigned char*
R calls C:
fails
Expected
void
C Interface:
R to C mapping:
Limitations:
no scalar types
R Vector mode
C Pointer Type
logical
int*
integer
int*
double
double*
character
char**
raw
unsigned char*
R calls C:
fails
Expected
void
C Interface:
R to C mapping:
Limitations:
no scalar types
no return types
R Vector mode
C Pointer Type
logical
int*
integer
int*
double
double*
character
char**
raw
unsigned char*
R calls C:
fails
Expected
void
C Interface:
R to C mapping:
Limitations:
no scalar types
no return types
one-to-one mapping
R Vector mode
C Pointer Type
logical
int*
integer
int*
double
double*
character
char**
raw
unsigned char*
Binding libSDL using ".Call(..)" + Wrapper DLL
SEXP wrapper(SEXP w, SEXP h, SEXP bpp, SEXP flags) {
return R_MakeExternalPtr(
SDL_SetVideoMode(
C wrapper
INTEGER(w)[0], INTEGER(h)[0],
source code:
INTEGER(bpp)[0], (uint) INTEGER(flags)[0]
), R_NilValue, R_NilValue);
}
SDL_SetVideoMode(
C wrapper
source code:
}
Runtime:
wrapper.dll
SDL.dll
SDL_SetVideoMode(
C wrapper
source code:
}
compile,
link
Runtime:
wrapper.dll
SDL.dll
SDL_SetVideoMode(
C wrapper
source code:
}
compile,
link
Runtime:
wrapper.dll
SDL.dll
SDL_SetVideoMode(
C wrapper
source code:
}
compile,
link
Runtime:
wrapper.dll
R calls C:
SDL.dll
surfPtr <- .Call(wrapper_funptr, 640L, 480L, 32L, 0L )
Direct call using ".dyncall(..)"
R calls C:
surface <- .dyncall(funaddr,
"iiiI)p", 640L, 480L, 32L, 0L)
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Function Call Signature
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Signature
Format:
"{argument types in left-to-right order} ')' {return type}"
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Signature
Format:
C Type
void
char, short, int, long, long long
unsigned integers (capitalized)
float, double
T* (any C pointer)
const char*(C String)
bool (c++), _Bool_t
struct/union C pointers
Signature Character
'v'
'c', 's', 'i', 'j', 'l'
'C', 'S', 'I', 'J', 'L'
'f', 'd'
'p' or '*' ...
'Z'
'B'
'*<' typename '>'
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Signature
Format:
Supports
C Type
void
float, double
T* (any C pointer)
bool (c++), _Bool_t
Signature Character
'v'
'c', 's', 'i', 'j', 'l'
'C', 'S', 'I', 'J', 'L'
'f', 'd'
'p' or '*' ...
'Z'
'B'
'*<' typename '>'
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Signature
Format:
Supports
scalars
C Type
void
float, double
T* (any C pointer)
bool (c++), _Bool_t
Signature Character
'v'
'c', 's', 'i', 'j', 'l'
'C', 'S', 'I', 'J', 'L'
'f', 'd'
'p' or '*' ...
'Z'
'B'
'*<' typename '>'
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Signature
Format:
Supports
scalars
return types
C Type
void
float, double
T* (any C pointer)
bool (c++), _Bool_t
Signature Character
'v'
'c', 's', 'i', 'j', 'l'
'C', 'S', 'I', 'J', 'L'
'f', 'd'
'p' or '*' ...
'Z'
'B'
'*<' typename '>'
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Signature
Format:
Supports
scalars
return types
atomic data ptrs
C Type
void
float, double
T* (any C pointer)
bool (c++), _Bool_t
Signature Character
'v'
'c', 's', 'i', 'j', 'l'
'C', 'S', 'I', 'J', 'L'
'f', 'd'
'p' or '*' ...
'Z'
'B'
'*<' typename '>'
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Signature
Format:
Supports
scalars
return types
atomic data ptrs
8..64 bit (u)ints
C Type
void
float, double
T* (any C pointer)
bool (c++), _Bool_t
Signature Character
'v'
'c', 's', 'i', 'j', 'l'
'C', 'S', 'I', 'J', 'L'
'f', 'd'
'p' or '*' ...
'Z'
'B'
'*<' typename '>'
R calls C:
"iiiI)p", 640L, 480L, 32L, 0L)
Signature
Format:
Supports
scalars
return types
atomic data ptrs
8..64 bit (u)ints
struct/union ptrs
C Type
void
float, double
T* (any C pointer)
bool (c++), _Bool_t
Signature Character
'v'
'c', 's', 'i', 'j', 'l'
'C', 'S', 'I', 'J', 'L'
'f', 'd'
'p' or '*' ...
'Z'
'B'
'*<' typename '>'
Implementation of the dyncall C library
Processors
x86
x64
ppc
arm
mips
Platforms
Processors
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
x86
x64
ppc
arm
mips
Calling
Conventions
cdecl
stdcall
fastcall.gcc
fastcall.ms
thiscall.gcc
thiscall.ms
win64
system v
darwin
system v
arm9e
thumb
eabi
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
dyncall library
Calling
Conventions
cdecl
stdcall
fastcall.gcc
fastcall.ms
thiscall.gcc
thiscall.ms
win64
system v
darwin
system v
arm9e
thumb
eabi
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
C Interface
dyncall library
Calling
Conventions
cdecl
stdcall
fastcall.gcc
fastcall.ms
thiscall.gcc
thiscall.ms
win64
system v
darwin
system v
arm9e
thumb
eabi
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
C Interface
Front-end
Processor Back-end
calling
convention
calling
convention
..
calling
convention
dyncall library
Calling
Conventions
cdecl
stdcall
fastcall.gcc
fastcall.ms
thiscall.gcc
thiscall.ms
win64
system v
darwin
system v
arm9e
thumb
eabi
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
C Interface
Front-end
1
Processor Back-end
calling
convention
calling
convention
..
calling
convention
dyncall library
Calling
Conventions
cdecl
stdcall
fastcall.gcc
fastcall.ms
thiscall.gcc
thiscall.ms
win64
system v
darwin
system v
arm9e
thumb
eabi
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
Call Engine
C Interface
Front-end
1
Load Argument
State-Machine
Processor Back-end
calling
convention
calling
convention
..
calling
convention
Call Kernel
(Assembly)
dyncall library
Calling
Conventions
cdecl
stdcall
fastcall.gcc
fastcall.ms
thiscall.gcc
thiscall.ms
win64
system v
darwin
system v
arm9e
thumb
eabi
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
Call Engine
C Interface
Front-end
1
Load Argument 2
State-Machine
Processor Back-end
calling
convention
calling
convention
..
calling
convention
Call Kernel
(Assembly)
dyncall library
Calling
Conventions
cdecl
stdcall
fastcall.gcc
fastcall.ms
thiscall.gcc
thiscall.ms
win64
system v
darwin
system v
arm9e
thumb
eabi
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
Call Engine
C Interface
Front-end
1
Load Argument 2
State-Machine
Processor Back-end
calling
convention
calling
convention
..
calling
convention
Call Kernel
(Assembly)
3
dyncall library
Calling
Conventions
cdecl
stdcall
fastcall.gcc
fastcall.ms
thiscall.gcc
thiscall.ms
win64
system v
darwin
system v
arm9e
thumb
eabi
x86
x64
ppc
arm
mips
C/C++
Compilers
Platforms
Processors
Overview of rdyncall R Package
R implementation
Function Calls
.dyncall(..)
rdyncall C implementation
dyncall
dyncall libraries
R implementation
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
dyncall
dynload
dyncall libraries
R implementation
Function Calls
.dyncall(..)
dyncall
Locate/Load Code
dynfind(..)
> dynfind("SDL")
<pointer:rdyncall
0x1583d670>
C implementation
attr(,"path")
[1] "/Library/Frameworks/SDL.framework/SDL"
dynload
attr(,"auto.unload")
[1] TRUE
dyncall libraries
R implementation
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
dyncall
dynload
dyncall libraries
R implementation
Binding of Libraries / R Wrappers
dynbind(..)
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
dyncall
dynload
dyncall libraries
R implementation
dynbind(..)
> dynbind("SDL","
SDL_SetVideoMode(iiiI)*<SDL_Surface>;
Function
Calls
Locate/Load Code
SDL_GL_SwapBuffers()v;
.dyncall(..)
dynfind(..)
SDL_PollEvents(*<SDL_Event>)v;SDL_Delay(i)v;")
> ls()
[1] "SDL_SetVideoMode" "SDL_GL_SwapBuffers"
[3] "SDL_PollEvents"
"SDL_Delay"
> SDL_SetVideoMode
dyncall
function (...)dynload
.dyncall.cdecl(<pointer:0x142b7190>,
dyncall libraries
"iiiI)*<SDL_Surface>" , ...)
R implementation
dynbind(..)
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
dyncall
dynload
dyncall libraries
R implementation
High-level C Type
new.struct(..)
as.struct(..)
dynbind(..)
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
dyncall
dynload
dyncall libraries
Low-level C Type
.pack(..)
.unpack(..)
R implementation
High-level C Type
new.struct(..)
as.struct(..)
dynbind(..)
Function Calls
.dyncall(..)
dyncall
>Locate/Load
parseStructInfos("SDL_Rect{ssSS}x
y w h;")
Low-level
C Type
Code
> x <- new.struct("SDL_Rect")
.pack(..)
dynfind(..)
> x$w <- 100
.unpack(..)
> typeof(x)
[1] "raw"
> x$w rdyncall C implementation
[1] 100
dynload
dyncall libraries
R implementation
High-level C Type
new.struct(..)
as.struct(..)
dynbind(..)
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
dyncall
dynload
dyncall libraries
Low-level C Type
.pack(..)
.unpack(..)
R implementation
R Function
Callbacks
dynbind(..)
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
new.callback(..)
dyncall
dynload
dyncallback
dyncall libraries
High-level C Type
new.struct(..)
as.struct(..)
Low-level C Type
.pack(..)
.unpack(..)
R implementation
R Function
Callbacks
dynbind(..)
Function Calls
.dyncall(..)
dyncall
High-level C Type
new.struct(..)
as.struct(..)
Low-level C Type
.pack(..)
dynfind(..)
new.callback(..)
.unpack(..)
> tagBegin <- function(handle,tag,attrs){..}
> cb <- new.callback("pZp)v",tagBegin)
> XML_SetElementHandler(handle,cb,NULL)
Locate/Load Code
dynload
dyncallback
dyncall libraries
R implementation
R Function
Callbacks
dynbind(..)
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
new.callback(..)
dyncall
dynload
dyncallback
dyncall libraries
High-level C Type
new.struct(..)
as.struct(..)
Low-level C Type
.pack(..)
.unpack(..)
R implementation
Dynamic Packages / Multi-Platform Code Bindings
dynport(..)
loadDynportNamespace(..)
R Function
Callbacks
dynbind(..)
Function Calls
.dyncall(..)
Locate/Load Code
dynfind(..)
new.callback(..)
dyncall
dynload
dyncallback
dyncall libraries
dynport files
Text-based
Binding Meta-Information
High-level C Type
new.struct(..)
as.struct(..)
Low-level C Type
.pack(..)
.unpack(..)
R implementation
Dynamic Packages / Multi-Platform Code Bindings
dynport(..)
loadDynportNamespace(..)
dynport files
Text-based
Binding Meta-Information
> dynport(SDL)
R Function
High-level C Type
> search()
Callbacks
new.struct(..)
[1]
".GlobalEnv"
"package:SDL"
dynbind(..)
as.struct(..)
[3] "package:rdyncall" ...
> ls(2)
Low-level C Type
Function Calls
Locate/Load
Code
[51] "SDLK_F1"
# constants
[539] "SDL_PixelFormat" # C struct
type
.pack(..)
.dyncall(..)
dynfind(..)
new.callback(..)
[537] "SDL_PauseAudio"
# functions
.unpack(..)
> unloadNamespace("SDL")
dyncall
dynload
dyncallback
dyncall libraries
What's so far available as dynport's
dynport
functions
symbolics
types
SDL
201
416
34
GL
336
3254
-
GLU
59
155
-
glew
1465
-
-
SDL_Image
27
-
-
ode
545
-
NA
expat
65
70
-
R
238
22
NA
What's so far available as dynport's
dynport
functions
symbolics
types
SDL
201
416
34
GL
336
3254
-
GLU
59
155
-
glew
1465
-
-
SDL_Image
27
-
-
ode
545
-
NA
expat
65
70
-
R
238
22
NA
the dynport concept
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
Dynamic
Languages
the dynport concept
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
Dynamic
Languages
the dynport concept
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
dynport
bindings
Dynamic
Languages
the dynport concept
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
dynport
bindings
Dynamic
Languages
the dynport concept
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
dynport
bindings
Dynamic
Languages
the dynport concept
Compiled
Libraries
glew
C
C
SDL
C
C
C
C
dynports
repository
dynport
bindings
Dynamic
Languages
rdyncall and dyncall
available open-source (BSD)
R Package available soon on CRAN
http://dyncall.org

C - R

Transcription

Similar documents