/usr/include/phonon4qt5/phonon/pulsesupport.h is in libphonon4qt5-dev 4:4.8.3-0ubuntu3.
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 | /* This file is part of the KDE project
Copyright (C) 2009 Colin Guthrie <cguthrie@mandriva.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) version 3, or any
later version accepted by the membership of KDE e.V. (or its
successor approved by the membership of KDE e.V.), Nokia Corporation
(or its successors, if any) and the KDE Free Qt Foundation, which shall
act as a proxy defined in Section 6 of version 3 of the license.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef PHONON_PULSESUPPORT_H
#define PHONON_PULSESUPPORT_H
#include "phonon_export.h"
#include "phononnamespace.h"
#include "objectdescription.h"
#include <QtCore/QtGlobal>
#include <QtCore/QSet>
namespace Phonon
{
class PulseStream;
class PHONON_EXPORT PulseSupport : public QObject
{
Q_OBJECT
public:
/**
* \returns the instance pointer or null, see note.
* \note If \param allowNull is \c true and the instance was already
* shut down this function instead returns to indicate that
* the instance was already shut down.
* If \param allowNull is \c false and the instance was already
* shut down a dummy instance is returned instead. This case
* will furthermore result in a qWarning being printed, so
* when possible and sensible null handling should be done
* to prevent this.
*/
static PulseSupport *getInstanceOrNull(bool allowNull = false);
/** This function behaves like getInstanceOrNull(false). \see getInstanceOrNull */
static PulseSupport *getInstance();
static void shutdown();
bool isActive();
void enable(bool enabled = true);
QList<int> objectDescriptionIndexes(ObjectDescriptionType type) const;
QHash<QByteArray, QVariant> objectDescriptionProperties(ObjectDescriptionType type, int index) const;
QList<int> objectIndexesByCategory(ObjectDescriptionType type, Category category) const;
QList<int> objectIndexesByCategory(ObjectDescriptionType type, CaptureCategory category) const;
void setOutputDevicePriorityForCategory(Category category, QList<int> order);
void setCaptureDevicePriorityForCategory(CaptureCategory category, QList<int> order);
PHONON_DEPRECATED void setCaptureDevicePriorityForCategory(Category category, QList<int> order);
PulseStream *registerOutputStream(QString streamUuid, Category category);
PulseStream *registerCaptureStream(QString streamUuid, CaptureCategory category);
PHONON_DEPRECATED PulseStream *registerCaptureStream(QString streamUuid, Category category);
/**
* Whenever possible this function should be used to get Phonon
* specific PulseAudio stream properties and set them on specific
* streams. When precisely setting them per stream is not possible
* the envrionment setup function PulseSupport::setupStreamEnvironment
* should be called as close to stream creation as possible. The
* more time passes between setup and stream creation the more
* likely race conditions between setup of more than one AudioOutput
* will appear.
*
* \param streamUuid the AudioOutputs' stream UUID set by the frontend through
* AudioOutputInterface47::setStreamUuid
*
* \returns a hash of all properties set by setupStreamEnvironment
*
* \see setupStreamEnvironment
* \since 4.7.0
*/
QHash<QString, QString> streamProperties(QString streamUuid) const;
/**
* Sets PulseAudio override properties in the process' envrionment.
* Manually setting the properties on a per-stream basis is
* preferred as envrionment overrides are subject to race conditions
* when creating more than one stream around the same time.
*
* \param streamUuid the AudioOutputs' stream UUID set by the frontend
* through AudioOutputInterface47::setStreamUuid
*
* \see streamProperties
* \since 4.7.0
*/
void setupStreamEnvironment(QString streamUuid);
void emitObjectDescriptionChanged(ObjectDescriptionType);
bool setOutputName(QString streamUuid, QString name);
bool setOutputDevice(QString streamUuid, int device);
bool setOutputVolume(QString streamUuid, qreal volume);
bool setOutputMute(QString streamUuid, bool mute);
bool setCaptureDevice(QString streamUuid, int device);
// NB Capture Volume/Mute not set until PA supports per-source-output volumes/mutes
// or phonon supports capture properly... which ever comes first.
void clearStreamCache(QString streamUuid);
static void debug();
public Q_SLOTS:
void connectToDaemon();
Q_SIGNALS:
void objectDescriptionChanged(ObjectDescriptionType);
private:
PulseSupport();
~PulseSupport();
bool mEnabled;
};
} // namespace Phonon
#endif // PHONON_PULSESUPPORT_H
|