# HG changeset patch # User diego # Date 1030471567 0 # Node ID 0b70f3dc34ebb4e8ff8227103d73d66984a6ae4b # Parent 37b0958a1cad6b997242c7642efb9ca9420d24d5 Applied patch by Andras Mohari , with some small additions. * Replaced

. * Converted 3-pass encoding and mga_vid installation instructions to lists. * Converted options tables (video eq, SDL, fbdev, VESA, DXR3, TV input, DivX4Linux, AAlib) to
lists. * The "sections" for MPsub and INSTALLING OSD are numbered and displayed in the TOC now. * Changed the text inside some
tags. diff -r 37b0958a1cad -r 0b70f3dc34eb DOCS/codecs.html --- a/DOCS/codecs.html Tue Aug 27 16:17:54 2002 +0000 +++ b/DOCS/codecs.html Tue Aug 27 18:06:07 2002 +0000 @@ -73,15 +73,16 @@
DivX4Linux works in two modes:
- - - - - -
-vc odivx Uses the codec in OpenDivX fashion. In this case it +
+
-vc odivx
+
Uses the codec in OpenDivX fashion. In this case it produces YV12 images in its own buffer, and MPlayer does colorspace - conversion via libvo. (Fast, recommended!)
-vc divx4 Uses the colorspace conversion of the codec. - In this mode you can use YUY2/UYVY, too. (SLOW)
+ conversion via libvo. (Fast, recommended!) + +
-vc divx4
+
Uses the colorspace conversion of the codec. + In this mode you can use YUY2/UYVY, too. (SLOW)
+

The -vc odivx method is usually faster, due to the fact that it transfers image data in YV12 (planar YUV 4:2:0) format, thus requiring much @@ -142,7 +143,7 @@
MPlayer is capable of employing the XAnim codecs for decoding. Follow the instructions to enable them:
-
+

Download the codecs you wish to use from the XAnim site. The 3ivx codec is not there, but at the 3ivx site.
@@ -153,7 +154,7 @@ the directory of the XAnim codecs.
Rename/symlink the files, cutting out the architecture stuff, so they will have filenames like these: vid_cvid.xa, vid_h263.xa, vid_iv50.xa.
-
+

XAnim is video codec family number 10, so you may want to use the -vfm 10 option to tell MPlayer to use them if possible.

under development

Installation:

- -

It is currently available only from CVS. Here are the +

XViD is currently available only from CVS. Here are the download and installation instructions:

SVQ3 is still not reverse engineered.

Installation:

It's compiled and usable per default.

The Sorenson decoder is compiled and usable per default.

2.2.2 Audio codecs

Take a deep breath and start searching the registry...

Start regedit.
Press Ctrl-f, disable the first two checkboxes, and enable the third. Type in the fourcc of the codec (e.g. TM20). @@ -435,7 +432,7 @@ If not, you are out of luck. Try guessing (e.g. search for TrueMotion).
If the GUID is found you should see a FriendlyName and a CLSID field. Write down the 16 byte CLSID, this is the GUID we need. -

Note: If searching fails, try enabling all the checkboxes. You may have false hits, but you may get lucky...

diff -r 37b0958a1cad -r 0b70f3dc34eb DOCS/documentation.html --- a/DOCS/documentation.html Tue Aug 27 16:17:54 2002 +0000 +++ b/DOCS/documentation.html Tue Aug 27 18:06:07 2002 +0000 @@ -35,6 +35,10 @@

1.2 Installation

1.3 What about the GUI?

1.4 Subtitles and OSD

1.4.1 MPlayer's own subtitle format (MPsub)
1.4.2 Installing OSD and subtitles

1.5 RTC

@@ -280,17 +284,14 @@

Appendix D - Known bugs

Appendix X - MPlayer skin format

- - -

-Developer Cries -

- -

@@ -422,7 +423,7 @@

You need a fairly recent system. On Linux, 2.4.x kernels are recommended.

SOFTWARE REQUIREMENTS

Software requirements:

binutils - suggested version is 2.11.x . This program is @@ -462,7 +463,7 @@
libvorbis - optional, needed for playing OGG Vorbis audio.

CODECS

Codecs:

libavcodec: This codec package is capable of decoding @@ -533,7 +534,7 @@ installation instructions and more information.

