docs/glfbdev-driver.html

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