#include <Nsound/Wavefile.h>

Public Member Functions
	ID3v1Tag (const std::string &filename="", boolean show_warnings=true)

boolean	read (const std::string &filename, boolean show_warnings=true)
	Returns true if it found the tag, false otherwise. More...

boolean	write (const std::string &filename, boolean show_warnings=true)
	Returns true if it successfully wrote the tag to the end of the file, false otherwise. More...

Public Attributes
std::string	title

std::string	artist

std::string	album

std::string	year

std::string	comment

char	genre

Friends
std::ostream &	operator<< (std::ostream &out, const ID3v1Tag &rhs)
	Sends the contents of the Buffer to the output stream. More...

Detailed Description

Definition at line 254 of file Wavefile.h.

Constructor & Destructor Documentation

ID3v1Tag::ID3v1Tag	(	const std::string &	filename = `""`,
		boolean	show_warnings = `true`
	)

Definition at line 1532 of file Wavefile.cc.

References read().

     : title(),
       artist(),
       album(),
       year(),
       comment(),
       genre(' ')
 {
     if(filename.size() > 0)
     {
         this->read(filename,show_warnings);
     }
 }

Member Function Documentation

boolean ID3v1Tag::read	(	const std::string &	filename,
		boolean	show_warnings = `true`
	)

Returns true if it found the tag, false otherwise.

Definition at line 1663 of file Wavefile.cc.

References album, RawTag::album, artist, RawTag::artist, comment, RawTag::comment, findID3v1Tag(), genre, RawTag::genre, RawTag::header, IO_ERROR, M_THROW, NOT_FOUND, title, RawTag::title, year, and RawTag::year.

Referenced by ID3v1Tag().

 {
     FILE * fin = fopen(filename.c_str(), "rb");
 
     if(fin == NULL)
     {
         M_THROW("ID3v1Tag::read(): could not open the file '"
              << filename
              << "'");
         return false;
     }
 
     int64 tag_pos = static_cast<size_t>(findID3v1Tag(fin));
 
     if(tag_pos == IO_ERROR)
     {
         fclose(fin);
         M_THROW("ID3v1Tag::read(): ID3v1Tag::find() failed!");
         return false;
     }
 
     if(tag_pos == NOT_FOUND && show_warnings)
     {
         fclose(fin);
         cerr << "*** Warning --> ID3v1Tag::read(): could not find the ID3v1 'TAG'"
              << endl;
         return false;
     }
 
     // Seek to the tag.
     #ifdef NSOUND_PLATFORM_OS_WINDOWS
         fseek(fin, static_cast<long>(tag_pos), SEEK_SET);
     #else
         fseek(fin, tag_pos, SEEK_SET);
     #endif
 
     RawTag tag;
 
     memset(reinterpret_cast<char *>(&tag), 0, sizeof(RawTag));
 
     // Read the tag.
     if(sizeof(RawTag) != fread(tag.header, 1, sizeof(RawTag), fin))
     {
         fclose(fin);
         cerr << "*** Error --> ID3v1Tag::read(): failed to read the ID3v1 TAG!"
              << endl;
         return false;
     }
 
     fclose(fin);
 
     this->title.clear();
     this->artist.clear();
     this->album.clear();
     this->year.clear();
     this->comment.clear();
     this->genre = ' ';
 
     // Title
     for(uint32 i = 0; i < 30; ++i)
     {
         if(tag.title[i] != '\0') this->title += tag.title[i];
         else break;
     }
 
     // Artist
     for(uint32 i = 0; i < 30; ++i)
     {
         if(tag.artist[i] != '\0') this->artist += tag.artist[i];
         else break;
     }
 
     // Album
     for(uint32 i = 0; i < 30; ++i)
     {
         if(tag.album[i] != '\0') this->album += tag.album[i];
         else break;
     }
 
     // Year
     for(uint32 i = 0; i < 4; ++i)
     {
         if(tag.year[i] != '\0') this->year += tag.year[i];
         else break;
     }
 
     // Comment
     for(uint32 i = 0; i < 30; ++i)
     {
         if(tag.comment[i] != '\0') this->comment += tag.comment[i];
         else break;
     }
 
     // Genre
     this->genre = tag.genre;
 
     return true;
 }

boolean ID3v1Tag::write	(	const std::string &	filename,
		boolean	show_warnings = `true`
	)

Returns true if it successfully wrote the tag to the end of the file, false otherwise.

Definition at line 1764 of file Wavefile.cc.

References album, RawTag::album, artist, RawTag::artist, comment, RawTag::comment, findID3v1Tag(), genre, RawTag::genre, RawTag::header, IO_ERROR, M_THROW, MIN, NOT_FOUND, title, RawTag::title, year, and RawTag::year.

 {
     FILE * fin = fopen(filename.c_str(), "r+b");
 
     if(fin == NULL)
     {
         M_THROW("ID3v1Tag::write(): could not open the file '"
              << filename
              << "'");
         return false;
     }
 
     int64 tag_pos = findID3v1Tag(fin);
 
     if(tag_pos == IO_ERROR)
     {
        M_THROW("ID3v1Tag::write(): ID3v1Tag::find() failed!"
              << filename
              << "'");
         return false;
     }
 
     // If he tag wasn't found, just go to the end of the file.
     else if(tag_pos == NOT_FOUND)
     {
         fseek(fin, 0, SEEK_END);
     }
 
     // Seek to the tag.
     else
     {
         #ifdef NSOUND_PLATFORM_OS_WINDOWS
             fseek(fin, static_cast<long>(tag_pos), SEEK_SET);
         #else
             fseek(fin, tag_pos, SEEK_SET);
         #endif
     }
 
     RawTag tag;
 
     memset(reinterpret_cast<char *>(&tag), 0, sizeof(RawTag));
 
     tag.header[0] = 'T';
     tag.header[1] = 'A';
     tag.header[2] = 'G';
 
     #define MIN(a,b) ((a < b) ? a : b)
 
     // Title
     for(uint32 i = 0; i < MIN(30, this->title.size()); ++i)
     {
         tag.title[i] = this->title[i];
     }
 
     // Artist
     for(uint32 i = 0; i < MIN(30, this->artist.size()); ++i)
     {
         tag.artist[i] = this->artist[i];
     }
 
     // Album
     for(uint32 i = 0; i < MIN(30, this->album.size()); ++i)
     {
         tag.album[i] = this->album[i];
     }
 
     // Year
     for(uint32 i = 0; i < MIN(4, this->year.size()); ++i)
     {
         tag.year[i] = this->year[i];
     }
 
     // Comment
     for(uint32 i = 0; i < MIN(30, this->comment.size()); ++i)
     {
         tag.comment[i] = this->comment[i];
     }
 
     // Genre
     tag.genre = this->genre;
 
     // Write the tag.
     if(sizeof(RawTag) != fwrite(tag.header, 1, sizeof(RawTag), fin))
     {
         fclose(fin);
         M_THROW("ID3v1Tag::write(): failed to write the ID3v1Tag!");
         return false;
     }
 
     fclose(fin);
     return true;
 }