/usr/include/qmmp/output.h is in libqmmp-dev 0.7.4-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | // Copyright (c) 2000-2001 Brad Hughes <bhughes@trolltech.com>
//
// Use, modification and distribution is allowed without limitation,
// warranty, or liability of any kind.
//
#ifndef OUTPUT_H
#define OUTPUT_H
#include <QObject>
#include <QThread>
#include <QEvent>
#include <QList>
#include <QHash>
#include <QIODevice>
#include "visual.h"
#include "outputfactory.h"
#include "visualfactory.h"
#include "statehandler.h"
#include "audioparameters.h"
class QTimer;
class QmmpSettings;
/*! @brief The Output class provides the base interface class of audio outputs.
* @author Brad Hughes <bhughes@trolltech.com>
* @author Ilya Kotov <forkotov@hotmail.ru>
*/
class Output
{
public:
/*!
* Object contsructor.
*/
Output();
/*!
* Destructor.
*/
virtual ~Output();
/*!
* Prepares object for usage and setups required audio parameters.
* Subclass should reimplement this function.
* @param freq Sample rate.
* @param chan Number of channels.
* @param format Audio format
* @return initialization result (\b true - success, \b false - failure)
*/
virtual bool initialize(quint32 freq, int chan, Qmmp::AudioFormat format) = 0;
/*!
* Returns output interface latency in milliseconds.
*/
virtual qint64 latency() = 0;
/*!
* Requests playback to pause. If it was paused already, playback should resume.
* Subclasses that reimplement this function must call the base implementation.
*/
/*!
* Writes up to \b maxSize bytes from \b data to the output interface device.
* Returns the number of bytes written, or -1 if an error occurred.
* Subclass should reimplement this function.
*/
virtual qint64 writeAudio(unsigned char *data, qint64 maxSize) = 0;
/*!
* Writes all remaining plugin's internal data to audio output device.
* Subclass should reimplement this function.
*/
virtual void drain() = 0;
/*!
* Drops all plugin's internal data, resets audio device
* Subclass should reimplement this function.
*/
virtual void reset() = 0;
/*!
* Stops processing audio data, preserving buffered audio data.
*/
virtual void suspend();
/*!
* Resumes processing audio data.
*/
virtual void resume();
/*!
* Returns selected audio parameters.
*/
AudioParameters audioParameters() const;
/*!
* Returns samplerate.
*/
quint32 sampleRate();
/*!
* Returns channels number.
*/
int channels();
/*!
* Returns selected audio format.
*/
Qmmp::AudioFormat format() const;
/*!
* Returns sample size in bytes.
*/
int sampleSize() const;
/*!
* Creates selected output.
* @return Output subclass object.
*/
static Output *create();
/*!
* Returns a list of output factories.
*/
static QList<OutputFactory*> *factories();
/*!
* Returns plugin file path.
* @param factory Output plugin factory.
*/
static QString file(OutputFactory *factory);
/*!
* Selects current output \b factory.
*/
static void setCurrentFactory(OutputFactory* factory);
/*!
* Returns selected output factory.
*/
static OutputFactory *currentFactory();
protected:
/*!
* Use this function inside initialize() reimplementation to tell about accepted audio parameters.
* @param freq Sample rate.
* @param chan Number of channels.
* @param format Audio format.
*/
void configure(quint32 freq, int chan, Qmmp::AudioFormat format);
private:
quint32 m_frequency;
int m_channels;
Qmmp::AudioFormat m_format;
static void checkFactories();
static QList<OutputFactory*> *m_factories;
static QHash <OutputFactory*, QString> *m_files;
};
#endif // OUTPUT_H
|