comparison DOCS/xml/en/video.xml @ 11713:a1bc8133084a

<replaceable> tags' attack :P

11712:5905aae865c7

Become <systemitem class="username">root</systemitem>. DGA needs root
access to be able to write directly video memory. If you want to run it as
user, then install <application>MPlayer</application> SUID root:

<screen>
chown root /usr/local/bin/mplayer
chmod 750 /usr/local/bin/mplayer
chmod +s /usr/local/bin/mplayer
</screen>

Now it works as a simple user, too.
</para>

</varlistentry>
</variablelist>

<para>
If you want to change to a specific mode, then use
<screen>mplayer -vm -fbmode <replaceable>name_of_mode</replaceable> <replaceable>filename</replaceable></screen>
</para>

<itemizedlist>
<listitem><para>
  <option>-vm</option> alone will choose the most suitable mode from

</formalpara>
<para>
Also you can specify VIDIX's driver directly as third subargument in
command line:

<screen>mplayer -vo xvidix:mga_vid.so -fs -zoom -double file.avi</screen>
or
<screen>mplayer -vo vesa:vidix:radeon_vid.so -fs -zoom -double -bpp 32 file.avi</screen>

But it's dangerous, and you shouldn't do that. In this case given driver
will be forced and result is unpredictable (it may
<emphasis role="bold">freeze</emphasis> your computer). You should do that
ONLY if you are absolutely sure it will work, and

  every single decoder from the libavcodec family. This leaves us with the
  following usable popular codecs: <systemitem>cvid, divxds, xvid, divx4,
  wmv7, wmv8</systemitem> and some others. Please note that this is only
  a temporal inconvenience. The usage syntax is as follows:
  <screen>
    mplayer -vf format=uyvy -vc divxds divx3file.avi
  </screen>
  </para></listitem>
</itemizedlist>

<para>
  An unique feature of the nvidia_vid driver is its ability to display video on
  <emphasis role="bold">plain, pure, text-only console</emphasis> - with no
  framebuffer or X magic whatsoever. For this purpose, we'll have to use the
  <option>cvidix</option> video output, as the following example shows:
  <screen>
    mplayer -vf format=uyvy -vc divxds -vo cvidix example.avi
  </screen>
</para>

<para>
Reports awaited!

<para>
Hardware decoding (playing standard MPEG1/2 files) can be done with this command:
</para>
</formalpara>

<para><screen>mplayer -ao mpegpes -vo mpegpes file.mpg|vob</screen></para>

<para>
Software decoding or transcoding different formats to MPEG1 can be achieved using
a command like this:
</para>
<para><screen>
mplayer -ao mpegpes -vo mpegpes yourfile.ext
mplayer -ao mpegpes -vo mpegpes -vf expand yourfile.ext
</screen></para>

<para>
Note that DVB cards only support heights 288 and 576 for PAL or 240 and 480 for
NTSC. You <emphasis role="bold">must</emphasis> rescale for other heights by adding

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

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

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

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

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

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

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

that you have a movie with a resolution of 512x272 and you want to view it
fullscreen on your DC10+. There are three main possibilities, you may scale
the movie to a width of 768, 384 or 192. For performance and quality reasons,
I would choose to scale the movie to 384x204 using the fast bilinear software
scaler. The commandline is
<screen>mplayer -vo zr -sws 0 -vf scale=384:204 movie.avi</screen>
</para>

<para>
Cropping can be done by the <option>crop</option> filter and by this
driver itself. Suppose that a movie is too wide for display on your Buz and
that you want to use <option>-zrcrop</option> to make the movie less wide,
then you would issue the following command
<screen>mplayer -vo zr -zrcrop 720x320+80+0 benhur.avi</screen>
</para>

<para>
if you want to use the <option>crop</option> filter, you would do
<screen>mplayer -vo zr -vf crop=720:320:80:0 benhur.avi</screen>
</para>

<para>
Extra occurrences of <option>-zrcrop</option> invoke <emphasis>cinerama</emphasis>
mode, i.e. you can distribute the movie over several TV's or beamers to create a

of 704x288. Suppose also that you want the right beamer in black and white and
that the left beamer should have JPEG frames at quality 10, then you would
issue the following command
<screen>
mplayer -vo zr -zrdev /dev/video0 -zrcrop 352x288+352+0 -zrxdoff 0 -zrbw \
          -zrcrop 352x288+0+0 -zrdev /dev/video1 -zrquality 10 movie.avi
</screen>
</para>

<para>
You see that the options appearing before the second <option>-zrcrop</option>

11713:a1bc8133084a

Become <systemitem class="username">root</systemitem>. DGA needs root
access to be able to write directly video memory. If you want to run it as
user, then install <application>MPlayer</application> SUID root:

