From 01df5d59e56a1b060568f8cad2e89f7eea22fc70 Mon Sep 17 00:00:00 2001 From: marha Date: Mon, 29 Aug 2011 08:51:20 +0200 Subject: xwininfo libX11 libXmu libxcb mesa xserver xkeyboard-config git update 29 aug 2011 --- mesalib/docs/glfbdev-driver.html | 111 --------------------------------------- 1 file changed, 111 deletions(-) delete mode 100644 mesalib/docs/glfbdev-driver.html (limited to 'mesalib/docs/glfbdev-driver.html') diff --git a/mesalib/docs/glfbdev-driver.html b/mesalib/docs/glfbdev-driver.html deleted file mode 100644 index 981df7c08..000000000 --- a/mesalib/docs/glfbdev-driver.html +++ /dev/null @@ -1,111 +0,0 @@ - - -Mesa glFBDev Driver - - - - - -

Mesa glFBDev Driver

- - -

1. Introduction

- -

-The GLFBDev driver interface allows one to do OpenGL rendering into a -framebuffer managed with the Linux's fbdev interface. -

- -

-Basically, the programmer uses the fbdev functions to initialize the -graphics hardware and setup the framebuffer. -Then, using a calls to Mesa's glFBDev API functions, one can render -into the framebuffer with the OpenGL API functions. -

- -

-Note, only software rendering is supported; there is no hardware -acceleration. -

- - -

-The GL/glfbdev.h header file defines the glFBDev interface. -

- -

-The progs/fbdev/glfbdevtest.c demonstrates how to use the glFBDev interface. -

- - -

-For more information about fbdev, see the - -Framebuffer Howto -

-

-You will need at minimum, a framebuffer device, check /dev/fb0 -

- -

2. Compilation

- -

-To compile Mesa with support for the glFBDev interface: -

-      make realclean
-      make linux-fbdev
-
- -

-When compilation is finished look in progs/glfbdev/ for the glfbdevtest demo. -

-

3. Permissions

- -

-Typically /dev/fb/0 is grouped to the video group. It may be useful to add -your user to the video group so the demos will not have to be run as root. -To use fbdevglut with the prefered tty input, you should add the user to the -tty group as well -

- -

4. Using fbdevglut

-Almost all of the programs in the progs directory use glut, and they compile with fbdevglut. - -

-To compile the redbook sample programs: -

-       cd progs/redbook
-       make
-
-

-

glut features not supported: -

  • Overlays -
  • Subwindows -
  • Input devices other than Keyboard/Mouse -
  • No support for GLUT_MULTISAMPLE, GLUT_STEREO, or GLUT_LUMINANCE -
  • Cursor and Menu Support will flicker in GLUT_SINGLE mode - -

    Keyboard input is read by opening /dev/tty and reading keycodes in medium raw mode. -

    Mouse input is read from env var MOUSE, or /dev/gpmdata and should be in ms3 format. -To forward data in this format to /dev/gpmdata, run gpm with the -Rms3 option. -

    glutInit allows glut programs to pass parameters to the glut library, currently the -following options are supported for fbdevglut: -

  • -geometry widthxheight -- This will force the resolution to be widthxheight instead of autodetecting. -The modes are read from /etc/fb.modes -

  • -bpp -- This will force the bitdepth to the one specified -

  • -vt -- This allows you to specify the virtual terminal to attach keyboard input to. It is useful to specify when running inside screen. -

  • -mousespeed -- A floating point multiplication factor to increase mouse speed -

  • -nomouse -- Disable mouse support -

  • -nokeyboard -- Disable keyboard support (this will probably break mouse support as well) -

  • -stdin -- Use stdin for input instead of attaching to kbd in medium-raw mode. -This will make it impossible to detect keypresses like Shift+Tab, you will also need to specify -gpmmouse for mouse support. This option can be used with a debugger, and it is possible to single step a program with gdb and set the FRAMEBUFFER environment variable to a different framebuffer for display. The program will not be able to handle vt switching on it's own, so it will always display. -

  • -gpmmouse -- This will attempt to connect to the /dev/gpmctl socket using liblow -for mouse data. Gpm does not provide this data when in graphics mode, so vt switching -will briefly display text. This mode typically has no initial mouse delay. -

  • -- Ignore any additional arguments -

    Notes: -

    -1. The mouse pointer flickers in single buffering mode, as it must be rendered in software. Hopefully in the future there will be a way to access hardware cursors in fbdev devices. -

    - - -- cgit v1.2.3