Add option (enabled by default) to omit the sender from a slot's arguments. In most...
[qtgstreamer:qtgstreamer.git] / examples / player / main.cpp
1 /*
2     Copyright (C) 2010  George Kiagiadakis <kiagiadakis.george@gmail.com>
3
4     This library is free software; you can redistribute it and/or modify
5     it under the terms of the GNU Lesser General Public License as published
6     by the Free Software Foundation; either version 2.1 of the License, or
7     (at your option) any later version.
8
9     This program is distributed in the hope that it will be useful,
10     but WITHOUT ANY WARRANTY; without even the implied warranty of
11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12     GNU General Public License for more details.
13
14     You should have received a copy of the GNU Lesser General Public License
15     along with this program.  If not, see <http://www.gnu.org/licenses/>.
16 */
17 #include <iostream>
18 #include <signal.h>
19 #include <QtCore/QCoreApplication>
20 #include <QtCore/QFile>
21 #include <QGlib/Signal>
22 #include <QGst/Global>
23 #include <QGst/Pipeline>
24 #include <QGst/ElementFactory>
25 #include <QGst/GhostPad>
26 #include <QGst/Structure>
27 #include <QGst/Bus>
28 #include <QGst/Message>
29
30 /* This is a simple example of a command-line audio player. It accepts the filename of
31  * an audio file as the first command line argument and then constructs a pipeline
32  * that uses decodebin2 to decode the audio stream and autoaudiosink to output it to
33  * the sound card. In the future this example will be expanded to handle video as well
34  * and perhaps it will gain a simple GUI too. */
35
36 class Player
37 {
38 public:
39     Player(const QString & fileName);
40     ~Player();
41
42 private:
43     void onBusSyncMessage(const QGst::MessagePtr & message);
44     void onNewDecodedPad(QGst::PadPtr newPad);
45     static QGst::BinPtr createAudioSinkBin();
46
47     /* This smart pointer is needed to keep a reference to the underlying GstPipeline object.
48      * Even if we are not going to use it, we must keep a reference to the pipeline,
49      * so that it remains in memory, together with all its child elements. If this
50      * reference is gone, the pipeline and all the elements will be destroyed.
51      * Note that we don't need to keep references to the individual elements, because
52      * when they are added in the pipeline, the pipeline keeps a reference on them. */
53     QGst::PipelinePtr m_pipeline;
54 };
55
56 Player::Player(const QString & fileName)
57 {
58     m_pipeline = QGst::Pipeline::create();
59
60     QGst::ElementPtr filesrc = QGst::ElementFactory::make("filesrc");
61     QGst::ElementPtr decodebin = QGst::ElementFactory::make("decodebin2");
62
63     filesrc->setProperty("location", fileName);
64     QGlib::Signal::connect(decodebin, "new-decoded-pad", this, &Player::onNewDecodedPad);
65
66     m_pipeline->add(filesrc);
67     m_pipeline->add(decodebin);
68     filesrc->link(decodebin);
69
70     QGst::BusPtr bus = m_pipeline->bus();
71     bus->enableSyncMessageEmission();
72     QGlib::Signal::connect(bus, "sync-message", this, &Player::onBusSyncMessage);
73
74     m_pipeline->setState(QGst::StatePlaying);
75 }
76
77 Player::~Player()
78 {
79     m_pipeline->setState(QGst::StateNull);
80
81     /* When m_pipeline is destructed, the last reference to our pipeline will be gone,
82      * and with it all the elements, buses, etc will be destroyed too. As a result,
83      * there is no need to cleanup here. */
84 }
85
86 void Player::onBusSyncMessage(const QGst::MessagePtr & message)
87 {
88     /* WARNING this slot gets called in a different thread */
89     switch(message->type()) {
90     case QGst::MessageEos: //End of stream. We reached the end of the file.
91     case QGst::MessageError: //Some error occurred.
92         /* QCoreApplication::quit is safe to be called in another thread.
93          * It will schedule the main event loop to exit, when execution
94          * in the main thread has reached the event loop. */
95         QCoreApplication::quit();
96         break;
97     default:
98         break;
99     }
100 }
101
102 /* This method will be called every time a new "src" pad is available on the decodebin2 element.
103  * Here we have to check what kind of data this pad transfers (usually it is either "audio/x-raw-*"
104  * or "video/x-raw-*") and connect an appropriate sink that can handle this type of data. */
105 void Player::onNewDecodedPad(QGst::PadPtr newPad)
106 {
107
108     QGst::CapsPtr caps = newPad->caps();
109     QGst::SharedStructure structure = caps->structure(0);
110
111     /* The caps' first structure's name tells us what kind of data the pad transfers.
112      * Here we want to handle either audio/x-raw-int or audio/x-raw-float. Both types
113      * can be handled by the audioconvert element that is contained in the audioSinkBin,
114      * so there is no need to handle them separately */
115     if (structure.name().contains("audio/x-raw")) {
116         QGst::BinPtr audioSinkBin = createAudioSinkBin();
117         m_pipeline->add(audioSinkBin);
118
119         /* The newly created bin must go to the playing state in order to function.
120          * Here we tell it to synchronise its state with its parent, the pipeline,
121          * which is scheduled to go to the playing state. */
122         audioSinkBin->syncStateWithParent();
123
124         newPad->link(audioSinkBin->getStaticPad("sink"));
125     }
126 }
127
128 QGst::BinPtr Player::createAudioSinkBin()
129 {
130     QGst::BinPtr bin = QGst::Bin::create();
131
132     QGst::ElementPtr audioconvert = QGst::ElementFactory::make("audioconvert");
133     QGst::ElementPtr audiosink = QGst::ElementFactory::make("autoaudiosink");
134
135     bin->add(audioconvert);
136     bin->add(audiosink);
137     audioconvert->link(audiosink);
138
139     /* Add a sink pad to the bin that proxies the sink pad of the audioconvert element */
140     bin->addPad(QGst::GhostPad::create(audioconvert->getStaticPad("sink"), "sink"));
141
142     return bin;
143 }
144
145 static void sighandler(int code)
146 {
147     Q_UNUSED(code);
148     QCoreApplication::quit();
149 }
150
151 int main(int argc, char **argv)
152 {
153     QCoreApplication app(argc, argv);
154     QGst::init(&argc, &argv);
155
156     QString fileName;
157     if (argc > 1) {
158         fileName = QFile::decodeName(argv[1]);
159     }
160
161     if (!QFile::exists(fileName)) {
162         std::cerr << "Usage: " << argv[0] << " fileToPlay" << std::endl;
163         return 1;
164     }
165
166     Player *p = new Player(fileName);
167
168     signal(SIGINT, sighandler);
169     int result = app.exec();
170
171     delete p; // we must delete all gstreamer objects before calling QGst::cleanup()
172     QGst::cleanup();
173
174     return result;
175 }