VIDEO CARDS

Video Cards

There are generally two kind of video cards. One kind (the newer cards) has hardware scaling and YUV acceleration support, the other cards don't.

@@ -647,7 +648,7 @@ -

SOUND CARDS

Sound cards:

Soundblaster Live!: with this card you can use 4 or 6 (5.1) @@ -662,7 +663,7 @@ section!

FEATURES

Features:

Decide if you need GUI. If you do, see the GUI section @@ -768,8 +769,9 @@ The command line options differ slightly for the different formats: -

VobSub subtitles
- VobSub subtitles consist of a big (some megabytes) .SUB file, and optional +

VobSub subtitles

+ +

VobSub subtitles consist of a big (some megabytes) .SUB file, and optional .IDX and/or .IFO files.
Usage: if you have files like sample.sub, sample.ifo, sample.idx - you have to pass the @@ -778,18 +780,25 @@ -vobsubid option is like -sid for DVDs, you can choose between subtitle tracks (languages) with it.

Other subtitles
- The other formats consist of a single text file containing timing, placement - and text information.
+

Other subtitles

+ +

The other formats consist of a single text file containing timing, + placement and text information.
Usage: if you have a file like sample.txt, you have to pass the option -sub sample.txt (optionally with pathname, of course).

Adjusting subtitle timing and placement
- -subdelay <sec>: Delays subtitles by <sec> seconds. - Can be negative.
- -subfps <rate>: Specify frame/sec rate of subtitle file - (float number)
- -subpos <0 - 100>: Specify the position of subtitles.

Adjusting subtitle timing and placement:

+ +

-subdelay <sec>: Delays subtitles by <sec> seconds. Can be negative.
-subfps <rate>: Specify frame/sec rate of subtitle file (float number)
-subpos <0 - 100>: Specify the position of subtitles.

If you experience a growing delay between the movie and the subtitles when using a MicroDVD subtitle file, most likely the frame rate of the movie and @@ -803,6 +812,9 @@

About DVD subtitles, read the DVD section.

+ +

1.4.1 MPlayer's own subtitle format (MPsub)

MPlayer introduces a new subtitle format called MPsub. It was designed by me (Gabucino). Basically its main feature is being dynamically time-based (although it has frame-based mode too). Example @@ -833,7 +845,7 @@ Display. OSD is used to display current time, volume bar, seek bar etc.

INSTALLING OSD and SUB

1.4.2 Installing OSD and subtitles

You need an MPlayer font package to be able to use OSD/SUB feature. There are many ways to get it:

@@ -958,105 +970,71 @@

2.5.1 Compilation

First, you have to recompile. ./configure will autodetect kernel headers of v4l stuff and the existence of /dev/video* entries. If they exist, TV support will be built (see the output of ./configure).
Make sure your tuner works with another TV software in Linux, for example xawtv.

- -

Hint: Are the colors messed up? Then your tuner cannot display + + +

+ Hint
+ Are the colors messed up? Then your tuner cannot display in YV12 colorspace. Try I420 (-vc rawi420) or YUY2, UYVY, RGB32 (-vo sdl) colorspaces. - You can specify these with the outfmt=YV12 option, see below.
+ You can specify these with the outfmt=YV12 option, see below. +

2.5.2 Available options

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

	`on`		Use TV input.
	`noaudio`		No sound, thanks.
	`driver`		dummy - NULL TV input :) Used for testing only, generates dummy + + `on` + Use TV input. + + `noaudio` + No sound, thanks. + + `driver` + dummy - NULL TV input :) Used for testing only, generates dummy input. v4l - Captures images from standard V4L interface (default - `/dev/video0`).
	`device`		Specify a device other than the default `/dev/video0`.
	`input`		Specify from which input of the TV tuner you wish to grab + `/dev/video0`). + + `device` + Specify a device other than the default `/dev/video0`. + + `input` + Specify from which input of the TV tuner you wish to grab (e.g. television, s-video, composite, ...) - Prints the available ones during init.
	`freq`		Specify the frequency to set the tuner to (e.g. 511.250).
	`outfmt`		Specify the output format the tuner should use to transport images to us + Prints the available ones during init. + + `freq` + Specify the frequency to set the tuner to (e.g. 511.250). + + `outfmt` + Specify the output format the tuner should use to transport images to us (rgb32, rgb24, yv12, uyvy, i420 (for i420 you have to pass the `-vc rawi420` option, because of a fourcc - conflict)).
	`width`		width of the output window in pixels
	`height`		height of the output window in pixels
	`norm`		available: PAL, SECAM, NTSC
	`channel`		Set the tuner to the given channel.
	`chanlist`		available: `us-bcast, us-cable, europe-west, europe-east, etc`

