comparison DOCS/en/video.html @ 9644:0fe056bdb135

vop -> vf change, small fixes. The Polish documentation should be checked for correctness.

9643:f1b66e97c3d3

</UL>

<P>The bpp (bits per pixel) value must be set to 4 by hand:<BR>
  &nbsp;&nbsp;<CODE>-bpp 4</CODE><BR>
  The movie probably must be scaled down to fit in EGA mode:<BR>
  &nbsp;&nbsp;<CODE>-vop scale=640:350</CODE> or<BR>
  &nbsp;&nbsp;<CODE>-vop scale=320:200</CODE><BR>
  For that we need fast but bad quality scaling routine:<BR>
  &nbsp;&nbsp;<CODE>-sws 4</CODE><BR>
  Maybe automatic aspect correction has to be shut off:<BR>
  &nbsp;&nbsp;<CODE>-noaspect</CODE></P>

<P><B>NOTE:</B> according to my experience the best image quality on EGA
  screens can be achieved by decreasing the brightness a bit: <CODE>-vop
  eq=-20:0</CODE>. I also needed to lower the audio samplerate on my box,
  because the sound was broken on 44kHz: <CODE>-srate 22050</CODE>.</P>

<P>You can turn on OSD and subtitles only with the <CODE>expand</CODE> filter,
  see the man page for exact parameters.</P>

<P>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,
  non-framebuffer console. Use SVGATextMode to set up a big textmode,
  then enjoy! (secondary head Hercules cards rock :)) (but imho you can use
  <CODE>-vop 1bpp</CODE> option to get graphics on hgafb:)</P>

<P>Use the <CODE>-framedrop</CODE> option if your computer isn't fast enough to
  render all frames!</P>

<P>Playing on terminal you'll get better speed and quality using the Linux

<P>Software decoding or transcoding different formats to MPEG1 can be achieved
  using a command like this:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes yourfile.ext
  mplayer -ao mpegpes -vo mpegpes -vop expand yourfile.ext
</PRE>

<P>Note that DVB cards only support heights 288 and 576 for PAL or 240 and 480
  for NTSC. You <B>must</B> rescale for other heights by adding
  <CODE>scale=width:height</CODE> with the width and height you want to the
  <CODE>-vop</CODE> option. DVB cards accept various widths, like 720, 704,
  640, 512, 480, 352 etc and do hardware scaling in horizontal direction, so
  you do not need to scale horizontally in most cases. For a 512x384 (aspect
  4:3) DivX try:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes -vop scale=512:576
</PRE>

<P>If you have a widescreen movie and you do not want to scale it to full height,
  you can use the <CODE>expand=w:h</CODE> filter to add black bands. To view a
  640x384 DivX, try:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes -vop expand=640:576 file.avi
</PRE>

<P>If your CPU is too slow for a full size 720x576 DivX, try downscaling:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes -vop scale=352:576 file.avi
</PRE>

<P>If speed does not improve, try vertical downscaling, too:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes -vop scale=352:288 file.avi
</PRE>

<P>For OSD and subtitles use the OSD feature of the expand filter. So, instead
  of <CODE>expand=w:h</CODE> or <CODE>expand=w:h:x:y</CODE>, use
  <CODE>expand=w:h:x:y:1</CODE> (the 5th parameter <CODE>:1</CODE> at the end

<P>To keep the aspect ratio of DivX files and get the optimal scaling parameters
  (hardware horizontal scaling and software vertical scaling while keeping the
  right aspect ratio), use the new dvbscale filter:</P>

<PRE>
for  3:4 TV: -vop expand=-1:576:-1:-1:1,scale=-1:0,dvbscale
for 16:9 TV: -vop expand=-1:576:-1:-1:1,scale=-1:0,dvbscale=1024
</PRE>

<H4>FUTURE</H4>

<P>If you have questions or want to hear feature announcements and take part in

    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 (<CODE>-ac hwac3</CODE>).</DD>

  <DT><CODE>-vop lavc/fame</CODE></DT>
  <DD><B>(AUTO-INSERTED)</B> To watch non-MPEG content on the em8300 (i.e. DivX or RealVideo) you have
    to specify an MPEG1 video filter such as libavcodec (lavc) or libfame
    (fame). At the moment lavc is both faster and gives better image quality, it
    is suggested that you use that unless you have problems with it. See the man
    page for further info about <CODE>-vop lavc/fame</CODE>.<BR>
    Using lavc is highly recommended. Currently there is no way of setting the
    fps of the em8300 which means that it is fixed to 29.97fps. Because of this
    it is highly recommended that you use <CODE>-vop lavc=&lt;quality&gt;:25</CODE>,
    especially if you are using prebuffering. Then why 25 and not 29.97? Well,
    the thing is that when you use 29.97 the picture becomes a bit jumpy. The
    reason for this is unknown to us. If you set it to somewhere between 25 and
    27 the picture becomes stable. For now all we can do is accept this for a
    fact.</DD>

  <DT><CODE>-vop expand=-1:-1:-1:-1:1</CODE></DT>
  <DD>Although the DXR3 driver can put some OSD onto the MPEG1/2/4 video,
    it has much lower quality than MPlayer's traditional OSD, and has several
    refresh problems as well. The command line above will firstly convert the
    input video to MPEG4 (this is mandatory, sorry), then apply an expand
    filter which won't expand anything (-1: default), but apply the normal OSD

  <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</P>

<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

</PRE>

<P>if you want to use the <CODE>crop</CODE> filter, you would do</P>

<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

9644:0fe056bdb135

</UL>

<P>The bpp (bits per pixel) value must be set to 4 by hand:<BR>
  &nbsp;&nbsp;<CODE>-bpp 4</CODE><BR>
  The movie probably must be scaled down to fit in EGA mode:<BR>
  &nbsp;&nbsp;<CODE>-vf scale=640:350</CODE> or<BR>
  &nbsp;&nbsp;<CODE>-vf scale=320:200</CODE><BR>
  For that we need fast but bad quality scaling routine:<BR>
  &nbsp;&nbsp;<CODE>-sws 4</CODE><BR>
  Maybe automatic aspect correction has to be shut off:<BR>
  &nbsp;&nbsp;<CODE>-noaspect</CODE></P>

<P><B>NOTE:</B> according to my experience the best image quality on EGA
  screens can be achieved by decreasing the brightness a bit: <CODE>-vf
  eq=-20:0</CODE>. I also needed to lower the audio samplerate on my box,
  because the sound was broken on 44kHz: <CODE>-srate 22050</CODE>.</P>

<P>You can turn on OSD and subtitles only with the <CODE>expand</CODE> filter,
  see the man page for exact parameters.</P>

<P>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,
  non-framebuffer console. Use SVGATextMode to set up a big textmode,
  then enjoy! (secondary head Hercules cards rock :)) (but imho you can use
  <CODE>-vf 1bpp</CODE> option to get graphics on hgafb:)</P>

