/usr/include/phonon/pulsesupport.h is in libphonon-dev 4:4.10.0-2.
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 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 | /* 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();
/**
* Whether or not PulseSupport is actively able to intercept calls.
*
* This is:
* - isUsable()
* - isRequested()
* - has been enabled by the backend
*
* @return \c true if usable, requested and enabled
*/
bool isActive();
/**
* Whether or not pulseaudio is used. This does not mean it is
* meant to intercept calls meant for the backend. It simply
* indicates that the backend is using pulseaudio.
*
* This is:
* - isUsable()
* - isRequested()
*
* @return \c true if pulesaudio can be used, \c false otherwise
*
* @since 4.9.0
*/
bool isUsed();
/**
* Whether or not pulseaudio can be used.
*
* This is
* - pulseaudiod is running
* - pulseaudiod can be connected to
*
* @return \c true if pulseaudio can be used
*/
bool isUsable() const;
/**
* Whether or not the backend has requested that it wants to use
* pulseaudio. This does *not* mean the backend wants pulseaudio
* support to intercept calls.
*
* @return \c true if the backend has requested to use pulseaudio.
*
* @since 4.9.0
*/
bool isRequested() const;
/**
* Backends can use this to request pulseaudio usage, without
* enabling the interception.
*
* @see enable for requesting pulseaudio and forcing interception
*
* @param requested whether or not the backend would like the
* frontend to use pulseaudio (e.g. list devices)
*
* @since 4.9.0
*/
void request(bool requested);
/**
* Enable pulse support. This implies a backend request.
* @param enabled
*/
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;
bool m_requested;
};
} // namespace Phonon
#endif // PHONON_PULSESUPPORT_H
|