You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
146 lines
4.0 KiB
146 lines
4.0 KiB
/*
|
|
Copyright (C) 2002 Rik Hemsley (rikkus) <rik@kde.org>
|
|
Copyright (C) 2002 Benjamin Meyer <ben-devel@meyerhome.net>
|
|
Copyright (C) 2002-2004 Nadeem Hasan <nhasan@nadmm.com>
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Library General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Library General Public License
|
|
along with this library; see the file COPYING.LIB. If not, write to
|
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef KCDDB_CDINFO_H
|
|
#define KCDDB_CDINFO_H
|
|
|
|
#include <tqstringlist.h>
|
|
#include <tqvaluelist.h>
|
|
#include <kdemacros.h>
|
|
#include <tqvariant.h>
|
|
|
|
namespace KCDDB
|
|
{
|
|
/**
|
|
* Information about a sepecific track in a cd.
|
|
*/
|
|
class KDE_EXPORT TrackInfo
|
|
{
|
|
public:
|
|
|
|
TrackInfo();
|
|
~TrackInfo();
|
|
TrackInfo(const TrackInfo& clone);
|
|
TrackInfo& operator=(const TrackInfo& clone);
|
|
|
|
/**
|
|
* Get data for type that has been assigned to this track.
|
|
* @p type is case insensitive.
|
|
* For example <code>get("title")</code>
|
|
*/
|
|
TQVariant get(const TQString &type) const;
|
|
#ifndef KDE_NO_COMPAT
|
|
// Use get("title");
|
|
TQString title;
|
|
// Use get("extt");
|
|
TQString extt;
|
|
#endif
|
|
};
|
|
|
|
typedef TQValueList<TrackInfo> TrackInfoList;
|
|
|
|
/**
|
|
* Information about a CD
|
|
*
|
|
* Typically CDInfo is obtained from the client such as:
|
|
* <code>KCDDB::Client *cddb = new KCDDB::Client();
|
|
* cddb->lookup(discSignature);
|
|
* CDInfo info = cddb->bestLookupResponse();</code>
|
|
*/
|
|
class KDE_EXPORT CDInfo
|
|
{
|
|
public:
|
|
|
|
CDInfo();
|
|
~CDInfo();
|
|
CDInfo(const CDInfo& clone);
|
|
CDInfo& operator=(const CDInfo& clone);
|
|
|
|
/**
|
|
* Load CDInfo from a string that is CDDB compatible
|
|
* @return true if successful
|
|
*/
|
|
bool load(const TQString &);
|
|
/**
|
|
* Load CDInfo from a stringList that is CDDB compatible
|
|
* @return true if successful
|
|
*/
|
|
bool load(const TQStringList &);
|
|
|
|
/**
|
|
* Clear all information, setting this to invalid
|
|
* internal
|
|
*/
|
|
void clear();
|
|
|
|
/**
|
|
* @return true if the cd information is valid
|
|
*/
|
|
bool isValid() const;
|
|
/**
|
|
* @param submit If submit is true only returns CDDB compatible information
|
|
* @return a string containing all of the CD's information.
|
|
*/
|
|
TQString toString(bool submit=false) const;
|
|
|
|
/**
|
|
* Get data for type that has been assigned to this disc.
|
|
* @p type is case insensitive.
|
|
* For example <code>get("title")</code>
|
|
*/
|
|
TQVariant get(const TQString &type) const;
|
|
// Use get(...)
|
|
TQString id;
|
|
TQString artist;
|
|
TQString title;
|
|
TQString genre;
|
|
TQString category;
|
|
TQString extd;
|
|
uint year;
|
|
uint length; // in milliseconds
|
|
uint revision;
|
|
|
|
TrackInfoList trackInfoList;
|
|
|
|
protected:
|
|
/**
|
|
* @returns a valid CDDB line made up of name and value
|
|
*/
|
|
TQString createLine(const TQString& name, const TQString& value) const;
|
|
/**
|
|
* Checks to make sure that trackNumber exists
|
|
*/
|
|
void checkTrack( uint );
|
|
/**
|
|
* escape's string for CDDB processing
|
|
*/
|
|
static TQString escape( const TQString & );
|
|
/**
|
|
* fixes an escaped string that has been CDDB processed
|
|
*/
|
|
static TQString unescape( const TQString & );
|
|
};
|
|
|
|
typedef TQValueList<CDInfo> CDInfoList;
|
|
}
|
|
|
|
#endif // KCDDB_CDINFO_H
|