NAME¶
MP3::Tag::CDDB_File - Module for parsing CDDB files.
SYNOPSIS¶
my $db = MP3::Tag::CDDB_File->new($filename, $track); # Name of audio file
my $db = MP3::Tag::CDDB_File->new_from($record, $track); # Contents of CDDB
($title, $artist, $album, $year, $comment, $track) = $db->parse();
see MP3::Tag
DESCRIPTION¶
MP3::Tag::CDDB_File is designed to be called from the MP3::Tag module.
It parses the content of CDDB file.
The file is found in the same directory as audio file; the list of possible file
names is taken from the field "cddb_files" if set by MP3::Tag
config() method.
- parse()
-
($title, $artist, $album, $year, $comment, $track) =
$db->parse($what);
parse_filename() extracts information about artist, title, track
number, album and year from the CDDB record. $what is optional; it maybe
title, track, artist, album, year, genre or comment. If $what is defined
parse() will return only this element.
Additionally, $what can take values "artist_collection" (returns
the value of artist in the disk-info field DTITLE, but only if author is
specified in the track-info field TTITLE), "title_track"
(returns the title specifically from track-info field - the
"track" may fall back to the info from disk-info field),
"comment_collection" (processed EXTD comment),
"comment_track" (processed EXTT comment).
The returned year and genre is taken from DYEAR, DGENRE, EXTT, EXTD fields;
recognized prefixes in the two last fields are YEAR, ID3Y, ID3G. The
declarations of this form are stripped from the returned comment.
An alternative syntax "Recorded"/"Recorded
on"/"Recorded in"/ is also supported; the format of the
date recognized by ID3v2::year(), or just a date field without a
prefix.
- title()
-
$title = $db->title();
Returns the title, obtained from the 'Tracktitle' entry of the file.
- artist()
-
$artist = $db->artist();
Returns the artist name, obtained from the 'Performer' or 'Albumperformer'
entries (the first which is present) of the file.
- track()
-
$track = $db->track();
Returns the track number, stored during object creation, or queried from the
parent.
- year()
-
$year = $db->year();
Returns the year, obtained from the 'Year' entry of the file. (Often not
present.)
- album()
-
$album = $db->album();
Returns the album name, obtained from the 'Albumtitle' entry of the
file.
- comment()
-
$comment = $db->comment();
Returns the 'Trackcomment' entry of the file. (Often not present.)
- genre()
-
$genre = $db->genre($filename);