view vidix/README.dha @ 28703:439de22fe1c0

r27801 Clarify screenw/screenh options, patch by Christian Ohm, chr.ohm gmx net. r27872 Add a few more supported URL protocols r27895 Fix typo in psy-rd x264 option description. r27906 document x264's option subq=0, plus a bit of factoring and added details r27973 add direct3d docs, ok'd by Guillaume r27979 Make description of the option more clear r28056 Add a note about some known issues with -vo sdl r28095 Document missing vo_gl suboptions r28096 Using rectangle=2 for vo_gl is probably a good idea nowadays. r28126 Add support for writing PNG files with alpha channel in -vo png

lidbha - Direct Hardware Access library
=======================================

This library was designed for providing direct hardware access under different
OS'es and architectures, so it's platform- and os-independent.

The main project on the top of libdha is Vidix. It provides userspace
video drivers for Matrox, Ati, 3Dlabs, Trident (and it's still evolving).

For the full list of supported OS'es read the sources, anyway here's a 'reported
as working' list (these platforms are used daily):
 Linux/x86
 FreeBSD/x86
 NetBSD/x86
 Linux/PPC

There are different ways to access the hardware, normally only ROOT can do that.
With root privileges libdha will run fine, but there are some others ways
to use it as a normal user:
1, set the SUID bit on the binary (in this way it runs with root privileges)
2, use svgalib kernel helper (please read the comment in the Makefile)
3, use dhahelper (not yet finished)

The library is based on XFree86 and gfxdump (a utility from the GATOS project)
sources.

Original import and design by Nick Kurshev and Alex Beregszaszi.
Current maintenance and dhahelper by Alex Beregszaszi.
Svgalib kernelhelper support by Matan Ziv-Av.
(for the e-mail addresses see the AUTHORS file in MPlayer)