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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
/***************************************************************************
MimeData.h - mime data container for Kwave's audio data
-------------------
begin : Oct 04 2008
copyright : (C) 2008 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 MIME_DATA_H
#define MIME_DATA_H
#include "config.h"
#include "libkwave_export.h"
#include <QtGlobal>
#include <QByteArray>
#include <QIODevice>
#include <QMimeData>
#include <QObject>
#include "libkwave/Sample.h"
#include "libkwave/Utils.h"
class QWidget;
namespace Kwave
{
class MetaDataList;
class MultiTrackReader;
class SignalManager;
class LIBKWAVE_EXPORT MimeData: public QMimeData
{
Q_OBJECT
public:
/** Constructor */
MimeData();
/** Destructor */
~MimeData() override;
/**
* Encodes wave data received from a MultiTrackReader into a byte
* array that is compatible with the format of a wav file.
* @param widget the widget used as parent for displaying
* error messages
* @param src source of the samples
* @param meta_data information about the signal, sample rate,
* resolution and other meta data
* @return true if successful
*/
virtual bool encode(QWidget *widget,
Kwave::MultiTrackReader &src,
const Kwave::MetaDataList &meta_data);
/**
* Decodes the encoded byte data of the given mime source and
* initializes a MultiTrackReader.
* @param widget the widget used for displaying error messages
* @param e source with encoded mime data
* @param sig signal that receives the mime data
* @param pos position within the signal where to insert the data
* @return number of decoded samples if successful, zero if failed
*/
static sample_index_t decode(QWidget *widget, const QMimeData *e,
Kwave::SignalManager &sig,
sample_index_t pos);
/**
* Clears the content, makes the storage an empty byte array
*/
virtual void clear();
private:
/**
* interal class for buffering huge amounts of mime data.
* Used as a "write only" stream, after writing the data can be
* memory mapped and accessed through a QByteArray.
*/
class Buffer: public QIODevice
{
public:
/** Constructor */
Buffer();
/** Destructor, closes the buffer */
~Buffer() override;
/** returns the number of bytes written */
qint64 size() const override { return m_size; }
/**
* Try to map the memory to a QByteArray
*/
bool mapToByteArray();
/**
* Returns the mapped data as a QByteArray
*/
inline const QByteArray &byteArray() const { return m_data; }
/**
* Closes the buffer and frees the memory
* (calling multiple times is allowed)
*/
void close() override;
protected:
/**
* read a block of data from the buffer
*
* @param data buffer that receives the data
* @param maxlen maximum number of bytes to read
* @return number of bytes read or -1 if failed
*/
virtual qint64 readData(char *data, qint64 maxlen)
override;
/**
* write a block of data, internally increments the buffer
* size if necessary
*
* @param data pointer to a buffer with data to write
* @param len number of bytes to write
* @return number of bytes written or -1 if failed
*/
virtual qint64 writeData(const char *data, qint64 len)
override;
private:
/** block of memory */
QByteArray *m_block;
/** number of total bytes written */
qint64 m_size;
/** simple array for storage of the wave data */
QByteArray m_data;
};
private:
/** buffer for the mime data (with swap file support) */
Kwave::MimeData::Buffer m_buffer;
};
}
#endif /* MIME_DATA_H */
//***************************************************************************
//***************************************************************************
|
