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 = nullptr);
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;
83  const 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();
113  void setProperty(Qmmp::TrackProperty key, const QVariant &value);
118  void setProperties(const QMap<Qmmp::TrackProperty, QString> &properties);
122  const QMap<Qmmp::TrackProperty, QString> &properties() const;
128  static DecoderFactory *findByFilePath(const QString &path, bool useContent = false);
132  static DecoderFactory *findByMime(const QString &mime);
137  static DecoderFactory *findByContent(QIODevice *input);
141  static DecoderFactory *findByProtocol(const QString &p);
146  static QList<DecoderFactory *> findByFileExtension(const QString &path);
150  static QList<DecoderFactory*> factories();
154  static QList<DecoderFactory*> enabledFactories();
158  static QStringList nameFilters();
162  static QStringList contentTypes();
167  static QString file(const DecoderFactory *factory);
172  static QStringList protocols();
178  static void setEnabled(DecoderFactory *factory, bool enable = true);
183  static bool isEnabled(const DecoderFactory* factory);
184 
185 protected:
192  void configure(quint32 srate, const ChannelMap &map, Qmmp::AudioFormat f = Qmmp::PCM_S16LE);
199  void configure(quint32 srate, int channels, Qmmp::AudioFormat f = Qmmp::PCM_S16LE);
204  void configure(const AudioParameters &p);
205 
206 private:
207  static void loadPlugins();
208  static QList<QmmpPluginCache*> *m_cache;
209  static QStringList m_disabledNames;
210  AudioParameters m_parameters;
211  QMap<Qmmp::TrackProperty, QString> m_properties;
212  QIODevice *m_input;
213  bool m_hasMetaData = false;
214  QMap<Qmmp::MetaData, QString> m_metaData;
215  QMap <Qmmp::ReplayGainKey, double> m_rg; //replay gain information
216 };
217 
218 #endif // DECODER_H
The AudioParameters class keeps information about audio settings.
Definition: audioparameters.h:32
This class represents audio channel mapping.
Definition: channelmap.h:31
Input plugin interface (decoder factory).
Definition: decoderfactory.h:54
The Decoder class provides the base interface class of audio decoders.
Definition: decoder.h:26
void setProperties(const QMap< Qmmp::TrackProperty, QString > &properties)
static QStringList nameFilters()
static QList< DecoderFactory * > factories()
static DecoderFactory * findByMime(const QString &mime)
static QStringList protocols()
static QStringList contentTypes()
const QMap< Qmmp::ReplayGainKey, double > & replayGainInfo() const
void setProperty(Qmmp::TrackProperty key, const QVariant &value)
virtual ~Decoder()
virtual bool initialize()=0
QIODevice * input()
static DecoderFactory * findByProtocol(const QString &p)
void addMetaData(const QMap< Qmmp::MetaData, QString > &metaData)
void configure(const AudioParameters &p)
static DecoderFactory * findByContent(QIODevice *input)
virtual int bitrate() const =0
virtual void next()
bool hasMetaData() const
virtual qint64 read(unsigned char *data, qint64 maxSize)=0
Decoder(QIODevice *input=nullptr)
void configure(quint32 srate, const ChannelMap &map, Qmmp::AudioFormat f=Qmmp::PCM_S16LE)
static QList< DecoderFactory * > findByFileExtension(const QString &path)
void configure(quint32 srate, int channels, Qmmp::AudioFormat f=Qmmp::PCM_S16LE)
virtual const QString nextURL() const
static QString file(const DecoderFactory *factory)
static void setEnabled(DecoderFactory *factory, bool enable=true)
const AudioParameters & audioParameters() const
static bool isEnabled(const DecoderFactory *factory)
static QList< DecoderFactory * > enabledFactories()
const QMap< Qmmp::TrackProperty, QString > & properties() const
virtual void seek(qint64 time)=0
QMap< Qmmp::MetaData, QString > takeMetaData()
static DecoderFactory * findByFilePath(const QString &path, bool useContent=false)
virtual qint64 totalTime() const =0
void setReplayGainInfo(const QMap< Qmmp::ReplayGainKey, double > &rg)
TrackProperty
Definition: qmmp.h:91
AudioFormat
Definition: qmmp.h:115
@ PCM_S16LE
Definition: qmmp.h:119