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, 126 insertions, 0 deletions

diff --git a/kioslave/audiocd/audiocd.h b/kioslave/audiocd/audiocd.h
new file mode 100644
index 00000000..a9038496
--- /dev/null
+++ b/kioslave/audiocd/audiocd.h
@@ -0,0 +1,126 @@
+/*
+ * Copyright (C) 2000 Rik Hemsley (rikkus) <rik@kde.org>
+ * Copyright (C) 2000, 2001, 2002 Michael Matz <matz@kde.org>
+ * Copyright (C) 2001 Carsten Duvenhorst <duvenhorst@m2.uni-hannover.de>
+ * Copyright (C) 2001 Adrian Schroeter <adrian@suse.de>
+ * Copyright (C) 2003 Richard Lärkäng <richard@goteborg.utfors.se>
+ * Copyright (C) 2003 Scott Wheeler <wheeler@kde.org>
+ * Copyright (C) 2004, 2005 Benjamin Meyer <ben at meyerhome dot net>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * ERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#ifndef AUDIO_CD_H
+#define AUDIO_CD_H
+
+#include <kio/slavebase.h>
+
+class AudioCDEncoder;
+
+struct cdrom_drive;
+
+namespace AudioCD {
+
+/**
+ * The core class of the audiocd:// ioslave.
+ * It has the iosalve login and the ripping logic. The actual encoding
+ * is done by encoders that are seperate objects.
+ */
+class AudioCDProtocol : public KIO::SlaveBase
+{
+	public:
+
+	AudioCDProtocol(const QCString & protocol, const QCString & pool, const QCString & app);
+	virtual ~AudioCDProtocol();
+
+	virtual void get(const KURL &);
+	virtual void stat(const KURL &);
+	virtual void listDir(const KURL &);
+
+	protected:
+	AudioCDEncoder *encoderFromExtension(const QString& extension);
+	AudioCDEncoder *determineEncoder(const QString & filename);
+
+	struct cdrom_drive *findDrive(bool &noPermission);
+	void parseURLArgs(const KURL &);
+
+	void loadSettings();
+
+	/**
+	 * From the request information (Private member "d"),
+	 * get the first and last sector for the request.
+	 * return false if the parameters are invalid (for instance,
+	 * track number which does not exist on this CD)
+	 */
+	bool getSectorsForRequest(struct cdrom_drive * drive,
+	                          long & firstSector, long & lastSector) const;
+
+	/**
+	 * Give the size in bytes of the space between those two
+	 * sectors, depending on the file type.
+	 */
+	long fileSize(long firstSector, long lastSector, AudioCDEncoder *encoder);
+
+	/**
+	 * The heart of this ioslave.
+	 * Reads data off the cd and then passes it to an encoder to encode
+	 */
+	void paranoiaRead(
+		struct cdrom_drive * drive,
+		long firstSector,
+		long lastSector,
+		AudioCDEncoder* encoder,
+		const QString& fileName,
+		unsigned long size
+	);
+
+	struct cdrom_drive *initRequest(const KURL &);
+	uint discid(struct cdrom_drive *);
+
+	/**
+	 * Add an entry in the KIO directory, using the title you give,
+	 * it will set the extension itself depending on the fileType.
+	 * You must also give the trackNumber for the size of the file
+	 * to be calculated.
+	 * NOTE: if you want to add a file which is the whole CD, give
+	 * trackNo = -1
+	 * NOTE2: you can safely add MP3 or OGG files always. the function
+	 * will check if kio_audiocd was compiled with support for those,
+	 * so NO NEED to wrap your calls with #ifdef for lame or vorbis.
+	 * this function will do the right thing.
+	 */
+	void addEntry(const QString& trackTitle, AudioCDEncoder *encoder,
+	struct cdrom_drive * drive, int trackNo);
+
+	class Private;
+	Private * d;
+
+private:
+
+	void generateTemplateTitles();
+
+	QPtrList<AudioCDEncoder> encoders;
+	cdrom_drive * getDrive();
+
+	// These are the only garenteed encoders to be built, the rest
+	// are dynamic depending on other libraries on the system
+	AudioCDEncoder *encoderTypeCDA;
+	AudioCDEncoder *encoderTypeWAV;
+};
+
+} // end namespace AudioCD
+
+#endif // AUDIO_CD_H
+