-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
96 lines (65 loc) · 2.68 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
OCamlSDL - An interface between OCaml and SDL
Overview
========
The goal of OCamlSDL is to provide access the multimedia hardware
in the ML programming language with the help of the SDL library.
The Simple DirectMedia Layer is a generic API that provides low
level access to audio, keyboard, mouse, and display framebuffer across
multiple platforms.
OCamlSDL is hosted on SourceForge.net:
http://ocamlsdl.sourceforge.net/
http://www.sourceforge.net/projects/ocamlsdl/
Requirements
============
OCamlSDL needs the following software and libraries:
OCaml http://www.ocaml.org/
SDL http://www.libsdl.org/ (1.2.x)
and optionally:
SDL_ttf http://www.libsdl.org/projects/SDL_ttf/ (2.x)
SDL_mixer http://www.libsdl.org/projects/SDL_mixer/ (1.2.x)
SDL_image http://www.libsdl.org/projects/SDL_image/ (1.2.x)
SDL_gfx http://www.ferzkopp.net/joomla/software-mainmenu-14/4-ferzkopps-linux-software/19-sdlgfx
LablGL http://wwwfun.kurims.kyoto-u.ac.jp/soft/olabl/lablgl.html
findlib http://projects.camlcity.org/projects/findlib.html
Using
=====
See the INSTALL file (and INSTALL.win32) for information on how to
compile and install the library.
The library use the Bigarray module (distributed with OCaml), to
interface with C so programs using OCamlSDL must also be linked with
bigarray. Example :
$ ocamlc -c -I /path/to/ocamlsdl my_prog.ml
$ ocamlc -o my_prog -I /path/to/ocamlsdl bigarray.cma sdl.cma sdttf.cma my_prog.cmo
If OCamlSDL was installed using findlib, the package manager will take
care of that:
$ ocamlfind ocamlc -c -package sdlttf -linkpkg my_prog.ml
$ ocamlfind ocamlc -o my_prog -package sdlttf -linkpkg my_prog.cmo
MacOSX users should also read README.macosx .
Documentation
=============
You can browse the ocaml API documentation at:
http://ocamlsdl.sourceforge.net/docs/index.html
You can find SDL documentation on the SDL website:
http://www.libsdl.org/
Toplevel
========
You can build a custom toplevel including OCamlSDL libraries with:
$ ocamlmktop -o ocamlsdl -I /path/to/ocamlsdl -custom bigarray.cma sdl.cma ...
If you use OCaml >= 3.04, the static toplevel is not really necessary
since you can dynamically load OCamlSDL in the toplevel:
$ ocaml
Objective Caml version 3.04
# #load "bigarray.cma" ;;
# #load "sdl.cma" ;;
#
Feedback
========
Bugs can be reported on the SourceForge project page or on the mailing lists.
There are two mailing lists:
ocamlsdl-user@lists.sourceforge.net
ocamlsdl-devel@lists.sourceforge.net
Subscription information and archives are available here:
http://lists.sourceforge.net/lists/listinfo/ocamlsdl-user
http://lists.sourceforge.net/lists/listinfo/ocamlsdl-devel
--
The OCamlSDL developers