annotate DOCS/DXR3 @ 4478:38d3954edb48

applied David Holm's patch

How to use a Sigma Designs Hollywood Plus and/or a Creative DXR3 by David Holm
==============================================================================

Thanks goes out to Daniel Bell for the donation of a brand new 20GB IBM
harddisk.

1. Requirements

 * First of all you will need the DXR3/H+ drivers properly installed.
   Version 0.10.0 or later. You can find it at
   http://dxr3.sourceforge.net/

 * Run <mplayerdir>/configure and make sure that DXR3/H+ support = yes
   if you want to play files other than mpeg libmp1e should be = yes as well
   
 From here on compilation (of at least my code ;) should go without any
 problems.



2. Usage

    -vo dxr3:<devicenum>		For video output
    -ao oss:<devicefile>		For audio output
    -ac hwac3				For digital audio output instead of
					analog
    -vc mpegpes				For mpeg playback
    -aop list=resample:fout=48000	If samplerate is below 44100Hz
    <devicenum>				Number of device to use for playback
				        (if you	have more than one card.).
					This can usually be left out (-vo dxr3).
					Mandrake 8.1 uses devfs by default. If
					you are running mandrake 8.1 please use
					-vo dxr3:0
    <devicefile>			Normally /dev/em8300_ma or
					/dev/em8300_ma-<devicenum>
					(-ao dxr3:/dev/em8300_ma). If left out
					the default oss device will be used
					(normally soundcard).

MPEG-1, MPEG-2, VCD and DVD Notes
There are some important notes to take into account here for optimum playback.
MPlayer currently does not autodetect that the dxr3 can playback mpegs. So for
mpeg files, dvd's and vcd's you have to add -vc mpegpes to tell mplayer that
you are using a hardware accelerator. Otherwise mplayer will decode the movie
in software, which is much slower.
Note that you cannot use -vc mpegpes with movies that aren't mpeg 1 or 2 or
you will get an error message saying "Can't find codec for video format...".

* If you run mplayer as root, or set userid root it will use your pc's internal
  realtime clockgenerator for syncing. (If your kernel supports it (It's
  located in character devices and called "Enhanced realtime clock support")).
  Some people report that this has improved playback (which it should), but
  others have had problems with it. You will have to experiment yourself with
  this to find your optimum setup.



3. Contacting me

You can contact me either by e-mailing me, <[e-mail]> or by using
icq: 798427
Feedback, bugreports and general suggestions are appreciated (preferably
by e-mail).