X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=doc%2Fintf-cdda.txt;h=c56cee0cb39d0b49322eba33c6f3d9cabadb1844;hb=c8630200b1d2a421817721177c5428700021ccd0;hp=c2dc458544ac9d284e7ef0024dcd297a00aaa1cd;hpb=2fbb3ce9b27089f955e6f0f5a9ad068e467c3e29;p=vlc diff --git a/doc/intf-cdda.txt b/doc/intf-cdda.txt index c2dc458544..c56cee0cb3 100644 --- a/doc/intf-cdda.txt +++ b/doc/intf-cdda.txt @@ -28,7 +28,8 @@ MRL handling: support) Features: -- Can customize the what to show in the play-list title +- Can customize the what to show in the play-list title and author. +- Duration of each track is shown - Media information is shown using CDDB - Dynamic debugging - Will scan for a CD-ROM drive with a CD-DA loaded in it. @@ -165,34 +166,49 @@ Configuration settings in vlc are generally put in ~/.vlc/vlcrc. A description of the ones specific to CDDAX are listed below. - - -cddax-title-format +cddax-cddb-title-format -This gives a format used in the playlist title string. +This gives a format used in the playlist title string when CDDB is consulted. Similar to the Unix date command, there are format specifiers that start with a percent sign for which various information is filled in dynamically. The control specifiers are given as below - %a : The album artist ** - %A : The album information ** - %C : Category ** - %I : CDDB disk ID ** - %G : Genre ** + %a : The album artist + %A : The album information + %C : Category + %I : CDDB disk ID + %G : Genre %M : The current MRL %m : The CD-DA Media Catalog Number (MCN) %n : The number of tracks on the CD - %p : The artist/performer/composer in the track ** - %T : The track number ** + %p : The artist/performer/composer in the track + %T : The track number %s : Number of seconds in this track - %t : The name ** - %Y : The year 19xx or 20xx ** + %t : The name + %Y : The year 19xx or 20xx %% : a % -** Only available if CDDB is enabled - -The default if CDDB is enabled is +The default is Track %T. %t - %p -Or - %T %M otherwise + +- - +cddax-title-format + +This gives a format used in the playlist title string when CDDB is +*NOT* consulted. Similar to the Unix date command, there are format +specifiers that start with a percent sign for which various +information is filled in dynamically. The control specifiers are +given as below + + %M : The current MRL + %m : The CD-DA Media Catalog Number (MCN) + %n : The number of tracks on the CD + %T : The track number + %s : Number of seconds in this track + %% : a % + +The default is + %T %M - - cddax-cddb-email @@ -257,16 +273,16 @@ Determination: start at step 5. When you run the vlc GUI, under Settings/Preferences you should see a "plugins" expandable list and under that another "access" list do - you see a expandalbe entry under "access" labeled "cddax"? If so, + you see a expandable entry under "access" labeled "cddax"? If so, skip on to step 2. - a) If no "cddax" expandable list, thent the CDDAX plugin isn't + a) If no "cddax" expandable list, then the CDDAX plugin isn't loaded. Does a shared object exist? The plugin shared object is called "libcddax_plugin.so" It should be in the directory that has ...vlc/access. If this isn't around you need to build and install the CDDAX plugin. - b) if libcddax_plugin.so is in the fileystem, there might be a + b) if libcddax_plugin.so is in the filesystem, there might be a loader error; perhaps libcdio is not installed or are the wrong version. Use ldd on the file to see that it has all of the libraries dependencies satisfied. Also you might be able @@ -274,8 +290,8 @@ Determination: start at step 5. calls. On Linux and other OS's) "strace" can be used to see if the file gets accessed. On Solaris use "truss". - For example on Linux, amonst the many line of output when I run - "strace -e trace=file vlc" I see this amongst lots of other + For example on Linux, among the many line of output when I run + "strace -e trace=file vlc" I see this along with a lot of other output: ... @@ -304,7 +320,7 @@ Determination: start at step 5. no track, you should see in the playlist a list of tracks on the CD. a. If not something's wrong like step 2. Another tack may be to try - to read a disk image of a CD and thus elimate any problems with + to read a disk image of a CD and thus eliminate any problems with hardware. If this works, then this is a hardware problem. 4. (You have a list of entries describing the CD-DA or disk-file of @@ -349,7 +365,7 @@ you see what's going on dynamically. Various debugging settings will cause output to appear on vlc's plugin log and/or "standard error" (assuming you've run vlc in a way that you can capture this). -You think of debug switches as a bit mask, that you specifiy as an +You think of debug switches as a bit mask, that you specify as an integers the various "bit" values (given in decimal) are listed below. name value description @@ -361,8 +377,8 @@ integers the various "bit" values (given in decimal) are listed below. CALL 16 all calls LSN 32 LSN changes SEEK 64 Seeks to set location - CDIO 128 Debugging from CDIO - CDDB 256 CDDB debugging + CDIO 128 Debugging from CDIO library routines + CDDB 256 debugging from CDDB library routines **CD debugging... @@ -372,4 +388,4 @@ analyze the contents of a CD. The tool cd-read from libcdio can be used to show the sectors of the CD or CD image or extract sectors. -$Id: intf-cdda.txt,v 1.2 2003/12/01 04:05:29 rocky Exp $ +$Id: intf-cdda.txt,v 1.4 2003/12/18 12:35:26 rocky Exp $