+ conflict)). + +

width

width of the output window in pixels

+ +

height

height of the output window in pixels

+ +

norm

available: PAL, SECAM, NTSC

+ +

channel

Set the tuner to the given channel.

+ +

chanlist

available: us-bcast, us-cable, europe-west, europe-east, etc

2.5.3 Keyboard control

@@ -1353,7 +1331,7 @@

3.2.1 Default controls

Keyboard

Keyboard controls from terminal:

@@ -1377,7 +1355,7 @@

	<- or ->		seek backward/forward 10 seconds
	7 or 8		adjust saturation

GUI

GUI keyboard controls:

@@ -1394,7 +1372,7 @@

	, and .		previous / next file
	m		toggle mute

TV

Keyboard controls for TV input:

@@ -1434,7 +1412,7 @@

You can have a full list by running mplayer -input keylist

Keyboard

Keyboard:

Any printable character
DOWN

Mouse

- -

Note: mouse is only supported under X

Mouse (only supported under X):

MOUSE_BTN0 (Left button)
MOUSE_BTN9

Joystick

- -

Note: joystick support must be enabled at compile time

Joystick (support must be enabled at compile time):

JOY_RIGHT or JOY_AXIS0_PLUS
JOY_DOWN or JOY_AXIS1_PLUS
JOY_AXIS2_PLUS
JOY_AXIS2_MINUS
....
...
JOY_AXIS9_PLUS
JOY_AXIS9_MINUS

diff -r 37b0958a1cad -r 0b70f3dc34eb DOCS/encoding.html --- a/DOCS/encoding.html Tue Aug 27 16:17:54 2002 +0000 +++ b/DOCS/encoding.html Tue Aug 27 18:06:07 2002 +0000 @@ -114,36 +114,30 @@ estimation of recommended video bitrate in order to fit on a CD. Also, the audio is encoded only once, unlike in 2-pass mode. The schematics:

h or l

select previous/next channel

- - - - - - - - - - - - - - - - -

`rm frameno.avi`	remove conflicting temporary file
`mencoder <file/DVD> -ovc frameno -o - frameno.avi`	First pass: an audio-only avi file will be created, containing - ONLY the requested audio stream. Don't forget `-lameopts`, if - you need to set it. If you were encoding a long movie, MEncoder prints - the recommended bitrate values for 650Mb, 700Mb, and 800Mb destination - sizes, after this pass finishes.
`mencoder <file/DVD> -oac copy -pass 1 - -ovc divx4 -divx4opts br=<bitrate>`	Second pass: alias the first pass of DivX4 video encoding. - Optionally specify the video bitrate MEncoder printed at the end of the - previous pass.
`mencoder <file/DVD> -oac copy -pass 2 - -ovc divx4 -divx4opts br=<bitrate>`	Third pass: alias the second pass of DivX4 video encoding. - Optionally specify the video bitrate MEncoder printed at the end of the - previous pass. In this pass, audio from `frameno.avi` will be - inserted into the destination file.. and it's all ready!

Remove conflicting temporary file: +
rm frameno.avi
First pass: +
mencoder <file/DVD> -ovc frameno -o frameno.avi
+
An audio-only avi file will be created, containing + only the requested audio stream. Don't forget -lameopts, + if you need to set it. If you were encoding a long movie, MEncoder + prints the recommended bitrate values for 650Mb, 700Mb, and 800Mb + destination sizes, after this pass finishes.
Second pass: +
mencoder <file/DVD> -oac copy -pass 1 + -ovc divx4 -divx4opts br=<bitrate>
+
Alias the first pass of DivX4 video encoding. + Optionally specify the video bitrate MEncoder printed at the end of + the previous pass.
Third pass: +
mencoder <file/DVD> -oac copy -pass 2 + -ovc divx4 -divx4opts br=<bitrate>
+
Alias the second pass of DivX4 video encoding. + Optionally specify the video bitrate MEncoder printed at the end of + the previous pass. In this pass, audio from frameno.avi will + be inserted into the destination file.. and it's all ready!

