File: MultiTrackReader.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 (133 lines) | stat: -rw-r--r-- 4,098 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
124
125
126
127
128
129
130
131
132
133
/***************************************************************************
      MultiTrackReader.h - reader for multi-track signals
                             -------------------
    begin                : Sat Jun 30 2001
    copyright            : (C) 2001 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 MULTI_TRACK_READER_H
#define MULTI_TRACK_READER_H

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

#include <QtGlobal>
#include <QList>
#include <QObject>
#include <QVector>

#include "libkwave/MultiTrackSource.h"
#include "libkwave/SampleReader.h"

namespace Kwave
{

    class SignalManager;

    /**
     * A MultiTrackReader encapsulates a set of <c>SampleReader</c>s for
     * easier use of multi-track signals.
     */
    class LIBKWAVE_EXPORT MultiTrackReader
        :public Kwave::MultiTrackSource<Kwave::SampleReader, false>
    {
        Q_OBJECT
    private:

        /** Default constructor */
        MultiTrackReader();

    public:

        /**
         * Constructor
         * @param mode a reader mode, see Kwave::ReaderMode
         * @param signal_manager reference to a SignalManager
         * @param track_list array of indices of tracks for writing
         * @param first index of the first sample (left)
         * @param last index of the last sample (right)
         */
        MultiTrackReader(Kwave::ReaderMode mode,
                        Kwave::SignalManager &signal_manager,
                        const QVector<unsigned int> &track_list,
                        sample_index_t first, sample_index_t last);

        /** Destructor */
        ~MultiTrackReader() override;

        /**
         * Returns the offset of the reader, as
         * passed to the constructor as "first"
         */
        virtual sample_index_t first() const;

        /**
         * Returns the last sample offset of the reader, as
         * passed to the constructor as "last"
         */
        virtual sample_index_t last() const;

        /** Returns true if one of the readers has reached eof() */
        virtual bool eof() const;

        /** @see QList::isEmpty() */
        inline virtual bool isEmpty() const {
            return (Kwave::MultiTrackSource<Kwave::SampleReader,
                    false>::tracks() < 1);
        }

        /** @see QList::insert() */
        virtual bool insert(unsigned int track, Kwave::SampleReader *reader)
            override;

        /** Skips a number of samples. */
        virtual void skip(sample_index_t count);

        /** Seeks to a given position */
        virtual void seek(sample_index_t pos);

    signals:

        /**
         * Emits the current progress in percent [0...100].
         */
        void progress(qreal percent);

    public slots:

        /** Resets all readers to zero */
        void reset();

    private slots:

        /**
         * Connected to each SampleReader to get informed about their progress.
         */
        void proceeded();

    protected:

        /** index of the first sample to read */
        sample_index_t m_first;

        /** index of the last sample to read */
        sample_index_t m_last;

    };
}

#endif /* MULTI_TRACK_READER_H */

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