# HG changeset patch # User diego # Date 1282063469 0 # Node ID ee8e6a959d6898b45b2447e5f162e758d8f5a5ff # Parent a564f632ba4969db60edea336437ee19e3b3a996 Merge CD/DVD chapter into the usage chapter. This improves the overall structure of the documentation. diff -r a564f632ba49 -r ee8e6a959d68 DOCS/xml/en/cd-dvd.xml --- a/DOCS/xml/en/cd-dvd.xml Tue Aug 17 15:12:35 2010 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,192 +0,0 @@ - - - -CD/DVD usage - - - -DVD playback - - -For the complete list of available options, please read the man page. -The syntax to play a standard DVD is as follows: - -mplayer dvd://<track> [-dvd-device <device>] - - - - -Example: -mplayer dvd://1 -dvd-device /dev/hdc - - - -If you have compiled MPlayer with dvdnav support, the -syntax is the same, except that you need to use dvdnav:// instead of dvd://. - - - -The default DVD device is /dev/dvd. If your setup -differs, make a symlink or specify the correct device on the command -line with the option. - - - -MPlayer uses libdvdread and -libdvdcss for DVD playback and decryption. These two -libraries are contained in the -MPlayer 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. - - - -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. - - - -DVD decryption - -DVD decryption is done by libdvdcss. The method -can be specified through the DVDCSS_METHOD environment -variable, see the manual page for details. - - - - -region code - -DVD drives nowadays come with a nonsensical restriction labeled -region code. -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. - - - -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 -regionset tool -to set the region code of your DVD drive. - - - -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 -"The firmware page". -While the usual caveats for firmware upgrades apply, experience with -getting rid of region code enforcement is generally positive. - - - - - - - - - - -VCD playback - - -For the complete list of available options, please read the man page. The -Syntax for a standard Video CD (VCD) is as follows: -mplayer vcd://<track> [-cdrom-device <device>] -Example: -mplayer vcd://2 -cdrom-device /dev/hdc -The default VCD device is /dev/cdrom. If your setup -differs, make a symlink or specify the correct device on the command line -with the option. - - - -At least Plextor and some Toshiba SCSI CD-ROM drives have horrible performance -reading VCDs. This is because the CDROMREADRAW ioctl -is not fully implemented for these drives. If you have some knowledge of SCSI -programming, please help us -implement generic SCSI support for VCDs. - - - -In the meantime you can extract data from VCDs with -readvcd -and play the resulting file with MPlayer. - - - -VCD structure - -A Video CD (VCD) is made up of CD-ROM XA sectors, i.e. CD-ROM mode 2 -form 1 and 2 tracks: - - - 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. - - - - 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 - cannot be mounted. As most movies are - inside this kind of track, you should try - first. - - - - There exist VCD disks without the first track (single track and no file system - at all). They are still playable, but cannot be mounted. - - - - 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 - vcdimager documentation. - - - - - - -About .DAT files - -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 -(vcdfs/isofs-2.4.X.o) 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 -MPlayer. But it will not -work with the standard iso9660 driver of the Linux kernel! Use - instead. Alternatives for VCD copying are the -new cdfs kernel -driver (not part of the official kernel) that shows CD sessions as image files -and cdrdao, a bit-by-bit -CD grabbing/copying application. - - - - diff -r a564f632ba49 -r ee8e6a959d68 DOCS/xml/en/documentation.xml --- a/DOCS/xml/en/documentation.xml Tue Aug 17 15:12:35 2010 +0000 +++ b/DOCS/xml/en/documentation.xml Tue Aug 17 16:44:29 2010 +0000 @@ -166,7 +166,6 @@ &install.xml; &usage.xml; -&cd-dvd.xml; &tvinput.xml; &radio.xml; &video.xml; diff -r a564f632ba49 -r ee8e6a959d68 DOCS/xml/en/usage.xml --- a/DOCS/xml/en/usage.xml Tue Aug 17 15:12:35 2010 +0000 +++ b/DOCS/xml/en/usage.xml Tue Aug 17 16:44:29 2010 +0000 @@ -430,6 +430,197 @@ + +DVD playback + + +For the complete list of available options, please read the man page. +The syntax to play a standard DVD is as follows: + +mplayer dvd://<track> [-dvd-device <device>] + + + + +Example: +mplayer dvd://1 -dvd-device /dev/hdc + + + +If you have compiled MPlayer with dvdnav support, the +syntax is the same, except that you need to use dvdnav:// instead of dvd://. + + + +The default DVD device is /dev/dvd. If your setup +differs, make a symlink or specify the correct device on the command +line with the option. + + + +MPlayer uses libdvdread and +libdvdcss for DVD playback and decryption. These two +libraries are contained in the +MPlayer 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. + + + +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. + + + +DVD decryption + +DVD decryption is done by libdvdcss. The method +can be specified through the DVDCSS_METHOD environment +variable, see the manual page for details. + + + + + + +region code + +DVD drives nowadays come with a nonsensical restriction labeled +region code. +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. + + + +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 +regionset tool +to set the region code of your DVD drive. + + + +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 +"The firmware page". +While the usual caveats for firmware upgrades apply, experience with +getting rid of region code enforcement is generally positive. + + + + + + + + + +VCD playback + + +For the complete list of available options, please read the man page. The +Syntax for a standard Video CD (VCD) is as follows: +mplayer vcd://<track> [-cdrom-device <device>] +Example: +mplayer vcd://2 -cdrom-device /dev/hdc +The default VCD device is /dev/cdrom. If your setup +differs, make a symlink or specify the correct device on the command line +with the option. + + + +At least Plextor and some Toshiba SCSI CD-ROM drives have horrible performance +reading VCDs. This is because the CDROMREADRAW ioctl +is not fully implemented for these drives. If you have some knowledge of SCSI +programming, please help us +implement generic SCSI support for VCDs. + + + +In the meantime you can extract data from VCDs with +readvcd +and play the resulting file with MPlayer. + + + +VCD structure + +A Video CD (VCD) is made up of CD-ROM XA sectors, i.e. CD-ROM mode 2 +form 1 and 2 tracks: + + + 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. + + + + 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 + cannot be mounted. As most movies are + inside this kind of track, you should try + first. + + + + There exist VCD disks without the first track (single track and no file system + at all). They are still playable, but cannot be mounted. + + + + 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 + vcdimager documentation. + + + + + + +About .DAT files + +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 +(vcdfs/isofs-2.4.X.o) 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 +MPlayer. But it will not +work with the standard iso9660 driver of the Linux kernel! Use + instead. Alternatives for VCD copying are the +new cdfs kernel +driver (not part of the official kernel) that shows CD sessions as image files +and cdrdao, a bit-by-bit +CD grabbing/copying application. + + + + + + + + Edit Decision Lists (EDL)