1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
/***************************************************************************
Decoder.h - abstract base class of all decoders
-------------------
begin : Mar 10 2002
copyright : (C) 2002 by Thomas Eschenbacher
email : Thomas Eschenbacher <thomas.eschenbacher@gmx.de>
***************************************************************************/
/***************************************************************************
* *
* 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. *
* *
***************************************************************************/
#ifndef DECODER_H
#define DECODER_H
#include "config.h"
#include "libkwave_export.h"
#include <QtGlobal>
#include <QObject>
#include "libkwave/CodecBase.h"
#include "libkwave/MetaDataList.h"
class QIODevice;
class QWidget;
namespace Kwave
{
class MultiWriter;
class LIBKWAVE_EXPORT Decoder: public QObject, public Kwave::CodecBase
{
Q_OBJECT
public:
/** Constructor */
Decoder();
/** Destructor */
~Decoder() override;
/** Returns a new instance of the decoder */
virtual Decoder *instance() = 0;
/**
* Opens the source and decodes the header information.
* @param widget a widget that can be used for displaying
* message boxes or dialogs
* @param source file or other source with a stream of bytes
* @return true if succeeded, false on errors
*/
virtual bool open(QWidget *widget, QIODevice &source) = 0;
/**
* Decodes a stream of bytes into a signal
* @param widget a widget that can be used for displaying
* message boxes or dialogs
* @param dst writer that receives the audio data
* @return true if succeeded, false on errors
*/
virtual bool decode(QWidget *widget, Kwave::MultiWriter &dst) = 0;
/**
* Closes the io device.
*/
virtual void close() = 0;
/**
* Returns the meta data of the file, only valid after
* open() has successfully been called.
*/
virtual inline Kwave::MetaDataList &metaData() { return m_meta_data; }
signals:
/**
* Can be used to signal the current position within the source
* when a stream without info about the resulting signal is
* processed.
* @param pos current position within the source, in bytes!
*/
void sourceProcessed(quint64 pos);
protected:
/** meta data of the file */
Kwave::MetaDataList m_meta_data;
};
}
#endif /* DECODER_H */
//***************************************************************************
//***************************************************************************
|
