/usr/include/QtGStreamer/QGst/Ui/graphicsvideosurface.h is in libqtgstreamer-dev 1.2.0-4.
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 | /*
Copyright (C) 2012 Collabora Ltd. <info@collabora.com>
@author George Kiagiadakis <george.kiagiadakis@collabora.com>
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) any later version.
This program 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 program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef QGST_UI_GRAPHICSVIDEOSURFACE_H
#define QGST_UI_GRAPHICSVIDEOSURFACE_H
#include "global.h"
#include "../element.h"
#if (QT_VERSION >= QT_VERSION_CHECK(5, 0, 0))
# include <QtWidgets/QGraphicsView>
#else
# include <QtGui/QGraphicsView>
#endif
namespace QGst {
namespace Ui {
class GraphicsVideoWidget;
class GraphicsVideoSurfacePrivate;
/*! \headerfile graphicsvideosurface.h <QGst/Ui/GraphicsVideoSurface>
* \brief Helper class for painting video on a QGraphicsView
*
* This is a helper class that represents a video surface on a QGraphicsView.
* This is not a QGraphicsItem, though, it is just a helper class to bind
* the video sink to a specific view. To use it, create a GraphicsVideoWidget,
* add it to your scene and connect it with this surface.
*
* Example
* \code
* QGraphicsScene *scene = new QGraphicsScene;
* QGraphicsView *view = new QGraphicsView (scene);
* view->setViewport(new QGLWidget); //recommended
* QGst::Ui::GraphicsVideoSurface *surface = new QGst::Ui::GraphicsVideoSurface(view);
* ...
* QGst::Ui::GraphicsVideoWidget *widget = new QGst::Ui::GraphicsVideoWidget;
* widget->setSurface(surface);
* scene->addItem(widget);
* \endcode
*
* This class internally creates and uses either a "qtglvideosink" or a "qtvideosink"
* element ("qt5glvideosink" / "qt5videosink" in Qt5). This element is created the
* first time it is requested and a reference is kept internally.
*
* To make use of OpenGL hardware acceleration (using qtglvideosink), you need to set
* a QGLWidget as the viewport of the QGraphicsView. Note that you must do this before
* the video sink element is requested for the first time using the videoSink() method,
* as this method needs to find a GL context to be able to construct qtglvideosink and
* query the hardware about supported features. Using OpenGL acceleration is recommended.
* If you don't use it, painting will be done in software with QImage and QPainter
* (using qtvideosink).
*
* This class can also be used to paint video on QML.
*
* Example:
* \code
* // in your C++ code
* QDeclarativeView *view = new QDeclarativeView;
* view->setViewport(new QGLWidget); //recommended
* QGst::Ui::GraphicsVideoSurface *surface = new QGst::Ui::GraphicsVideoSurface(view);
* view->rootContext()->setContextProperty(QLatin1String("videoSurface"), surface);
* ...
* // and in your qml file:
* import QtGStreamer 1.0
* ...
* VideoItem {
* id: video
* width: 320
* height: 240
* surface: videoSurface
* }
* \endcode
*
* \sa GraphicsVideoWidget
*/
class QTGSTREAMERUI_EXPORT GraphicsVideoSurface : public QObject
{
Q_OBJECT
Q_DISABLE_COPY(GraphicsVideoSurface)
public:
explicit GraphicsVideoSurface(QGraphicsView *parent);
virtual ~GraphicsVideoSurface();
/*! Returns the video sink element that provides this surface's image.
* The element will be constructed the first time that this function
* is called. The surface will always keep a reference to this element.
*/
ElementPtr videoSink() const;
private:
QTGSTREAMERUI_NO_EXPORT void onUpdate();
private:
friend class GraphicsVideoWidget;
GraphicsVideoSurfacePrivate * const d;
};
} // namespace Ui
} // namespace QGst
Q_DECLARE_METATYPE(QGst::Ui::GraphicsVideoSurface*)
#endif // QGST_UI_GRAPHICSVIDEOSURFACE_H
|