[MPlayer-DOCS] r31970 - in trunk/DOCS/xml/en: cd-dvd.xml documentation.xml usage.xml

diego subversion at mplayerhq.hu
Tue Aug 17 18:44:29 CEST 2010 

Author: diego
Date: Tue Aug 17 18:44:29 2010
New Revision: 31970

Log:
Merge CD/DVD chapter into the usage chapter.
This improves the overall structure of the documentation.

Deleted:
   trunk/DOCS/xml/en/cd-dvd.xml
Modified:
   trunk/DOCS/xml/en/documentation.xml
   trunk/DOCS/xml/en/usage.xml

Modified: trunk/DOCS/xml/en/documentation.xml
==============================================================================
--- trunk/DOCS/xml/en/documentation.xml	Tue Aug 17 17:12:35 2010	(r31969)
+++ trunk/DOCS/xml/en/documentation.xml	Tue Aug 17 18:44:29 2010	(r31970)
@@ -166,7 +166,6 @@ can be distributed under the terms of th
 &install.xml;
 
 &usage.xml;
-&cd-dvd.xml;
 &tvinput.xml;
 &radio.xml;
 &video.xml;

Modified: trunk/DOCS/xml/en/usage.xml
==============================================================================
--- trunk/DOCS/xml/en/usage.xml	Tue Aug 17 17:12:35 2010	(r31969)
+++ trunk/DOCS/xml/en/usage.xml	Tue Aug 17 18:44:29 2010	(r31970)
@@ -430,6 +430,197 @@ This works with all protocols supported 
 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
 
 
