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
|
/****************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the plugins of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef QMEEGOGRAPHICSSYSTEMHELPER_H
#define QMEEGOGRAPHICSSYSTEMHELPER_H
#include <QPixmap>
#include <QImage>
#include "qmeegolivepixmap.h"
class QLibrary;
//! The base class for accressing special meego graphics system features.
/*!
This class is a helper class with static-only methods for accessing various
meego graphics system functionalities. The way it works is that the helper
dynamically calls-in to the loaded graphicssystem plugin... therefore, you're
expected to make sure that you're indeed running with 'meego' before using any
of the specialized methods.
In example:
\code
QPixmap p;
if (QMeeGoGraphicsSystemHelper::isRunningMeeGo()) {
p = QMeeGoGraphicsSystemHelper::pixmapWithGLTexture(64, 64);
} else {
p = QPixmap(64, 64);
}
\endcode
Calling any of the meego-specific features while not running meego might
give unpredictable results. The only functions safe to call at all times are:
\code
QMeeGoGraphicsSystemHelper::isRunningMeeGo();
QMeeGoGraphicsSystemHelper::runningGraphicsSystemName();
QMeeGoGraphicsSystemHelper::switchToMeeGo();
QMeeGoGraphicsSystemHelper::switchToRaster();
\endcode
*/
class Q_DECL_EXPORT QMeeGoGraphicsSystemHelper
{
public:
//! Returns true if running meego.
/*!
Returns true if the currently active (running) system is 'meego' with OpenGL.
This returns both true if the app was started with 'meego' or was started with
'runtime' graphics system and the currently active system through the runtime
switching is 'meego'.
*/
static bool isRunningMeeGo();
//! Returns true if running with a 'runtime' graphicssystem.
/*!
This function can be used in combination with ::runningGraphicsSystemName to figure out
the existing situation.
*/
static bool isRunningRuntime();
//! Switches to meego graphics system.
/*!
When running with the 'runtime' graphics system, sets the currently active
system to 'meego'. The window surface and all the resources are automatically
migrated to OpenGL. Will fail if the active graphics system is not 'runtime'.
Calling this function will emit QMeeGoSwitchEvent to the top level widgets.
Two events will be emitted for each switch -- one before the switch (QMeeGoSwitchEvent::WillSwitch)
and one after the switch (QMeeGoSwitchEvent::DidSwitch).
*/
static void switchToMeeGo();
//! Switches to raster graphics system
/*!
When running with the 'runtime' graphics system, sets the currently active
system to 'raster'. The window surface and the graphics resources (including the
EGL shared image resources) are automatically migrated back to the CPU. All OpenGL
resources (surface, context, cache, font cache) are automaticall anihilated.
Calling this function will emit QMeeGoSwitchEvent to the top level widgets.
Two events will be emitted for each switch -- one before the switch (QMeeGoSwitchEvent::WillSwitch)
and one after the switch (QMeeGoSwitchEvent::DidSwitch).
*/
static void switchToRaster();
//! Returns the name of the active graphics system
/*!
Returns the name of the currently active system. If running with 'runtime' graphics
system, returns the name of the active system inside the runtime graphics system
*/
static QString runningGraphicsSystemName();
//! Creates a new EGL shared image.
/*!
Creates a new EGL shared image from the given image. The EGL shared image wraps
a GL texture in the native format and can be easily accessed from other processes.
*/
static Qt::HANDLE imageToEGLSharedImage(const QImage &image);
//! Creates a QPixmap from an EGL shared image
/*!
Creates a new QPixmap from the given EGL shared image handle. The QPixmap can be
used for painting like any other pixmap. The softImage should point to an alternative,
software version of the graphical resource -- ie. obtained from theme daemon. The
softImage can be allocated on a QSharedMemory slice for easy sharing across processes
too. When the application is migrated ToRaster, this softImage will replace the
contents of the sharedImage.
It's ok to call this function too when not running 'meego' graphics system. In this
case it'll create a QPixmap backed with a raster data (from softImage)... but when
the system is switched back to 'meego', the QPixmap will be migrated to a EGL-shared image
backed storage (handle).
*/
static QPixmap pixmapFromEGLSharedImage(Qt::HANDLE handle, const QImage &softImage);
//! Destroys an EGL shared image.
/*!
Destroys an EGLSharedImage previously created with an ::imageToEGLSharedImage call.
Returns true if the image was found and the destruction was successful. Notice that
this destroys the image for all processes using it.
*/
static bool destroyEGLSharedImage(Qt::HANDLE handle);
//! Updates the QPixmap backed with an EGLShared image.
/*!
This function re-reads the softImage that was specified when creating the pixmap with
::pixmapFromEGLSharedImage and updates the EGL Shared image contents. It can be used
to share cross-proccess mutable EGLShared images.
*/
static void updateEGLSharedImagePixmap(QPixmap *p);
//! Create a new QPixmap with a GL texture.
/*!
Creates a new QPixmap which is backed by an OpenGL local texture. Drawing to this
QPixmap will be accelerated by hardware -- unlike the normal (new QPixmap()) pixmaps,
which are backed by a software engine and only migrated to GPU when used. Migrating those
GL-backed pixmaps when going ToRaster is expsensive (they need to be downloaded from
GPU to CPU) so use wisely.
*/
static QPixmap pixmapWithGLTexture(int w, int h);
//! Sets translucency (alpha) on the base window surface.
/*!
This function needs to be called *before* any widget/content is created.
When called with true, the base window surface will be translucent and initialized
with QGLFormat.alpha == true.
This function is *deprecated*. Set Qt::WA_TranslucentBackground attribute
on the top-level widget *before* you show it instead.
*/
static void setTranslucent(bool translucent);
};
#endif
|
