blob: 4616ff1bdd53eea00a02e603c2a0a49a8a206715 (
plain)
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
|
/* This file is part of the KDE project.
Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
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 or 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_MMF_MEDIANODE_H
#define PHONON_MMF_MEDIANODE_H
#include <QObject>
#include <Phonon/EffectInterface>
#include "audioplayer.h"
QT_BEGIN_NAMESPACE
/**
* @file mmf_medianode.h mmf_medianode.cpp
*
* This file starts with mmf_ in order to avoid clash with Phonon's
* medianode.h. The GStreamer backend has a file named medianode.h, but it
* isn't compiled with ABLD build system, which have problems with separating
* user and system include paths.
*/
namespace Phonon
{
namespace MMF
{
class MediaObject;
/**
* @short Base class for all nodes in the MMF backend.
*
* MediaNode is the base class for all nodes in the chain for MMF. Currently
* they are:
*
* - MediaObject: a source of media
* - AbstractEffect: supplying audio effects
* - AudioOutput: pretty much a dummy interface, but is also MediaNode in order
* to simplify connection/disconnection.
*
* MediaNode provides spectatability into the chain, and also allows the
* connection code to be written in a polymorphic manner, instead of putting it
* all in the Backend class. Due to that MMF has no concept of chaining, the
* order of the nodes in the graph has no meaning.
*/
class MediaNode : public QObject
{
Q_OBJECT
public:
MediaNode(QObject *parent);
virtual bool connectMediaNode(MediaNode *target);
virtual bool disconnectMediaNode(MediaNode *target);
void setSource(MediaNode *source);
MediaNode *source() const;
MediaNode *target() const;
protected:
/**
* When connectMediaNode() is called and a MediaObject is part of
* the its graph, this function will be called for each MediaNode in the
* graph for which it hasn't been called yet.
*
* The caller guarantees that @p mo is always non-null.
*/
virtual bool activateOnMediaObject(MediaObject *mo) = 0;
private:
/**
* Finds a MediaObject anywhere in the graph @p target is apart of, and
* calls activateOnMediaObject() for all MediaNodes in the graph for which
* it hasn't been applied to already.
*/
bool applyNodesOnMediaObject(MediaNode *target);
MediaNode * m_source;
MediaNode * m_target;
bool m_isApplied;
};
}
}
QT_END_NAMESPACE
#endif
|