+<sect1 id="dvd">
+<title>DVD playback</title>
+
+<para>
+For the complete list of available options, please read the man page.
+The syntax to play a standard DVD is as follows:
+<screen>
+mplayer dvd://<replaceable>&lt;track&gt;</replaceable> [-dvd-device <replaceable>&lt;device&gt;</replaceable>]
+</screen>
+</para>
+
+<para>
+Example:
+<screen>mplayer dvd://1 -dvd-device /dev/hdc</screen>
+</para>
+
+<para>
+If you have compiled <application>MPlayer</application> with dvdnav support, the
+syntax is the same, except that you need to use dvdnav:// instead of dvd://.
+</para>
+
+<para>
+The default DVD device is <filename>/dev/dvd</filename>. If your setup
+differs, make a symlink or specify the correct device on the command
+line with the <option>-dvd-device</option> option.
+</para>
+
+<para>
+<application>MPlayer</application> uses <systemitem>libdvdread</systemitem> and
+<systemitem>libdvdcss</systemitem> for DVD playback and decryption. These two
+libraries are contained in the
+<application>MPlayer</application> source tree, you do not have
+to install them separately. You can also use system-wide versions of the two
+libraries, but this solution is not recommended, as it can result in bugs,
+library incompatibilities and slower speed.
+</para>
+
+<note><para>
+In case of DVD decoding problems, try disabling supermount, or any other such
+facilities. Some RPC-2 drives may also require setting the region code.
+</para></note>
+
+<formalpara>
+<title>DVD decryption</title>
+<para>
+DVD decryption is done by <systemitem>libdvdcss</systemitem>. The method
+can be specified through the <envar>DVDCSS_METHOD</envar> environment
+variable, see the manual page for details.
+</para>
+</formalpara>
+
+<!-- ********** -->
+
+<sect2 id="region_code">
+<title>region code</title>
+<para>
+DVD drives nowadays come with a nonsensical restriction labeled
+<ulink url="http://en.wikipedia.org/wiki/DVD_region_code">region code</ulink>.
+This is a scheme to force DVD drives to only accept DVDs produced for one of
+the six different regions into which the world was partitioned. How a group
+of people can sit around a table, come up with such an idea and expect the
+world of the 21st century to bow to their will is beyond anyone's guess.
+</para>
+
+<para>
+Drives that enforce region settings through software only are also known as
+RPC-1 drives, those that do it in hardware as RPC-2. RPC-2 drives allow
+changing the region code five times before it remains fixed.
+Under Linux you can use the
+<ulink url="http://linvdr.org/projects/regionset/">regionset</ulink> tool
+to set the region code of your DVD drive.
+</para>
+
+<para>
+Thankfully, it is possible to convert RPC-2 drives into RPC-1 drives through
+a firmware upgrade. Feed the model number of your DVD drive into your favorite
+search engine or have a look at the forum and download sections of
+<ulink url="http://www.rpc1.org/">"The firmware page"</ulink>.
+While the usual caveats for firmware upgrades apply, experience with
+getting rid of region code enforcement is generally positive.
+</para>
+</sect2>
+</sect1>
+
+
+<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+
+
+<sect1 id="vcd">
+<title>VCD playback</title>
+
+<para>
+For the complete list of available options, please read the man page. The
+Syntax for a standard Video CD (VCD) is as follows:
+<screen>mplayer vcd://<replaceable>&lt;track&gt;</replaceable> [-cdrom-device <replaceable>&lt;device&gt;</replaceable>]</screen>
+Example:
+<screen>mplayer vcd://2 -cdrom-device /dev/hdc</screen>
+The default VCD device is <filename>/dev/cdrom</filename>. If your setup
+differs, make a symlink or specify the correct device on the command line
+with the <option>-cdrom-device</option> option.
+</para>
+
+<note><para>
+At least Plextor and some Toshiba SCSI CD-ROM drives have horrible performance
+reading VCDs. This is because the CDROMREADRAW <systemitem>ioctl</systemitem>
+is not fully implemented for these drives. If you have some knowledge of SCSI
+programming, please <ulink url="../../tech/patches.txt">help us</ulink>
+implement generic SCSI support for VCDs.
+</para></note>
+
+<para>
+In the meantime you can extract data from VCDs with
+<ulink url="http://ftp.ntut.edu.tw/ftp/OS/Linux/packages/X/viewers/readvcd/">readvcd</ulink>
+and play the resulting file with <application>MPlayer</application>.
+</para>
+
+<formalpara>
+<title>VCD structure</title>
+<para>
+A Video CD (VCD) is made up of CD-ROM XA sectors, i.e. CD-ROM mode 2
+form 1 and 2 tracks:
+<itemizedlist>
+<listitem><para>
+  The first track is in mode 2 form 2 format which means it uses L2
+  error correction. The track contains an ISO-9660 file system with 2048
+  bytes/sector. This file system contains VCD metadata information, as
+  well as still frames often used in menus. MPEG segments for menus can
+  also be stored in this first track, but the MPEGs have to be broken up
+  into a series of 150-sector chunks. The ISO-9660 file system may
+  contain other files or programs that are not essential for VCD
+  operation.
+</para></listitem>
+
+<listitem><para>
+  The second and remaining tracks are generally raw 2324 bytes/sector
+  MPEG (movie) tracks, containing one MPEG PS data packet per
+  sector. These are in mode 2 form 1 format, so they store more data per
+  sector at the loss of some error correction. It is also legal to have
+  CD-DA tracks in a VCD after the first track as well.
+  On some operating systems there is some trickery that goes on to make
+  these non-ISO-9660 tracks appear in a file system. On other operating
+  systems like GNU/Linux this is not the case (yet). Here the MPEG data
+  <emphasis role="bold">cannot be mounted</emphasis>. As most movies are
+  inside this kind of track, you should try <option>vcd://2</option>
+  first.
+</para></listitem>
+
+<listitem><para>
+  There exist VCD disks without the first track (single track and no file system
+  at all). They are still playable, but cannot be mounted.
+</para></listitem>
+
+<listitem><para>
+  The definition of the Video CD standard is called the
+  Philips "White Book" and it is not generally available online as it
+  must be purchased from Philips. More detailed information about Video
+  CDs can be found in the
+  <ulink url="http://www.vcdimager.org/pub/vcdimager/manuals/0.7/vcdimager.html#SEC4">vcdimager documentation</ulink>.
+</para></listitem>
+</itemizedlist>
+</para>
+</formalpara>
+
+<formalpara>
+<title>About .DAT files</title>
+<para>
+The ~600 MB file visible on the first track of the mounted VCD is not a real
+file! It is a so called ISO gateway, created to allow Windows to handle such
+tracks (Windows does not allow raw device access to applications at all).
+Under Linux you cannot copy or play such files (they contain garbage). Under
+Windows it is possible as its iso9660 driver emulates the raw reading of
+tracks in this file. To play a .DAT file you need the kernel driver which can
+be found in the Linux version of PowerDVD. It has a modified iso9660 file system
+(<filename>vcdfs/isofs-2.4.X.o</filename>) driver, which is able to emulate the
+raw tracks through this shadow .DAT file. If you mount the disc using their
+driver, you can copy and even play .DAT files with
+<application>MPlayer</application>. But it will not
+work with the standard iso9660 driver of the Linux kernel! Use
+<option>vcd://</option> instead. Alternatives for VCD copying are the
+new <ulink url="http://www.elis.rug.ac.be/~ronsse/cdfs/">cdfs</ulink> kernel
+driver (not part of the official kernel) that shows CD sessions as image files
+and <ulink url="http://cdrdao.sf.net/">cdrdao</ulink>, a bit-by-bit
+CD grabbing/copying application.
+</para>
+</formalpara>
+</sect1>
+
+
+<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+
+
 <sect1 id="edl" xreflabel="Edit Decision Lists (EDL)">
 <title>Edit Decision Lists (EDL)</title>

More information about the MPlayer-DOCS mailing list