Example for 3-pass encoding:

@@ -264,15 +258,17 @@ files. With simple framecopy it can create MJPEG (Motion JPEG) or MPNG (Motion PNG) files.

Explanation of the process

+Explanation of the process: -

MEncoder decodes the input image(s) with libjpeg - (when decoding PNGs, it will use libpng).

MEncoder decodes the input image(s) with libjpeg + (when decoding PNGs, it will use libpng).

MEncoder then feeds the decoded image to the chosen video compressor - (DivX4, Xvid, ffmpeg msmpeg4, etc...). Watch for the PNG decoder, as - currently it can output only to RGB formats, thus can't be used with codecs - that require YUV as input, like DivX4 or ffmpeg's msmpeg4.

MEncoder then feeds the decoded image to the chosen video compressor + (DivX4, Xvid, ffmpeg msmpeg4, etc...). Watch for the PNG decoder, as + currently it can output only to RGB formats, thus can't be used with codecs + that require YUV as input, like DivX4 or ffmpeg's msmpeg4.

Examples

diff -r 37b0958a1cad -r 0b70f3dc34eb DOCS/sound.html --- a/DOCS/sound.html Tue Aug 27 16:17:54 2002 +0000 +++ b/DOCS/sound.html Tue Aug 27 18:06:07 2002 +0000 @@ -119,20 +119,21 @@ Driver:ftp://ftp.infradead.org/pub/pcsp -

On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.
If sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g. - hdparm -u1 /dev/cdrom (man hdparm). This is - generally beneficial and described more detailed in the CD-ROM section.
Sharing your sound card with another application like XMMS is strongly - discouraged! If the other sound application is using ESD, start - MPlayer with the -vo sdl:esd option to combine both - sound streams. In fact, the option -vo sdl:esd could be used - with ESD even when playing Mplayer alone.
Feedback to this document is welcome. Please tell us how MPlayer - and your sound card(s) worked together.

On Linux, a 2.4.x kernel is highly recommended. Kernel 2.2 is not tested.

+ +

If sound clicks when playing from CD-ROM, turn on IRQ unmasking, e.g. + hdparm -u1 /dev/cdrom (man hdparm). This is + generally beneficial and described more detailed in the CD-ROM section.

+ +

Sharing your sound card with another application like XMMS is strongly + discouraged! If the other sound application is using ESD, start + MPlayer with the -vo sdl:esd option to combine both + sound streams. In fact, the option -vo sdl:esd could be used + with ESD even when playing Mplayer alone.

+ +

Feedback to this document is welcome. Please tell us how MPlayer + and your sound card(s) worked together.

2.3.2.2 Audio plugins

diff -r 37b0958a1cad -r 0b70f3dc34eb DOCS/users_against_developers.html --- a/DOCS/users_against_developers.html Tue Aug 27 16:17:54 2002 +0000 +++ b/DOCS/users_against_developers.html Tue Aug 27 18:06:07 2002 +0000 @@ -2,7 +2,7 @@ - Flame Wars - MPlayer - The Movie Player for Linux + Developer Cries - MPlayer - The Movie Player for Linux @@ -10,14 +10,14 @@ -

In medias res

Appendix F - Developer Cries

There are two major topics which always cause huge dispute and flame on the mplayer-users mailing list. Number one is the topic of the

GCC 2.96 series

GCC 2.96

The background: The GCC 2.95 series is an official GNU release and version 2.95.3 of GCC is the most bug-free in that series. @@ -74,7 +74,7 @@ use 3.1 instead of 2.96. If you do not want to or cannot use the binary packages, here is how you can compile GCC 3.1 from source:

Go to the GCC mirrors page page and download gcc-core-3.1.tar.gz. This includes the complete C compiler and is sufficient for MPlayer. If you also want @@ -94,10 +94,10 @@ make bootstrap
Now you can install GCC (as root) by typing
make install

+ -

Binary distribution of MPlayer

Binary distribution

