File: Encoder.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 (87 lines) | stat: -rw-r--r-- 3,140 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
/***************************************************************************
              Encoder.h  -  abstract base class of all encoders
                             -------------------
    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 ENCODER_H
#define ENCODER_H

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

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

#include "libkwave/CodecBase.h"
#include "libkwave/FileInfo.h"

class QIODevice;
class QWidget;

namespace Kwave
{

    class MultiTrackReader;

    class LIBKWAVE_EXPORT Encoder: public QObject, public Kwave::CodecBase
    {
        Q_OBJECT
    public:
        /** Constructor */
        Encoder();

        /** Destructor */
        ~Encoder() override {}

        /** Returns a new instance of the encoder */
        virtual Encoder *instance() = 0;

        /**
         * Encodes a signal into a stream of bytes.
         * @param widget a widget that can be used for displaying
         *        message boxes or dialogs
         * @param src MultiTrackReader used as source of the audio data
         * @param dst file or other source to receive a stream of bytes
         * @param meta_data meta data of the file to save
         * @return true if succeeded, false on errors
         */
        virtual bool encode(QWidget *widget,
                            Kwave::MultiTrackReader &src,
                            QIODevice &dst,
                            const Kwave::MetaDataList &meta_data) = 0;

        /** Returns a list of supported file properties */
        virtual QList<Kwave::FileProperty> supportedProperties() {
            QList<Kwave::FileProperty> empty;
            return empty;
        }

        /**
         * Returns a list of all properties within a list of properties
         * which are not supported by this encoder
         * @param properties_to_check list of properties to check
         * @return list of unsupported properties (may be empty)
         */
        virtual QList<Kwave::FileProperty> unsupportedProperties(
            const QList<Kwave::FileProperty> &properties_to_check
        );
    };
}

#endif /* ENCODER_H */

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