updated URL
[mesa.git] / docs / glfbdev-driver.html
1 <HTML>
2
3 <TITLE>Mesa glFBDev Driver</TITLE>
4
5 <BODY text="#000000" bgcolor="#55bbff" link="#111188">
6
7 <center><H1>Mesa glFBDev Driver</H1></center>
8
9
10 <H1>1. Introduction</H1>
11
12 <p>
13 The GLFBDev driver interface allows one to do OpenGL rendering into a
14 framebuffer managed with the Linux's fbdev interface.
15 </p>
16
17 <p>
18 Basically, the programmer uses the fbdev functions to initialize the
19 graphics hardware and setup the framebuffer.
20 Then, using a calls to Mesa's glFBDev API functions, one can render
21 into the framebuffer with the OpenGL API functions.
22 </p>
23
24 <p>
25 Note, only software rendering is supported; there is no hardware
26 acceleration.
27 </p>
28
29
30 <p>
31 The GL/glfbdev.h header file defines the glFBDev interface.
32 </p>
33
34 <p>
35 The progs/fbdev/glfbdevtest.c demonstrates how to use the glFBDev interface.
36 </p>
37
38 <p>
39 For more information about fbdev, see the
40 <a href="http://www.tldp.org/HOWTO/Framebuffer-HOWTO.html" target="_parent">
41 Framebuffer Howto</a>
42 </p>
43
44
45 <h1>2. Compilation</h1>
46
47 <p>
48 To compile Mesa with support for the glFBDev interface:
49 <pre>
50 XXX todo
51 </pre>
52
53 <p>
54 When compilation is finished look in progs/glfbdev/ for the glfbdevtest demo.
55 </p>
56
57 </p>
58 xxx todo
59 </p>
60
61
62 <h1>3. Compiling and linking glFBDev programs</h1>
63
64 <p>
65 xxx todo
66 </p>
67
68
69
70 <h1>4. Running glFBDev programs</h1>
71
72 <p>
73 First, you need to have a working fbdev environment.
74 See the
75 <a href="http://www.tldp.org/HOWTO/Framebuffer-HOWTO.html" target="_parent">
76 Framebuffer Howto</a> for information.
77 </p>
78
79 <p>
80 Programs must be run with root permission.
81 </p>
82
83 </p>
84
85
86
87 </body>
88 </html>