Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdemultimedia@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

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