This was the second big problem but has been solved as of version 0.90-pre1. MPlayer previously contained source from the OpenDivX project, diff -r 37b0958a1cad -r 0b70f3dc34eb DOCS/video.html --- a/DOCS/video.html Tue Aug 27 16:17:54 2002 +0000 +++ b/DOCS/video.html Tue Aug 27 18:06:07 2002 +0000 @@ -40,7 +40,7 @@ 01:00.0 VGA compatible controller: Matrox Graphics, Inc.: Unknown device 0525 Memory at d8000000 (32-bit, prefetchable)

from mga_vid kernel driver messages (use dmesg): +
from mga_vid kernel driver messages (use dmesgmga_mem_base = d8000000


 
@@ -462,24 +462,29 @@
 SDL video output supports displaying subtitles under the movie, on the (if
   present) black bar.
 
-Here are some notes about SDL out in MPlayer.
+There are several command line switches for SDL:
+
+  -vo sdl:name
+  specifies sdl video driver to use (i.e.. aalib, dga, x11)
+
+  -ao sdl:name
+  specifies sdl audio driver to use (i.e. dsp, esd, arts)
+
+  -noxv
+  disables XVideo hardware acceleration
+
+  -forcexv
+  tries to force XVideo acceleration
+
 
 
-  
-  
-  
-  
-  
-
   There are several command line switches for SDL:
   -vo sdl:name    
-  specifies sdl video driver to use (i.e.. aalib, dga, x11)
-ao sdl:name specifies sdl audio driver to use (i.e.. dsp,
-  esd, arts)
-noxv disables XVideo hardware acceleration
-forcexv tries to force XVideo acceleration
SDL Keys:
   F toggles fullscreen/windowed mode
   C cycles available fullscreen modes
   W/S mappings for * and / (mixer control)
 
 
-KNOWN BUGS:
+Known bugs:
 
 
   Keys pressed under sdl:aalib console driver repeat forever. (use -vo aa!)
@@ -537,15 +542,21 @@
 
 The FBdev output takes some additional parameters above the others:
 
-
-  
-  
-  
-  
-  
-  
-   -fb    
-    specify the framebuffer device to use (/dev/fb0)
-fbmode mode name to use (according to /etc/fb.modes)
-fbmodeconfig 	config file of modes (default /etc/fb.modes)
-monitor_hfreq IMPORTANT values, see example.conf
-monitor_vfreq 
-monitor_dotclock 
+
+  -fb
+  specify the framebuffer device to use (/dev/fb0)
+
+  -fbmode
+  mode name to use (according to /etc/fb.modes)
+
+  -fbmodeconfig
+  config file of modes (default /etc/fb.modes)
+
+  -monitor_hfreq
+  -monitor_vfreq
+  -monitor_dotclock
+  Important values, see example.conf
+
 
 If you want to change to a specific mode, then use
 
@@ -580,40 +591,31 @@
 WARNING: on non-Linux systems, use VIDIX for
   mga_vid!
 
-To use it, you first have to compile mga_vid.o:
-
-    cd drivers

-      make
-
-Then create /dev/mga_vid device:
-
-    mknod /dev/mga_vid c 178 0
-
-and load the driver with
-
-    insmod mga_vid.o
-
-You should verify the memory size detection using the 'dmesg' command. If
-  it's bad, use the mga_ram_size option (rmmod mga_vid first), specify card's
-  memory size in MB:
-
-    insmod mga_vid.o mga_ram_size=16
-
-To make it load/unload automatically when needed, first insert the following line
-  at the end of /etc/modules.conf:
-
-    alias char-major-178 mga_vid
-
-Then copy the mga_vid.o module to the appropriate place under
-  /lib/modules/<kernel version>/somewhere.
-
-Then run
-
-    depmod -a
-
-Now you have to (re)compile MPlayer, ./configure will detect /dev/mga_vid
-  and build the 'mga' driver. Using it from MPlayer goes by '-vo mga' if
-  you have matroxfb console, or '-vo xmga' under XFree86 3.x.x or 4.x.x.
+Installation:
+
+  To use it, you first have to compile mga_vid.o:
+    cd drivers

+      make
+  Then create the /dev/mga_vid device:
+    mknod /dev/mga_vid c 178 0
+    and load the driver with
+    insmod mga_vid.o
+  You should verify the memory size detection using the dmesg
+    command. If it's bad, use the mga_ram_size option
+    (rmmod mga_vid first), specify card's memory size in MB:
+    insmod mga_vid.o mga_ram_size=16
+  To make it load/unload automatically when needed, first insert the
+    following line at the end of /etc/modules.conf:
+    alias char-major-178 mga_vid
+    Then copy the mga_vid.o module to the appropriate place
+      under /lib/modules/<kernel version>/somewhere.
+    Then run
+    depmod -a
+  Now you have to (re)compile MPlayer, configure will
+    detect /dev/mga_vid and build the 'mga' driver. Using it from
+    MPlayer goes by -vo mga if you have matroxfb console,
+    or -vo xmga under XFree86 3.x.x or 4.x.x.
+
 
 The mga_vid driver cooperates with Xv.
 
@@ -674,19 +676,34 @@
   6set dithering mode (none, error distribution, Floyd Steinberg)
   7invert image
   atoggles between aa and MPlayer control)
