summaryrefslogtreecommitdiffstats
path: root/libkcddb/cddb.h
diff options
context:
space:
mode:
Diffstat (limited to 'libkcddb/cddb.h')
-rw-r--r--libkcddb/cddb.h92
1 files changed, 92 insertions, 0 deletions
diff --git a/libkcddb/cddb.h b/libkcddb/cddb.h
new file mode 100644
index 00000000..b32821de
--- /dev/null
+++ b/libkcddb/cddb.h
@@ -0,0 +1,92 @@
+/*
+ Copyright (C) 2002 Rik Hemsley (rikkus) <rik@kde.org>
+ Copyright (C) 2002 Benjamin Meyer <ben-devel@meyerhome.net>
+ CopyRight (C) 2002 Nadeem Hasan <nhasan@kde.org>
+
+ 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., 59 Temple Place - Suite 330,
+ Boston, MA 02111-1307, USA.
+*/
+
+#ifndef KCDDB_CDDB_H
+#define KCDDB_CDDB_H
+
+#include <qstring.h>
+#include <qpair.h>
+#include <qvaluelist.h>
+
+#include <kdelibs_export.h>
+
+/** The KCDDB namespace collects all the CDDB-related classes and methods. */
+namespace KCDDB
+{
+ /** This list is used to calculate the CDDB disc id.
+ Insert the start frames ((minute*60 + seconds)*75+frames)
+ of all tracks, followed by the first frame of the disc and the last
+ frame of the disc. The first frame is for most audio CD's the same
+ as the first frame of the first track, the
+ last one is the start frame of the leadout track.
+ */
+ typedef QValueList<uint> TrackOffsetList;
+
+ /** This is just a container class used for interpreting results
+ of CDDB queries.
+ */
+ class KDE_EXPORT CDDB
+ {
+ public:
+
+ enum Result
+ {
+ Success,
+ ServerError,
+ HostNotFound,
+ NoResponse,
+ NoRecordFound,
+ MultipleRecordFound,
+ CannotSave,
+ InvalidCategory,
+ UnknownError
+ };
+
+ CDDB();
+ virtual ~CDDB();
+
+ static QString resultToString(Result);
+ static QString trackOffsetListToId( const TrackOffsetList & );
+
+ static QString clientName() { return QString::fromLatin1("libkcddb"); }
+ static QString clientVersion() { return QString::fromLatin1("0.31"); }
+
+ protected:
+ bool parseGreeting( const QString & );
+ bool parseHandshake( const QString & );
+
+ uint statusCode( const QString & );
+
+ QString trackOffsetListToId();
+ QString trackOffsetListToString();
+
+ QString user_;
+ QString localHostName_;
+
+ bool readOnly_;
+
+ TrackOffsetList trackOffsetList_;
+ };
+}
+
+#endif // KCDDB_CDDB_H
+
+// vim:tabstop=2:shiftwidth=2:expandtab:cinoptions=(s,U1,m1