• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..20-Jun-2011-

COPYINGH A D10-Oct-200217.6 KiB341281

Cddb.hH A D16-Jun-20113.8 KiB11538

Cddb.mH A D16-Jun-201122.3 KiB707637

GNUmakefileH A D09-Jan-2008447 2715

READMEH A D16-Dec-20022 KiB6352

README

1Cddb - A GNUstep cddb bundle
2-------------------------------------
3This is a GNUstep bundle for cddb access
4It contains:
5Cddb/ as cddb bundle,
6CddbTest/ as the command-line application for test
7
8Cddb/ will install the header of cddb bundle.
9Therefore, use #include <Cddb/Cddb.h> in your source code.
10Cddb bundle offers high-level and low-level methods.
11Read TUTORIAL and CddbTest/ as examples
12
13Low-level method corresponds to the cddbp protocol.
14Read the cddbp protocol for more details
15
16High-level method use a NSArray of NSDictionary as input.
17The keys of NSDictionary are "length" and "offset" of each CD track in frames.
18The object of NSDictionary can be NSString or NSNumber (has intValue method).
19The number of objects in NSArray are the number of CD tracks.
20
21The return value of read: is a NSDictionary depending on the postProcess.
22If postProcess: NO, the return value corresponds to the cddb format.
23The class of objects and keys of return NSDictionary (postProcess: NO) are:
24NSString, "discid"
25NSString, "album"
26NSString, "year" (level 4 or up)
27NSString, "genre" (level 4 or up)
28NSArray, "titles" (title of each track)
29NSString, "extdata" (extra data about this album)
30NSArray, "exttitles" (extratitle of each track)
31
32Becuase the cddb format doesn't have an artist field,
33So the artist is either in album or titles fields.
34Use postProcess: YES to process the cddb format
35and give out the artist field.
36The class of objects and Keys of return NSDictionary (postProcess: YES) are:
37NSString, "discid"
38NSString, "album"
39NSString, "year"
40NSString, "genre"
41NSArray, "artists" <= This is new
42NSArray, "titles"
43NSString, 'extdata"
44NSArray, "exttitles"
45
46The return of query: is an NSArray of NSDictionary.
47The keys of NSDictionary are "category", "discid", "description".
48
49Right now, Cddb.bundle uses block I/O.
50Beware it will block your applcation when accessing cddb server.
51
52Install
53-------
54`make install` should work.
55
56License
57-------
58GNU General Public License
59
60Author
61------
62Yen-Ju Chen <yjchenx@hotmail.com>
63