<screen>
chown root <replaceable>/usr/local/bin/mplayer</replaceable>
chmod 750 <replaceable>/usr/local/bin/mplayer</replaceable>
chmod +s <replaceable>/usr/local/bin/mplayer</replaceable>
</screen>

Now it works as a simple user, too.
</para>

</varlistentry>
</variablelist>

<para>
If you want to change to a specific mode, then use
<screen>
mplayer -vm -fbmode <replaceable>name_of_mode</replaceable> <replaceable>filename</replaceable>
</screen>
</para>

<itemizedlist>
<listitem><para>
  <option>-vm</option> alone will choose the most suitable mode from

</formalpara>
<para>
Also you can specify VIDIX's driver directly as third subargument in
command line:

<screen>mplayer -vo xvidix:mga_vid.so -fs -zoom -double <replaceable>file.avi</replaceable></screen>
or
<screen>mplayer -vo vesa:vidix:radeon_vid.so -fs -zoom -double -bpp 32 <replaceable>file.avi</replaceable></screen>

But it's dangerous, and you shouldn't do that. In this case given driver
will be forced and result is unpredictable (it may
<emphasis role="bold">freeze</emphasis> your computer). You should do that
ONLY if you are absolutely sure it will work, and

  every single decoder from the libavcodec family. This leaves us with the
  following usable popular codecs: <systemitem>cvid, divxds, xvid, divx4,
  wmv7, wmv8</systemitem> and some others. Please note that this is only
  a temporal inconvenience. The usage syntax is as follows:
  <screen>
    mplayer -vf format=uyvy -vc divxds <replaceable>divx3file.avi</replaceable>
  </screen>
  </para></listitem>
</itemizedlist>

<para>
  An unique feature of the nvidia_vid driver is its ability to display video on
  <emphasis role="bold">plain, pure, text-only console</emphasis> - with no
  framebuffer or X magic whatsoever. For this purpose, we'll have to use the
  <option>cvidix</option> video output, as the following example shows:
  <screen>
    mplayer -vf format=uyvy -vc divxds -vo cvidix <replaceable>example.avi</replaceable>
  </screen>
</para>

<para>
Reports awaited!

<para>
Hardware decoding (playing standard MPEG1/2 files) can be done with this command:
</para>
</formalpara>

<para>
<screen>mplayer -ao mpegpes -vo mpegpes <replaceable>file.mpg|vob</replaceable></screen>
</para>

<para>
Software decoding or transcoding different formats to MPEG1 can be achieved using
a command like this:
</para>
<para><screen>
mplayer -ao mpegpes -vo mpegpes <replaceable>yourfile.ext</replaceable>
mplayer -ao mpegpes -vo mpegpes -vf expand <replaceable>yourfile.ext</replaceable>
</screen></para>

<para>
Note that DVB cards only support heights 288 and 576 for PAL or 240 and 480 for
NTSC. You <emphasis role="bold">must</emphasis> rescale for other heights by adding

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

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

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

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

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

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

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

that you have a movie with a resolution of 512x272 and you want to view it
fullscreen on your DC10+. There are three main possibilities, you may scale
the movie to a width of 768, 384 or 192. For performance and quality reasons,
I would choose to scale the movie to 384x204 using the fast bilinear software
scaler. The commandline is
<screen>
mplayer -vo zr -sws 0 -vf scale=384:204 <replaceable>movie.avi</replaceable>
</screen>
</para>

<para>
Cropping can be done by the <option>crop</option> filter and by this
driver itself. Suppose that a movie is too wide for display on your Buz and
that you want to use <option>-zrcrop</option> to make the movie less wide,
then you would issue the following command
<screen>
mplayer -vo zr -zrcrop 720x320+80+0 <replaceable>benhur.avi</replaceable>
</screen>
</para>

<para>
if you want to use the <option>crop</option> filter, you would do
<screen>
mplayer -vo zr -vf crop=720:320:80:0 <replaceable>benhur.avi</replaceable>
</screen>
</para>

<para>
Extra occurrences of <option>-zrcrop</option> invoke <emphasis>cinerama</emphasis>
mode, i.e. you can distribute the movie over several TV's or beamers to create a

of 704x288. Suppose also that you want the right beamer in black and white and
that the left beamer should have JPEG frames at quality 10, then you would
issue the following command
<screen>
mplayer -vo zr -zrdev /dev/video0 -zrcrop 352x288+352+0 -zrxdoff 0 -zrbw \
          -zrcrop 352x288+0+0 -zrdev /dev/video1 -zrquality 10 \
	  <replaceable>movie.avi</replaceable>
</screen>
</para>

<para>
You see that the options appearing before the second <option>-zrcrop</option>