+
 
-  The following command line options can be used:
-  -aaosdcolor=Vchange OSD color
-  -aasubcolor=Vchange subtitle color
-  where V can be: (0/normal, 1/dark, 2/bold,
-   3/bold font, 4/reverse, 5/special)
-  AAlib itself provides a large sum of options.
-    Here are some important:
-  -aadriverset recommended aa driver (X11, curses, Linux)
-  -aaextendeduse all 256 characters
-  -aaeightuse eight bit ASCII
-  -aahelpprints out all aalib options
-
+The following command line options can be used:
+
+  -aaosdcolor=V
+  change OSD color
+  
+  -aasubcolor=V
+  change subtitle color
+    where V can be: (0/normal, 1/dark, 2/bold, 3/bold font, 4/reverse,
+    5/special)
+
+
+AAlib itself provides a large sum of options.
+    Here are some important:
+
+  -aadriver
+  set recommended aa driver (X11, curses, Linux)
+
+  -aaextended
+  use all 256 characters
+
+  -aaeight
+  use eight bit ASCII
+
+  -aahelp
+  prints out all aalib options
+
 
 NOTE: the rendering is very CPU intensive, especially when using AA-on-X
   (using aalib on X), and it's least CPU intensive on standard,
@@ -759,22 +776,33 @@
 
 
Don't use this driver with GCC 2.96! It won't work!
 
-
-  
-  
-    
-  
-  
-  
-  
-  
-  
-These switches of command line currently are available for VESA:
   -vo vesa:opts currently recognized: dga to force dga mode and nodga to
+Command line options available for VESA:
+
+  -vo vesa:opts
+  currently recognized: dga to force dga mode and nodga to
     disable dga mode. Note: you may omit these parameters to enable autodetect
     of dga mode. (In the future also will specify mode parameters such as refresh
-    rate, interlacing, doublescan and so on. Samples: i43, 85, d100)
-screenw, -screenh, -bpp force userdefined mode
-x, -y set userdefined prescaling
-zoom enables userdefined prescaling
-fs scales image to fullscreen
-fs -zoom scales userdefined prescaling to fullscreen
-double enables
-    double buffering mode. (Available only in DGA mode). Should be slower of
-    single buffering, but has no flickering effects.
+    rate, interlacing, doublescan and so on. Samples: i43, 85, d100)
+
+  -screenw, -screenh, -bpp
+  force userdefined mode
+
+  -x, -y
+  set userdefined prescaling
+
+  -zoom
+  enables userdefined prescaling
+
+  -fs
+  scales image to fullscreen
+
+  -fs -zoom
+  scales userdefined prescaling to fullscreen
+
+  -double
+  enables double buffering mode. (Available only in DGA mode). Should be
+    slower of single buffering, but has no flickering effects.
+
 
 Known problems and workaround:
 
@@ -830,8 +858,6 @@
 
 2.3.1.14 VIDIX
 
-WHAT IS VIDIX?
-
 VIDIX is the abbreviation for VIDeo Interface for
   *niX.

   VIDIX was designed and introduced as an interface for fast user-space drivers
@@ -920,27 +946,33 @@
   by command line arguments. MPlayer recognizes the
   following options:
 
-
-  
-    
-  
-    
-  
-    
-  
-    
-  
-    
-  
-    
-  
-    
-   -brightness    Adjust BRIGHTNESS of video output. It's not equal to brightness
+
+  -brightness
+  Adjust BRIGHTNESS of video output. It's not equal to brightness
     adjusting on monitor panel or on TV. It changes intensity of RGB components of