<P>Use the <CODE>-framedrop</CODE> option if your computer isn't fast enough to
  render all frames!</P>

<P>Playing on terminal you'll get better speed and quality using the Linux

<P>Software decoding or transcoding different formats to MPEG1 can be achieved
  using a command like this:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes yourfile.ext
  mplayer -ao mpegpes -vo mpegpes -vf expand yourfile.ext
</PRE>

<P>Note that DVB cards only support heights 288 and 576 for PAL or 240 and 480
  for NTSC. You <B>must</B> rescale for other heights by adding
  <CODE>scale=width:height</CODE> with the width and height you want to the
  <CODE>-vf</CODE> option. DVB cards accept various widths, like 720, 704,
  640, 512, 480, 352 etc and do hardware scaling in horizontal direction, so
  you do not need to scale horizontally in most cases. For a 512x384 (aspect
  4:3) DivX try:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes -vf scale=512:576
</PRE>

<P>If you have a widescreen movie and you do not want to scale it to full height,
  you can use the <CODE>expand=w:h</CODE> filter to add black bands. To view a
  640x384 DivX, try:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes -vf expand=640:576 file.avi
</PRE>

<P>If your CPU is too slow for a full size 720x576 DivX, try downscaling:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes -vf scale=352:576 file.avi
</PRE>

<P>If speed does not improve, try vertical downscaling, too:</P>

<PRE>
  mplayer -ao mpegpes -vo mpegpes -vf scale=352:288 file.avi
</PRE>

<P>For OSD and subtitles use the OSD feature of the expand filter. So, instead
  of <CODE>expand=w:h</CODE> or <CODE>expand=w:h:x:y</CODE>, use
  <CODE>expand=w:h:x:y:1</CODE> (the 5th parameter <CODE>:1</CODE> at the end

<P>To keep the aspect ratio of DivX files and get the optimal scaling parameters
  (hardware horizontal scaling and software vertical scaling while keeping the
  right aspect ratio), use the new dvbscale filter:</P>

<PRE>
for  3:4 TV: -vf dvbscale,scale=-1:0,expand=-1:576:-1:-1:1
for 16:9 TV: -vf dvbscale=1024,scale=-1:0,expand=-1:576:-1:-1:1
</PRE>

<H4>FUTURE</H4>

<P>If you have questions or want to hear feature announcements and take part in

    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 (<CODE>-ac hwac3</CODE>).</DD>

  <DT><CODE>-vf lavc/fame</CODE></DT>
  <DD><B>(AUTO-INSERTED)</B> To watch non-MPEG content on the em8300 (i.e. DivX or RealVideo) you have
    to specify an MPEG1 video filter such as libavcodec (lavc) or libfame
    (fame). At the moment lavc is both faster and gives better image quality, it
    is suggested that you use that unless you have problems with it. See the man
    page for further info about <CODE>-vf lavc/fame</CODE>.<BR>
    Using lavc is highly recommended. Currently there is no way of setting the
    fps of the em8300 which means that it is fixed to 29.97fps. Because of this
    it is highly recommended that you use <CODE>-vf lavc=&lt;quality&gt;:25</CODE>,
    especially if you are using prebuffering. Then why 25 and not 29.97? Well,
    the thing is that when you use 29.97 the picture becomes a bit jumpy. The
    reason for this is unknown to us. If you set it to somewhere between 25 and
    27 the picture becomes stable. For now all we can do is accept this for a
    fact.</DD>

  <DT><CODE>-vf expand=-1:-1:-1:-1:1</CODE></DT>
  <DD>Although the DXR3 driver can put some OSD onto the MPEG1/2/4 video,
    it has much lower quality than MPlayer's traditional OSD, and has several
    refresh problems as well. The command line above will firstly convert the
    input video to MPEG4 (this is mandatory, sorry), then apply an expand
    filter which won't expand anything (-1: default), but apply the normal OSD

  <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</P>

<PRE>
  mplayer -vo zr -sws 0 -vf 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

</PRE>

<P>if you want to use the <CODE>crop</CODE> filter, you would do</P>

<PRE>
  mplayer -vo zr -vf 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