summaryrefslogtreecommitdiffstats
path: root/libk3b/projects/audiocd/k3baudiodoc.h
diff options
context:
space:
mode:
Diffstat (limited to 'libk3b/projects/audiocd/k3baudiodoc.h')
-rw-r--r--libk3b/projects/audiocd/k3baudiodoc.h263
1 files changed, 263 insertions, 0 deletions
diff --git a/libk3b/projects/audiocd/k3baudiodoc.h b/libk3b/projects/audiocd/k3baudiodoc.h
new file mode 100644
index 0000000..87a512e
--- /dev/null
+++ b/libk3b/projects/audiocd/k3baudiodoc.h
@@ -0,0 +1,263 @@
+/*
+ *
+ * $Id: k3baudiodoc.h 619556 2007-01-03 17:38:12Z trueg $
+ * Copyright (C) 2003 Sebastian Trueg <trueg@k3b.org>
+ *
+ * This file is part of the K3b project.
+ * Copyright (C) 1998-2007 Sebastian Trueg <trueg@k3b.org>
+ *
+ * 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.
+ * See the file "COPYING" for the exact licensing terms.
+ */
+
+
+#ifndef K3BAUDIODOC_H
+#define K3BAUDIODOC_H
+
+#include <k3bdoc.h>
+
+#include <k3bcdtext.h>
+#include <k3btoc.h>
+
+#include <qptrlist.h>
+#include <qfile.h>
+#include <qstring.h>
+#include <qstringlist.h>
+#include <qdatetime.h>
+#include <qtextstream.h>
+#include "k3b_export.h"
+#include <kurl.h>
+
+class K3bApp;
+class K3bAudioTrack;
+class QWidget;
+class QTimer;
+class QDomDocument;
+class QDomElement;
+class K3bThreadJob;
+class KConfig;
+class K3bAudioDataSource;
+class K3bAudioDecoder;
+class K3bAudioFile;
+
+/**Document class for an audio project.
+ *@author Sebastian Trueg
+ */
+
+class LIBK3B_EXPORT K3bAudioDoc : public K3bDoc
+{
+ Q_OBJECT
+
+ friend class K3bMixedDoc;
+ friend class K3bAudioTrack;
+ friend class K3bAudioFile;
+
+ public:
+ K3bAudioDoc( QObject* );
+ ~K3bAudioDoc();
+
+ QString name() const;
+
+ bool newDocument();
+
+ bool hideFirstTrack() const { return m_hideFirstTrack; }
+ int numOfTracks() const;
+
+ bool normalize() const { return m_normalize; }
+
+ K3bAudioTrack* firstTrack() const;
+ K3bAudioTrack* lastTrack() const;
+
+ /**
+ * Slow.
+ * \return the K3bAudioTrack with track number trackNum starting at 1 or 0 if trackNum > numOfTracks()
+ */
+ K3bAudioTrack* getTrack( unsigned int trackNum );
+
+ /**
+ * Creates a new audiofile inside this doc which has no track yet.
+ */
+ K3bAudioFile* createAudioFile( const KURL& url );
+
+ /** get the current size of the project */
+ KIO::filesize_t size() const;
+ K3b::Msf length() const;
+
+ // CD-Text
+ bool cdText() const { return m_cdText; }
+ const QString& title() const { return m_cdTextData.title(); }
+ const QString& artist() const { return m_cdTextData.performer(); }
+ const QString& disc_id() const { return m_cdTextData.discId(); }
+ const QString& arranger() const { return m_cdTextData.arranger(); }
+ const QString& songwriter() const { return m_cdTextData.songwriter(); }
+ const QString& composer() const { return m_cdTextData.composer(); }
+ const QString& upc_ean() const { return m_cdTextData.upcEan(); }
+ const QString& cdTextMessage() const { return m_cdTextData.message(); }
+
+ /**
+ * Create complete CD-Text including the tracks' data.
+ */
+ K3bDevice::CdText cdTextData() const;
+
+ int audioRippingParanoiaMode() const { return m_audioRippingParanoiaMode; }
+ int audioRippingRetries() const { return m_audioRippingRetries; }
+ bool audioRippingIgnoreReadErrors() const { return m_audioRippingIgnoreReadErrors; }
+
+ /**
+ * Represent the structure of the doc as CD Table of Contents.
+ */
+ K3bDevice::Toc toToc() const;
+
+ K3bBurnJob* newBurnJob( K3bJobHandler*, QObject* parent = 0 );
+
+ /**
+ * Shows dialogs.
+ */
+ void informAboutNotFoundFiles();
+
+ /**
+ * returns the new after track, ie. the the last added track or null if
+ * the import failed.
+ *
+ * This is a blocking method.
+ *
+ * \param cuefile The Cuefile to be imported
+ * \param after The track after which the new tracks should be inserted
+ * \param decoder The decoder to be used for the new tracks. If 0 a new one will be created.
+ *
+ * BE AWARE THAT THE DECODER HAS TO FIT THE AUDIO FILE IN THE CUE.
+ */
+ K3bAudioTrack* importCueFile( const QString& cuefile, K3bAudioTrack* after, K3bAudioDecoder* decoder = 0 );
+
+ /**
+ * Create a decoder for a specific url. If another AudioFileSource with this
+ * url is already part of this project the associated decoder is returned.
+ *
+ * In the first case the decoder will not be initialized yet (K3bAudioDecoder::analyseFile
+ * is not called yet).
+ *
+ * \param url The url for which a decoder is requested.
+ * \param reused If not null this variable is set to true if the decoder is already in
+ * use and K3bAudioDecoder::analyseFile() does not have to be called anymore.
+ */
+ K3bAudioDecoder* getDecoderForUrl( const KURL& url, bool* reused = 0 );
+
+ static bool readPlaylistFile( const KURL& url, KURL::List& playlist );
+
+ public slots:
+ void addUrls( const KURL::List& );
+ void addTrack( const KURL&, uint );
+ void addTracks( const KURL::List&, uint );
+ /**
+ * Adds a track without any testing
+ *
+ * Slow because it uses getTrack.
+ */
+ void addTrack( K3bAudioTrack* track, uint position = 0 );
+
+ void addSources( K3bAudioTrack* parent, const KURL::List& urls, K3bAudioDataSource* sourceAfter = 0 );
+
+ void removeTrack( K3bAudioTrack* );
+ void moveTrack( K3bAudioTrack* track, K3bAudioTrack* after );
+
+ void setHideFirstTrack( bool b ) { m_hideFirstTrack = b; }
+ void setNormalize( bool b ) { m_normalize = b; }
+
+ // CD-Text
+ void writeCdText( bool b ) { m_cdText = b; }
+ void setTitle( const QString& v );
+ void setArtist( const QString& v );
+ void setPerformer( const QString& v );
+ void setDisc_id( const QString& v );
+ void setArranger( const QString& v );
+ void setSongwriter( const QString& v );
+ void setComposer( const QString& v );
+ void setUpc_ean( const QString& v );
+ void setCdTextMessage( const QString& v );
+
+ // Audio-CD Ripping
+ void setAudioRippingParanoiaMode( int i ) { m_audioRippingParanoiaMode = i; }
+ void setAudioRippingRetries( int r ) { m_audioRippingRetries = r; }
+ void setAudioRippingIgnoreReadErrors( bool b ) { m_audioRippingIgnoreReadErrors = b; }
+
+ void removeCorruptTracks();
+
+ private slots:
+ void slotTrackChanged( K3bAudioTrack* );
+ void slotTrackRemoved( K3bAudioTrack* );
+
+ signals:
+ void trackChanged( K3bAudioTrack* );
+ void trackRemoved( K3bAudioTrack* );
+
+ protected:
+ /** reimplemented from K3bDoc */
+ bool loadDocumentData( QDomElement* );
+ /** reimplemented from K3bDoc */
+ bool saveDocumentData( QDomElement* );
+
+ QString typeString() const;
+
+ private:
+ // the stuff for adding files
+ // ---------------------------------------------------------
+ K3bAudioTrack* createTrack( const KURL& url );
+
+ /**
+ * Handle directories and M3u files
+ */
+ KURL::List extractUrlList( const KURL::List& urls );
+ // ---------------------------------------------------------
+
+ /**
+ * Used by K3bAudioTrack to update the track list
+ */
+ void setFirstTrack( K3bAudioTrack* track );
+ /**
+ * Used by K3bAudioTrack to update the track list
+ */
+ void setLastTrack( K3bAudioTrack* track );
+
+ /**
+ * Used by K3bAudioFile to tell the doc that it does not need the decoder anymore.
+ */
+ void decreaseDecoderUsage( K3bAudioDecoder* );
+ void increaseDecoderUsage( K3bAudioDecoder* );
+
+ K3bAudioTrack* m_firstTrack;
+ K3bAudioTrack* m_lastTrack;
+
+ bool m_hideFirstTrack;
+ bool m_normalize;
+
+ KURL::List m_notFoundFiles;
+ KURL::List m_unknownFileFormatFiles;
+
+ // CD-Text
+ // --------------------------------------------------
+ K3bDevice::CdText m_cdTextData;
+ bool m_cdText;
+ // --------------------------------------------------
+
+ // Audio ripping
+ int m_audioRippingParanoiaMode;
+ int m_audioRippingRetries;
+ bool m_audioRippingIgnoreReadErrors;
+
+ //
+ // decoder housekeeping
+ // --------------------------------------------------
+ // used to check if we may delete a decoder
+ QMap<K3bAudioDecoder*, int> m_decoderUsageCounterMap;
+ // used to check if we already have a decoder for a specific file
+ QMap<QString, K3bAudioDecoder*> m_decoderPresenceMap;
+
+ class Private;
+ Private* d;
+};
+
+
+#endif