-    video signal from black to white screen.
-contrast Adjust CONTRAST of video output. Works in similar manner as
-    brightness.
-saturation Adjust SATURATION of video output.  You can get grayscale
-    output with this option.
-hue Adjust HUE of video signal.  You can get colored negative
-    of image with this option.
-red_intensity Adjust intensity of RED component of video signal.
-green_intensity Adjust intensity of GREEN component of video signal.
-blue_intensity Adjust intensity of BLUE component of video signal.
+    video signal from black to white screen.
+
+  -contrast
+  Adjust CONTRAST of video output. Works in similar manner as
+    brightness.
+
+  -saturation
+  Adjust SATURATION of video output.  You can get grayscale
+    output with this option.
+
+  -hue
+  Adjust HUE of video signal.  You can get colored negative
+    of image with this option.
+
+  -red_intensity
+  Adjust intensity of RED component of video signal.
+
+  -green_intensity
+  Adjust intensity of GREEN component of video signal.
+
+  -blue_intensity
+  Adjust intensity of BLUE component of video signal.
+
 
 Each parameter can accept values from -1000 to +1000.

   Default value for each parameter is 0.
@@ -1104,11 +1136,10 @@
   Linux site. Configure should detect your card automatically, compilation
   should go without any problems.
 
-USAGE
-
-
-  
-    
-  
-    
-  
-    
-  
-    
-  
-    
-   -vo dxr3:<noprebuf>:<codec>:<device>    Where <noprebuf> specifies turning off prebuffering.
+Usage:
+
+  -vo dxr3:<noprebuf>:<codec>:<device>
+  Where <noprebuf> specifies turning off prebuffering.
     This is done automatically on Athlons. If playback is out of sync try
     disabling prebuffering. If noprebuf is left out prebuffering is enabled
     (except on Athlons).
@@ -1123,21 +1154,25 @@
     

     Any of these options may be left out, but they must be specified in this
     order, i.e. dxr3:fame works, dxr3:1 works, but
-    dxr3:1:avcodec will not.
-ao oss:/dev/em8300_ma-X For audio output, where X is the device number
-    (0 if one card).
-ac hwac3 For digital instead of analog audio output.
-vc mpegpes Force hardware acceleration, only works with MPEG1/2.
-aop list=resample:fout=xxxxx If sample rate is below 44100Hz, select either 44100Hz or 48000Hz
+    dxr3:1:avcodec will not.
+
+  -ao oss:/dev/em8300_ma-X
+  For audio output, where X is the device number
+    (0 if one card).
+
+  -ac hwac3
+  For digital instead of analog audio output.
+
+  -vc mpegpes
+  Force hardware acceleration, only works with MPEG1/2.
+
+  -aop list=resample:fout=xxxxx
+  If sample rate is below 44100Hz, select either 44100Hz or 48000Hz
     depending on which one matches closest. I.e. if the movie uses 22050Hz use
     44100Hz as 44100 / 2 = 22050, if it is 24000Hz use 48000Hz as 48000 / 2 = 24000
     and so on. This does not work with digital audio output
-    (-ac hwac3).
+    (-ac hwac3).
+
 
 Overlay
 
@@ -1187,7 +1222,7 @@
     You have to enable ALL matroxfb-specific feature during compilation (except
     MultiHead), and compile them into modules! You'll also need I2C
     enabled.
-    
+    
       
 	Enter TVout/matroxset and type make. Install
         matroxset into somewhere in your PATH.
@@ -1206,7 +1241,7 @@
 	the TV (PAL) picture has some weird stripes on it, the script wasn't able to
 	set the resolution correctly (to 640x512 by default). Use other menu
 	items randomly and it'll be OK :)
-    
+    
 
     Yoh. Next task is to make the cursor on tty1 (or whatever) to disappear,
     and turn off screen blanking. Execute the following commands:

There are several command line switches for SDL:
	`-vo sdl:name`	- specifies sdl video driver to use (i.e.. aalib, dga, x11)
	`-ao sdl:name`	specifies sdl audio driver to use (i.e.. dsp, - esd, arts)
	`-noxv`	disables XVideo hardware acceleration
	`-forcexv`	tries to force XVideo acceleration
