Makefile: remove distclean hack for dependency files
[mplayer/glamo.git] / DOCS / xml / en / cd-dvd.xml
blobfb198da5e31cb8c08f1a58c00daf8ef45daa52cc
1 <?xml version="1.0" encoding="utf-8"?>
2 <!-- $Revision$ -->
3 <chapter id="cd-dvd">
4 <title>CD/DVD usage</title>
7 <sect1 id="dvd">
8 <title>DVD playback</title>
10 <para>
11 For the complete list of available options, please read the man page.
12 The syntax to play a standard DVD is as follows:
13 <screen>
14 mplayer dvd://<replaceable>&lt;track&gt;</replaceable> [-dvd-device <replaceable>&lt;device&gt;</replaceable>]
15 </screen>
16 </para>
18 <para>
19 Example:
20 <screen>mplayer dvd://1 -dvd-device /dev/hdc</screen>
21 </para>
23 <para>
24 If you have compiled <application>MPlayer</application> with dvdnav support, the
25 syntax is the same, except that you need to use dvdnav:// instead of dvd://.
26 </para>
28 <para>
29 The default DVD device is <filename>/dev/dvd</filename>. If your setup
30 differs, make a symlink or specify the correct device on the command
31 line with the <option>-dvd-device</option> option.
32 </para>
34 <para>
35 <application>MPlayer</application> uses <systemitem>libdvdread</systemitem> and
36 <systemitem>libdvdcss</systemitem> for DVD playback and decryption. These two
37 libraries are contained in the
38 <application>MPlayer</application> source tree, you do not have
39 to install them separately. You can also use system-wide versions of the two
40 libraries, but this solution is not recommended, as it can result in bugs,
41 library incompatibilities and slower speed.
42 </para>
44 <note><para>
45 In case of DVD decoding problems, try disabling supermount, or any other such
46 facilities. Some RPC-2 drives may also require setting the region code.
47 </para></note>
49 <formalpara>
50 <title>DVD decryption</title>
51 <para>
52 DVD decryption is done by <systemitem>libdvdcss</systemitem>. The method
53 can be specified through the <envar>DVDCSS_METHOD</envar> environment
54 variable, see the manual page for details.
55 </para>
56 </formalpara>
58 <sect2 id="region_code">
59 <title>region code</title>
60 <para>
61 DVD drives nowadays come with a nonsensical restriction labeled
62 <ulink url="http://en.wikipedia.org/wiki/DVD_region_code">region code</ulink>.
63 This is a scheme to force DVD drives to only accept DVDs produced for one of
64 the six different regions into which the world was partitioned. How a group
65 of people can sit around a table, come up with such an idea and expect the
66 world of the 21st century to bow to their will is beyond anyone's guess.
67 </para>
69 <para>
70 Drives that enforce region settings through software only are also known as
71 RPC-1 drives, those that do it in hardware as RPC-2. RPC-2 drives allow
72 changing the region code five times before it remains fixed.
73 Under Linux you can use the
74 <ulink url="http://linvdr.org/projects/regionset/">regionset</ulink> tool
75 to set the region code of your DVD drive.
76 </para>
78 <para>
79 Thankfully, it is possible to convert RPC-2 drives into RPC-1 drives through
80 a firmware upgrade. Feed the model number of your DVD drive into your favorite
81 search engine or have a look at the forum and download sections of
82 <ulink url="http://www.rpc1.org/">"The firmware page"</ulink>.
83 While the usual caveats for firmware upgrades apply, experience with
84 getting rid of region code enforcement is generally positive.
85 </para>
86 </sect2>
88 </sect1>
91 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
94 <sect1 id="vcd">
95 <title>VCD playback</title>
97 <para>
98 For the complete list of available options, please read the man page. The
99 Syntax for a standard Video CD (VCD) is as follows:
100 <screen>mplayer vcd://<replaceable>&lt;track&gt;</replaceable> [-cdrom-device <replaceable>&lt;device&gt;</replaceable>]</screen>
101 Example:
102 <screen>mplayer vcd://2 -cdrom-device /dev/hdc</screen>
103 The default VCD device is <filename>/dev/cdrom</filename>. If your setup
104 differs, make a symlink or specify the correct device on the command line
105 with the <option>-cdrom-device</option> option.
106 </para>
108 <note><para>
109 At least Plextor and some Toshiba SCSI CD-ROM drives have horrible performance
110 reading VCDs. This is because the CDROMREADRAW <systemitem>ioctl</systemitem>
111 is not fully implemented for these drives. If you have some knowledge of SCSI
112 programming, please <ulink url="../../tech/patches.txt">help us</ulink>
113 implement generic SCSI support for VCDs.
114 </para></note>
116 <para>
117 In the meantime you can extract data from VCDs with
118 <ulink url="http://ftp.ntut.edu.tw/ftp/OS/Linux/packages/X/viewers/readvcd/">readvcd</ulink>
119 and play the resulting file with <application>MPlayer</application>.
120 </para>
122 <formalpara>
123 <title>VCD structure</title>
124 <para>
125 A Video CD (VCD) is made up of CD-ROM XA sectors, i.e. CD-ROM mode 2
126 form 1 and 2 tracks:
127 <itemizedlist>
128 <listitem><para>
129   The first track is in mode 2 form 2 format which means it uses L2
130   error correction. The track contains an ISO-9660 file system with 2048
131   bytes/sector. This file system contains VCD metadata information, as
132   well as still frames often used in menus. MPEG segments for menus can
133   also be stored in this first track, but the MPEGs have to be broken up
134   into a series of 150-sector chunks. The ISO-9660 file system may
135   contain other files or programs that are not essential for VCD
136   operation.
137 </para></listitem>
139 <listitem><para>
140   The second and remaining tracks are generally raw 2324 bytes/sector
141   MPEG (movie) tracks, containing one MPEG PS data packet per
142   sector. These are in mode 2 form 1 format, so they store more data per
143   sector at the loss of some error correction. It is also legal to have
144   CD-DA tracks in a VCD after the first track as well.
145   On some operating systems there is some trickery that goes on to make
146   these non-ISO-9660 tracks appear in a file system. On other operating
147   systems like GNU/Linux this is not the case (yet). Here the MPEG data
148   <emphasis role="bold">cannot be mounted</emphasis>. As most movies are
149   inside this kind of track, you should try <option>vcd://2</option>
150   first.
151 </para></listitem>
153 <listitem><para>
154   There exist VCD disks without the first track (single track and no file system
155   at all). They are still playable, but cannot be mounted.
156 </para></listitem>
158 <listitem><para>
159   The definition of the Video CD standard is called the
160   Philips "White Book" and it is not generally available online as it
161   must be purchased from Philips. More detailed information about Video
162   CDs can be found in the
163   <ulink url="http://www.vcdimager.org/pub/vcdimager/manuals/0.7/vcdimager.html#SEC4">vcdimager documentation</ulink>.
164 </para></listitem>
165 </itemizedlist>
166 </para>
167 </formalpara>
169 <formalpara>
170 <title>About .DAT files</title>
171 <para>
172 The ~600 MB file visible on the first track of the mounted VCD is not a real
173 file! It is a so called ISO gateway, created to allow Windows to handle such
174 tracks (Windows does not allow raw device access to applications at all).
175 Under Linux you cannot copy or play such files (they contain garbage). Under
176 Windows it is possible as its iso9660 driver emulates the raw reading of
177 tracks in this file. To play a .DAT file you need the kernel driver which can
178 be found in the Linux version of PowerDVD. It has a modified iso9660 file system
179 (<filename>vcdfs/isofs-2.4.X.o</filename>) driver, which is able to emulate the
180 raw tracks through this shadow .DAT file. If you mount the disc using their
181 driver, you can copy and even play .DAT files with
182 <application>MPlayer</application>. But it will not
183 work with the standard iso9660 driver of the Linux kernel! Use
184 <option>vcd://</option> instead. Alternatives for VCD copying are the
185 new <ulink url="http://www.elis.rug.ac.be/~ronsse/cdfs/">cdfs</ulink> kernel
186 driver (not part of the official kernel) that shows CD sessions as image files
187 and <ulink url="http://cdrdao.sf.net/">cdrdao</ulink>, a bit-by-bit
188 CD grabbing/copying application.
189 </para>
190 </formalpara>
191 </sect1>
192 </chapter>