[MPlayer-dev-eng] [PATCH] zr, man page + manual update

rsnel at cube.dyndns.org rsnel at cube.dyndns.org
Fri Aug 30 21:05:40 CEST 2002


Hello Diego,

Here is the updated version of my manual update. The option descriptions
are moved to the man page, some typos have been corrected (and introduced)
and I added some text about the performance of the driver on my own system
(AMD K6-2 350MHz).

Greetings,

Rik.

-- 
Nothing is ever a total loss; it can always serve as a bad example.
-------------- next part --------------
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/mplayer.1,v
retrieving revision 1.218
diff -u -r1.218 mplayer.1
--- mplayer.1	30 Aug 2002 11:37:41 -0000	1.218
+++ mplayer.1	30 Aug 2002 19:15:10 -0000
@@ -1077,9 +1077,60 @@
     9  max compression
 .TP
 .B \-zr* (\-vo zr only)
-You can get a list and an explanation of available options executing
-.I mplayer \-zrhelp
+All the options that start with \-zr are specific to the zr video output
+driver.
 
+.TP
+.B \-zrxdoff <x display offset>, \-zrydoff <y display offset>
+If the movie is smaller than the tv screen, these options control the position
+of the movie relative to the upper left corner of the screen, the movie
+is centered by default.
+
+.TP
+.B \-zrvdec 1,2,4 , \-zrhdec 1,2,4
+Vertical/horizontal decimation: ask the driver to send only every 2nd or 4th
+line/pixel of the input image to the MJPEG card and use the scaler of the
+MJPEG card to strech the image to its original size.
+
+.TP
+.B \-zrfd
+Force decimation: decimation, as specified by -zrhdec and -zrvdec, only happens
+if the hardware scaler can stretch the image to its original size, use this
+option to force decimation.
+
+.TP
+.B \-zrbw
+Display in black and white (for optimal performance, this option can be
+combined with the 'decode only in black and white' option to codecs
+belonging the the ffmpeg family).
+
+.TP
+.B \-zrquality <1\-20>
+A number from 1 to 20 representing the jpeg encoding quality, 1 gives the best
+quality and 20 gives very bad quality.
+
+.TP
+.B \-zrdev <device>
+Specify the device special file that belongs to your MJPEG card, by default
+this driver takes the first v4l device it can find.
+
+.TP
+.B \-zrnorm PAL|NTSC
+Specify norm PAL/NTSC, the default is 'no change'.
+
+.TP
+.B \-zrhelp
+Display a list of all -zr* options, their default values and an example of
+cinerama mode.
+
+.TP
+.B \-zrcrop <width>x<height>+<x offset>+<y offset>
+Select a part of the input image for display, multiple occurances of this
+option switch on cinerama mode, in cinerama mode the movie is distributed
+over more than one tv (or beamer) to create a larger screen. Options appearing
+after the n-th -zrcrop apply to the n-th MJPEG card, each card should at least
+have a -zrdev in addition to the -zrcrop. For examples, see the output of
+-zrhelp and the manual.
 
 .SH "PLAYER OPTIONS (MPLAYER ONLY)"
 .TP
Index: video.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/video.html,v
retrieving revision 1.96
diff -u -r1.96 video.html
--- video.html	29 Aug 2002 13:04:01 -0000	1.96
+++ video.html	30 Aug 2002 19:15:19 -0000
@@ -993,34 +993,85 @@
 
 <P>This is a display-driver (<CODE>-vo zr</CODE>) for a number of MJPEG
   capture/playback cards (tested for DC10+ and Buz, and it should work for the
-  LML33, the DC10). The driver works by encoding the frame to jpeg and then
-  sending it to the card. For the jpeg encoding <B>libavcodec</B> is
-  used, and required.</P>
+  LML33 and the original DC10). The driver works by encoding the frame to jpeg 
+  and then sending it to the card. For the jpeg encoding <B>libavcodec</B> is
+  used, and required. With the special <I>cinerama</I> mode, you can watch
+  movies in true wide screen provided that you have two beamers and two
+  MJPEG cards. Depending on resolution and quality settings, this driver
+  may require a lot of CPU power, remember to specify <CODE>-framedrop</CODE>
+  if your machine is too slow. Note: my AMD K6-2 350MHz is (with <CODE>
+  -framedrop</CODE>) quite adequate for watching VCD sized material and
+  downscaled movies.
 
 <P>This driver talks to the kernel driver available at
   <A HREF="http://mjpeg.sourceforge.net">http://mjpeg.sourceforge.net</A>, so