SDL Keys:
	`F`	toggles fullscreen/windowed mode
	`C`	cycles available fullscreen modes
	`W/S`	mappings for * and / (mixer control)

	`-fb`		- specify the framebuffer device to use (/dev/fb0)
	`-fbmode`		mode name to use (according to /etc/fb.modes)
	`-fbmodeconfig`		config file of modes (default /etc/fb.modes)
	`-monitor_hfreq`		IMPORTANT values, see example.conf
	`-monitor_vfreq`
	`-monitor_dotclock`

These switches of command line currently are available for VESA:
	`-vo vesa:opts`	currently recognized: dga to force dga mode and nodga to + Command line options available for VESA: + + `-vo vesa:opts` + currently recognized: dga to force dga mode and nodga to disable dga mode. Note: you may omit these parameters to enable autodetect of dga mode. (In the future also will specify mode parameters such as refresh - rate, interlacing, doublescan and so on. Samples: i43, 85, d100)
	`-screenw, -screenh, -bpp`	force userdefined mode
	`-x, -y`	set userdefined prescaling
	`-zoom`	enables userdefined prescaling
	`-fs`	scales image to fullscreen
	`-fs -zoom`	scales userdefined prescaling to fullscreen
	`-double`	enables - double buffering mode. (Available only in DGA mode). Should be slower of - single buffering, but has no flickering effects.

	`-brightness`		Adjust BRIGHTNESS of video output. It's not equal to brightness + + `-brightness` + Adjust BRIGHTNESS of video output. It's not equal to brightness adjusting on monitor panel or on TV. It changes intensity of RGB components of - video signal from black to white screen.
	`-contrast`		Adjust CONTRAST of video output. Works in similar manner as - brightness.
	`-saturation`		Adjust SATURATION of video output. You can get grayscale - output with this option.
	`-hue`		Adjust HUE of video signal. You can get colored negative - of image with this option.
	`-red_intensity`		Adjust intensity of RED component of video signal.
	`-green_intensity`		Adjust intensity of GREEN component of video signal.
	`-blue_intensity`		Adjust intensity of BLUE component of video signal.

	`-vo dxr3:<noprebuf>:<codec>:<device>`		Where `<noprebuf>` specifies turning off prebuffering. + Usage: + + `-vo dxr3:<noprebuf>:<codec>:<device>` + Where `<noprebuf>` specifies turning off prebuffering. This is done automatically on Athlons. If playback is out of sync try disabling prebuffering. If noprebuf is left out prebuffering is enabled (except on Athlons). @@ -1123,21 +1154,25 @@ Any of these options may be left out, but they must be specified in this order, i.e. `dxr3:fame` works, `dxr3:1` works, but - `dxr3:1:avcodec` will not.
	`-ao oss:/dev/em8300_ma-X`		For audio output, where `X` is the device number - (0 if one card).
	`-ac hwac3`		For digital instead of analog audio output.
	`-vc mpegpes`		Force hardware acceleration, only works with MPEG1/2.
	`-aop list=resample:fout=xxxxx`		If sample rate is below 44100Hz, select either 44100Hz or 48000Hz + `dxr3:1:avcodec` will not. + + `-ao oss:/dev/em8300_ma-X` + For audio output, where `X` is the device number + (0 if one card). + + `-ac hwac3` + For digital instead of analog audio output. + + `-vc mpegpes` + Force hardware acceleration, only works with MPEG1/2. + + `-aop list=resample:fout=xxxxx` + If sample rate is below 44100Hz, select either 44100Hz or 48000Hz depending on which one matches closest. I.e. if the movie uses 22050Hz use 44100Hz as 44100 / 2 = 22050, if it is 24000Hz use 48000Hz as 48000 / 2 = 24000 and so on. This does not work with digital audio output - (`-ac hwac3`).

	`-vc odivx`		Uses the codec in OpenDivX fashion. In this case it + + `-vc odivx` + Uses the codec in OpenDivX fashion. In this case it produces YV12 images in its own buffer, and MPlayer does colorspace - conversion via libvo. (Fast, recommended!)
	`-vc divx4`		Uses the colorspace conversion of the codec. - In this mode you can use YUY2/UYVY, too. (SLOW)