[MPlayer-DOCS] CVS: main/DOCS/man/en mplayer.1,1.715,1.716
Daniele Forghieri CVS
syncmail at mplayerhq.hu
Sun Sep 12 20:42:05 CEST 2004
CVS change done by Daniele Forghieri CVS
Update of /cvsroot/mplayer/main/DOCS/man/en
In directory mail:/var2/tmp/cvs-serv32633
Modified Files:
mplayer.1
Log Message:
All video driver suboptions documented, gif and tga examples
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v
retrieving revision 1.715
retrieving revision 1.716
diff -u -r1.715 -r1.716
--- mplayer.1 12 Sep 2004 16:42:26 -0000 1.715
+++ mplayer.1 12 Sep 2004 18:42:02 -0000 1.716
@@ -2273,10 +2273,6 @@
.RE
.PD 1
.sp 1
-FIXME: Document suboptions for x11, xover, dga, sdl, vidix, xvidix, fbdev,
-fbdev2, vesa, aa, bl, ggi, mga, xmga, syncfb, 3dfx, tdfx_vid,
-tdfxfb, dxr2, dxr3, mpegpes, zr, zr2.
-.sp 1
Available video output drivers are:
.
.TP
@@ -2301,6 +2297,12 @@
.B xover (X11 only)
Adds X11 support to all overlay based video output drivers.
Currently only supported by tdfx_vid.
+.PD 0
+.RSs
+.IPs <vo_driver>
+Select the driver to use as source to overlay on top of X11.
+.RE
+.PD 1
.
.TP
.B xvmc (X11, \-vc ffmpeg12mc only)
@@ -2330,11 +2332,17 @@
Considered obsolete.
.
.TP
-.B sdl (SDL only)
+.B sdl (SDL only, also see \-forcexv, \-noxv)
Highly platform independent SDL (Simple Directmedia Layer) library
video output driver.
Since SDL uses its own X11 layer, MPlayer X11 options do not have
any effect on SDL.
+.PD 0
+.RSs
+.IPs <driver>
+Explicitly choose the SDL driver to use.
+.RE
+.PD 1
.
.TP
.B vidix\ \
@@ -2407,11 +2415,25 @@
.TP
.B fbdev (Linux only)
Uses the kernel framebuffer to play video.
+.PD 0
+.RSs
+.IPs <device>
+Explicitly choose the fbdev device name to use (e.g.\& /dev/\:fb0) or the
+name of the vidix subdevice if the device name start with vidix (e.g.\&
+vidixsis_vid to enable the sis driver).
+.RE
+.PD 1
.
.TP
.B fbdev2 (Linux only)
Uses the kernel framebuffer to play video,
alternative implementation.
+.PD 0
+.RSs
+.IPs <device>
+Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
+.RE
+.PD 1
.
.TP
.B vesa\ \ \
@@ -2423,10 +2445,14 @@
Turns on DGA mode.
.IPs nodga
Turns off DGA mode.
+.IPs neotv_pal
+Activate the neomagic's TV out and set it to PAL norm.
+.IPs neotv_ntsc
+Activate the neomagic's TV out and set it to NTSC norm.
.IPs vidix
-FIXME: document this
-.IPs lvo\ \
-FIXME: document this
+Use the VIDIX driver.
+.IPs lvo:\ \ \
+Activate the Linux Video Overlay on top of vesa mode.
.RE
.PD 1
.
@@ -2463,7 +2489,7 @@
Intended to work even with the most simple OpenGL implementations.
.PD 0
.RSs
-.IPs manyfmts
+.IPs (no)manyfmts
Enables support for more (RGB and BGR) color formats.
Needs OpenGL version >= 1.2, NOT yet WORKING correctly.
.IPs slice-height=<0\-...>
@@ -2481,10 +2507,9 @@
.B null\ \ \
Produces no video output.
Useful for benchmarking.
-Actually there are no suboptions available.
.
.TP
-.B aa\ \ \ \ \
+.B aa (also see \-aa*)
ASCII art video output driver that works on a text console.
.
.TP
@@ -2495,10 +2520,25 @@
.B bl\ \ \ \ \
Video playback using the Blinkenlights UDP protocol.
This driver is highly hardware specific.
+.PD 0
+.RSs
+.IPs <subdevice>
+Explicitly choose the Blinkenlights subdevice driver to use.
+It's something like arcade:host=localhost:2323 or
+hdl:file=name1,file=name2.
+You must specify a subdevice.
+.RE
+.PD 1
.
.TP
.B ggi\ \ \ \
GGI graphics system video output driver
+.PD 0
+.RSs
+.IPs <driver>
+Explicitly choose the GGI driver to use.
+.RE
+.PD 1
.
.TP
.B directfb
@@ -2570,10 +2610,22 @@
Matrox specific video output driver that makes use of the YUV back
end scaler on Gxxx cards through a kernel module.
If you have a Matrox card, this is the fastest option.
+.PD 0
+.RSs
+.IPs <device>
+Explicitly choose the matrox device name to use (default: /dev/\:mga_vid).
+.RE
+.PD 1
.
.TP
.B xmga (Linux, X11 only)
The mga video output driver, running in an X11 window.
+.PD 0
+.RSs
+.IPs <device>
+Explicitly choose the matrox device name to use (default: /dev/\:mga_vid).
+.RE
+.PD 1
.
.TP
.B syncfb\
@@ -2585,29 +2637,41 @@
.TP
.B 3dfx (Linux only)
3Dfx specific video output driver.
-FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
+This driver uses directly the 3dfx hardware on top of X11.
+Only 16 bpp are supported.
+FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
.
.TP
.B tdfxfb (Linux only)
This driver employs the tdfx framebuffer driver to play movies with
-YUV acceleration.
-FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
+YUV acceleration on 3Dfx cards.
+FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
+.PD 0
+.RSs
+.IPs <device>
+Explicitly choose the fbdev device name to use (default: /dev/\:fb0).
+.RE
+.PD 1
.
.TP
.B tdfx_vid (Linux only)
3Dfx specific video output driver.
-Works in conjunction with a kernel module.
-FIXME: What's the difference between 3dfx, tdfxfb and tdfx_vid?
+This driver use directly the tdfx_vid kernel module.
+FIXME: It' ok the difference between 3dfx, tdfxfb and tdfx_vid?
+.PD 0
+.RSs
+.IPs <device>
+Explicitly choose the device name to use (default: /dev/\:tdfx_vid).
+.RE
+.PD 1
.
.TP
.B dxr2 (also see \-dxr2) (DXR2 only)
Creative DXR2 specific video output driver.
.PD 0
.RSs
-.IPs x11
-Enables overlay.
-.IPs xv
-Enables overlay.
+.IPs <vo_driver>
+Output video sub driver to use as overlay (x11, xv).
.RE
.PD 1
.
@@ -2639,19 +2703,22 @@
.br
5: NTSC
.REss
-.IPs device=<number>
+.IPs 0\ 1\ 2\ 3\
Specifies the device number to use if you have more than one em8300 card.
.RE
.PD 1
.
.TP
.B mpegpes (DVB only)
-DVB specific video output driver.
+DVB specific video output driver or MPEG-PES format file writer.
.PD 0
.RSs
.IPs card=<1\-4>
Specifies the device number to use if you have more than one DVB output card
(V3 API only, such as 1.x.y series drivers).
+.IPs <filename>
+If you don't have a DVB card this video output driver writes a file in MPEG-PES
+format on the file you specify (default: ./grab.mpg).
.RE
.PD 1
.
@@ -2664,6 +2731,20 @@
Video output driver for a number of MJPEG capture/\:playback cards,
second generation.
Also see the zrmjpeg video filter.
+.PD 0
+.RSs
+.IPs dev=<device>
+Specifies the device to use.
+.IPs PAL\ \ \
+Activate pal video norm.
+.IPs SECAM
+Activate secam video norm.
+.IPs NTSC\ \ \
+Activate ntsc video norm.
+.IPs prebuf
+Activate prebuffering, not yet supported.
+.RE
+.PD 1
.
.TP
.B md5\ \ \ \
@@ -2694,7 +2775,7 @@
.REss
.PD 1
.RS
-.br
+.sp 1
.I NOTE:
If you don't specify any option the output is progressive
(i.e.\& not interlaced).
@@ -2707,18 +2788,25 @@
colors.
.PD 0
.RSs
-.IPs fps\ \ \
+.IPs <fps>\ \ \
Float value to specify framerate (default: 5.0).
-.IPs filename
+.IPs <filename>
Specify the output filename (default: ./out.gif).
.REss
.PD 1
.RS
-.br
+.sp 1
.I NOTE:
You must specify the framerate before the filename or the framerate will
be part of the filename.
+.sp 1
+.I EXAMPLE:
.RE
+.PD 0
+.RSs
+mplayer video.nut \-vo gif89a:15.0:test.gif
+.RE
+.PD 1
.
.TP
.B jpeg\ \ \
@@ -2763,13 +2851,10 @@
and at width/2,height for width/2,height/2 you have the V plane.
.
.TP
-.B png\ \ \ \
+.B png (also see \-z)
Output each frame into a PNG file in the current directory.
Each file takes the frame number padded with leading zeros as name.
24bpp RGB and BGR formats are supported.
-There are no suboptions available but you can specify the compression level
-with the \-z option, ranging from 0 (no compression) to 9 (maximum
-compression).
.
.TP
.B tga\ \ \ \
@@ -2778,14 +2863,13 @@
The purpose of this video output driver is to have a simple lossless
image writer to use without any external library.
It supports the BGR[A] color format, with 15, 24 and 32 bpp.
-There are no suboptions.
You can force a particular format with the format video filter.
.sp 1
.I EXAMPLE:
+.RE
.PD 0
.RSs
-.IPs "\-vf format=bgr15"
-Saves images with 2 bytes per pixel.
+mplayer video.nut \-vf format=bgr15 \-vo tga
.RE
.PD 1
.
More information about the MPlayer-DOCS
mailing list