-  you must get it working first. Then recompile <B>MPlayer</B> with
-  <CODE>--enable-zr</CODE>.</P>
+  you must get it working first. The presence of an MJPEG card is autodetected
+  by the configure script, if autodetection fails, force detection with
 
-Some remarks:
-<UL>
-  <LI>don't start or stop XawTV on the playback device during playback, 
-    it will crash your computer. It is, however, fine to <B>FIRST</B> start 
-    XawTV, <B>THEN</B> start <B>MPlayer</B>, wait for <B>MPlayer</B> to finish 
-    and <B>THEN</B> stop XawTV.</LI>
-  <LI>this driver adds <CODE>-zr*</CODE> command line options. The explanation
-    of these options can be viewed with <CODE>-zrhelp</CODE>. It is possible to
-    crop the input frame (cut borders to make it fit or to enhance performance)
-    and to do other things.</LI>
-  <LI>the driver takes data in YV12 and YUY2 format, this means that some 
-    codecs won't work. Some old VfW (Video for Windows) codecs, for example,
-    are incompatible with this driver. The error message that you will see is: 
-    <CODE>Sorry, selected video_out device is incompatible with this codec.
-    </CODE></LI>
-  <LI>OSD is currently not supported, so you won't see
-    subtitles.</LI>
-</UL>
+<PRE>
+  ./configure --enable-zr
+</PRE>
 
+<P>The output can be controlled by several options, a long description of the
+  options can be found in the man page, a short list of options can be
+  viewed by running
+
+<PRE>
+  mplayer -zrhelp
+</PRE>
+
+<P>Things like scaling and the OSD (on screen display) are not handled by
+  this driver but can be done using the video filters. For example, 
+  suppose that you have a movie with a resolution of <CODE>512x272</CODE> and
+  you want to view it fullscreen on your DC10+. There are three main
+  possibilities, you may scale the movie to a width of <CODE>768</CODE>,
+  <CODE>384</CODE> or <CODE>192</CODE>. For performance and quality reasons,
+  I would choose to scale the movie to <CODE>384x204</CODE> using the fast
+  bilinear software scaler. The commandline is
+
+<PRE>
+  mplayer -vo zr -sws 0 -vop scale=384:204 movie.avi
+</PRE>
+
+<P>Cropping can be done by the <CODE>crop</CODE> filter and by
+  this driver itself. Suppose that a movie is too wide for display on your
+  Buz and that you want to use <CODE>-zrcrop</CODE> to make the movie less
+  wide, the you would issue the following command
+
+<PRE>
+  mplayer -vo zr -zrcrop 720x320+80+0 benhur.avi
+</PRE>
+
+  if you want to use the <CODE>crop</CODE> filter, you would do
+
+<PRE>
+  mplayer -vo zr -vop crop=720:320:80:0 benhur.avi
+</PRE>
+
+<P>Extra occurances of <CODE>-zrcrop</CODE> invoke <I>cinerama</I> mode, i.e.
+  you can distribute the movie over several tv's or beamers to create a larger
+  screen. Suppose you have two beamers. The left one is connected to your Buz
+  at <CODE>/dev/video1</CODE> and the right one is connected to your DC10+ at
+  <CODE>/dev/video0</CODE>. The movie has a resolution of <CODE>704x288</CODE>.
+  Suppose also that you want the right beamer in black and white and that
+  the right beamer should have jpeg frames at quality <CODE>10</CODE>,
+  then you would issue the following command
+
+<PRE>
+  mplayer -vo zr -zrdev /dev/video0 -zrcrop 352x288+352+0 -zrxdoff 0 -zrbw \
+          -zrcrop 352x288+0+0 -zrdev /dev/video1 -zrquality 10 movie.avi
+</PRE>
+
+<P>You see that the options appearing before the second <CODE>-zrcrop</CODE>
+  only apply to the DC10+ and that the options after the second 
+  <CODE>-zrcrop</CODE> apply to the Buz. The maximum number of MJPEG cards
+  participating in <I>cinerama</I> is four, so you can buid a <CODE>2x2</CODE>
+  vidiwall.</P>
+
+<P>Finally an important remark: don't start or stop XawTV on the playback
+  device during playback, it will crash your computer. It is, however, fine to
+  <B>FIRST</B> start XawTV, <B>THEN</B> start <B>MPlayer</B>, wait for
+  <B>MPlayer</B> to finish and <B>THEN</B> stop XawTV.</P>
 
 <H4><A NAME="dvb">2.3.1.16 DVB</A></H4>
 


More information about the MPlayer-dev-eng mailing list