File: VirtualAudioFile.h

package info (click to toggle)
kwave 25.04.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 23,272 kB
  • sloc: cpp: 56,173; xml: 817; perl: 688; sh: 57; makefile: 11
file content (123 lines) | stat: -rw-r--r-- 4,030 bytes parent folder | download
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
/*************************************************************************
     VirtualAudioFile.h  -  adapter between QIODevice and libaudiofile
                             -------------------
    begin                : Mon May 06 2002
    copyright            : (C) 2002 by Thomas Eschenbacher
    email                : 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 VIRTUAL_AUDIO_FILE_H
#define VIRTUAL_AUDIO_FILE_H

#include "config.h"
#include "libkwave_export.h"

#include <QtGlobal>
#include <QMap>

extern "C" {
}
#include <af_vfs.h>
#include <audiofile.h>

class QIODevice;

namespace Kwave
{

    /**
     * This class builds an interface between a QIODevice and a virtual
     * file in libaudiofile.
     */
    class LIBKWAVE_EXPORT VirtualAudioFile
    {
    public:
        /**
         * Constructor
         * @param device QIODevice used as source/destination
         */
        explicit VirtualAudioFile(QIODevice &device);

        /** Destructor */
        virtual ~VirtualAudioFile();

        /** opens the file through libaudiofile */
        virtual void open(Kwave::VirtualAudioFile *x, AFfilesetup setup);

        /**
         * Closes the file from libaudiofile side. The associated
         * QIODevice will not be touched.
         * @note This has not necessarily to be called, it will closed
         *       automatically in the destructor.
         */
        virtual void close();

        /** Returns the handle for use in libaudiofile */
        inline AFfilehandle &handle() { return m_file_handle; }

        /** Returns the virtual file for use in libaudiofile */
        inline AFvirtualfile *file() { return m_virtual_file; }

        /** Returns the last error from libaudiofile (-1 means "no error") */
        inline long int lastError() { return m_last_error; }

        /**
         * returns the last error text from libaudiofile, not localized
         * @note this is only valid in case of lastError is not -1
         */
        inline QString lastErrorText() { return m_last_error_text; }

        /** reads a block of data */
        virtual qint64 read(char *data, unsigned int nbytes);

        /** returns the length of the file */
        virtual qint64 length();

        /** writes a block of data */
        virtual qint64 write(const char *data, unsigned int nbytes);

        /** called to close the source */
        virtual void destroy();

        /** seek to a file position */
        virtual qint64 seek(qint64 offset, bool is_relative);

        /** returns the file position */
        virtual qint64 tell();

        /** returns a VirtualAudioFile for a libasound virtual file */
        static Kwave::VirtualAudioFile *adapter(AFvirtualfile *vfile);

    private:

        /** i/o device to Qt */
        QIODevice &m_device;

        /** file handle used in libaudiofile */
        AFfilehandle m_file_handle;

        /** virtual file, used in libaudiofile */
        AFvirtualfile *m_virtual_file;

        /** last error code from libaudiofile */
        long int m_last_error;

        /** last error text from libaudiofile */
        QString m_last_error_text;

    };
}

#endif /* VIRTUAL_AUDIO_FILE_H */

//***************************************************************************
//***************************************************************************