Qmmp
decoder.h
1 // Copyright (c) 2000-2001 Brad Hughes <bhughes@trolltech.com>
2 //
3 // Use, modification and distribution is allowed without limitation,
4 // warranty, or liability of any kind.
5 //
6 
7 #ifndef DECODER_H
8 #define DECODER_H
9 
10 #include <QStringList>
11 #include <QList>
12 #include <QMap>
13 #include <QIODevice>
14 #include "qmmp.h"
15 #include "audioparameters.h"
16 #include "channelmap.h"
17 
18 class QmmpPluginCache;
19 class DecoderFactory;
20 
25 class QMMP_EXPORT Decoder
26 {
27 public:
32  Decoder(QIODevice *input = 0);
36  virtual ~Decoder();
41  virtual bool initialize() = 0;
46  virtual qint64 totalTime() const = 0;
51  virtual void seek(qint64 time) = 0;
57  virtual qint64 read(unsigned char *data, qint64 maxSize) = 0;
62  virtual int bitrate() const = 0;
69  virtual void next();
75  virtual const QString nextURL() const;
79  AudioParameters audioParameters() const;
83  QMap<Qmmp::ReplayGainKey, double> replayGainInfo() const;
88  void setReplayGainInfo(const QMap<Qmmp::ReplayGainKey,double> &rg);
92  QIODevice *input();
98  void addMetaData(const QMap<Qmmp::MetaData, QString> &metaData);
102  bool hasMetaData() const;
107  QMap<Qmmp::MetaData, QString> takeMetaData();
108  void setProperty(Qmmp::TrackProperty key, const QVariant &value);
109  void setProperties(const QMap<Qmmp::TrackProperty, QString> &properties);
110  const QMap<Qmmp::TrackProperty, QString> &properties() const;
116  static DecoderFactory *findByFilePath(const QString &path, bool useContent = false);
120  static DecoderFactory *findByMime(const QString &mime);
125  static DecoderFactory *findByContent(QIODevice *input);
129  static DecoderFactory *findByProtocol(const QString &p);
134  static QList<DecoderFactory *> findByFileExtension(const QString &path);
138  static QList<DecoderFactory*> factories();
142  static QList<DecoderFactory*> enabledFactories();
147  static QString file(DecoderFactory *factory);
152  static QStringList protocols();
158  static void setEnabled(DecoderFactory* factory, bool enable = true);
163  static bool isEnabled(DecoderFactory* factory);
164 
165 protected:
172  void configure(quint32 srate, const ChannelMap &map, Qmmp::AudioFormat f = Qmmp::PCM_S16LE);
179  void configure(quint32 srate, int channels, Qmmp::AudioFormat f = Qmmp::PCM_S16LE);
184  void configure(const AudioParameters &p);
185 
186 private:
187  static void loadPlugins();
188  static QList<QmmpPluginCache*> *m_cache;
189  static QStringList m_disabledNames;
190  AudioParameters m_parameters;
191  QMap<Qmmp::TrackProperty, QString> m_properties;
192  QIODevice *m_input;
193  bool m_hasMetaData;
194  QMap<Qmmp::MetaData, QString> m_metaData;
195  QMap <Qmmp::ReplayGainKey, double> m_rg; //replay gain information
196 };
197 
198 #endif // DECODER_H
Definition: qmmp.h:110
The AudioParameters class keeps information about audio settings.
Definition: audioparameters.h:31
Input plugin interface (decoder factory).
Definition: decoderfactory.h:64
The Decoder class provides the base interface class of audio decoders.
Definition: decoder.h:25
AudioFormat
Definition: qmmp.h:105
TrackProperty
Definition: qmmp.h:81