Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qiosintegration.mm
Go to the documentation of this file.
1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3// Qt-Security score:significant reason:default
4
5#undef QT_NO_FOREACH // this file contains unported legacy Q_FOREACH uses
6
9#include "qiosglobal.h"
10#include "qioswindow.h"
11#include "qiosscreen.h"
13#if QT_CONFIG(clipboard)
14#include "qiosclipboard.h"
15#endif
17#include "qiostheme.h"
18#include "qiosservices.h"
21
22#if defined(Q_OS_VISIONOS)
23#include "qiosswiftintegration.h"
24#endif
25
26#include <QtGui/qpointingdevice.h>
27#include <QtGui/private/qguiapplication_p.h>
28#include <QtGui/private/qrhibackingstore_p.h>
29
30#include <qoffscreensurface.h>
31#include <qpa/qplatformoffscreensurface.h>
32
33#include <QtGui/private/qcoretextfontdatabase_p.h>
34#include <QtGui/private/qmacmimeregistry_p.h>
35#include <QtGui/qutimimeconverter.h>
36#include <QDir>
37#include <QOperatingSystemVersion>
38
39#if QT_CONFIG(opengl)
40#include "qioscontext.h"
41#endif
42
43#import <AudioToolbox/AudioServices.h>
44
45#include <QtDebug>
46
48
49using namespace Qt::StringLiterals;
50
51class QCoreTextFontEngine;
52
54{
55 return static_cast<QIOSIntegration *>(QGuiApplicationPrivate::platformIntegration());
56}
57
58QIOSIntegration::QIOSIntegration()
59 : m_fontDatabase(new QCoreTextFontDatabaseEngineFactory<QCoreTextFontEngine>)
60#if QT_CONFIG(clipboard)
61 , m_clipboard(new QIOSClipboard)
62#endif
63 , m_inputContext(0)
64 , m_accessibility(0)
65 , m_optionalPlugins(new QFactoryLoader(QIosOptionalPluginInterface_iid, "/platforms/darwin"_L1))
66{
67 if (Q_UNLIKELY(!qt_apple_isApplicationExtension() && !qt_apple_sharedApplication())) {
68 qFatal("Error: You are creating QApplication before calling UIApplicationMain.\n"
69 "If you are writing a native iOS application, and only want to use Qt for\n"
70 "parts of the application, a good place to create QApplication is from within\n"
71 "'applicationDidFinishLaunching' inside your UIApplication delegate.\n");
72 }
73}
74
75void QIOSIntegration::initialize()
76{
77 QIOSScreen::initializeScreens();
78
79 // Depends on a primary screen being present
80 m_inputContext = new QIOSInputContext;
81
82 QPointingDevice::Capabilities touchCapabilities = QPointingDevice::Capability::Position | QPointingDevice::Capability::NormalizedPosition;
83#if !defined(Q_OS_VISIONOS)
84 if (UIScreen.mainScreen.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable)
85 touchCapabilities |= QPointingDevice::Capability::Pressure;
86#endif
87 m_touchDevice = new QPointingDevice("touchscreen", 0, QInputDevice::DeviceType::TouchScreen,
88 QPointingDevice::PointerType::Finger, touchCapabilities, 10, 0);
89 QWindowSystemInterface::registerInputDevice(m_touchDevice);
90#if QT_CONFIG(tabletevent)
91 QWindowSystemInterfacePrivate::TabletEvent::setPlatformSynthesizesMouse(false);
92 m_pencilDevice = new QPointingDevice(
93 "Apple Pencil", 0, QInputDevice::DeviceType::Stylus, QPointingDevice::PointerType::Pen,
94 QInputDevice::Capability::Position | QInputDevice::Capability::Pressure
95 | QInputDevice::Capability::XTilt | QInputDevice::Capability::YTilt
96 | QInputDevice::Capability::Hover | QInputDevice::Capability::ZPosition
97 | QInputDevice::Capability::Rotation,
98 1, 0);
99 QWindowSystemInterface::registerInputDevice(m_pencilDevice);
100#endif
101 QMacMimeRegistry::initializeMimeTypes();
102
103 qsizetype size = QList<QPluginParsedMetaData>(m_optionalPlugins->metaData()).size();
104 for (qsizetype i = 0; i < size; ++i)
105 qobject_cast<QIosOptionalPluginInterface *>(m_optionalPlugins->instance(i))->initPlugin();
106
107 if (QIOSEventDispatcher::isQtApplication()) {
108 qCDebug(lcQpaWindowScene) << "Replacing application delegate"
109 << UIApplication.sharedApplication.delegate << "with QIOSApplicationDelegate";
110 UIApplication.sharedApplication.delegate = [QIOSApplicationDelegate new];
111 }
112}
113
114QIOSIntegration::~QIOSIntegration()
115{
116 delete m_fontDatabase;
117 m_fontDatabase = 0;
118
119#if QT_CONFIG(clipboard)
120 delete m_clipboard;
121 m_clipboard = 0;
122#endif
123
124 QMacMimeRegistry::destroyMimeTypes();
125
126 delete m_inputContext;
127 m_inputContext = 0;
128
129 foreach (QScreen *screen, QGuiApplication::screens())
130 QWindowSystemInterface::handleScreenRemoved(screen->handle());
131
132 delete m_platformServices;
133 m_platformServices = 0;
134
135 delete m_accessibility;
136 m_accessibility = 0;
137
138 delete m_optionalPlugins;
139 m_optionalPlugins = 0;
140}
141
142bool QIOSIntegration::hasCapability(Capability cap) const
143{
144 switch (cap) {
145#if QT_CONFIG(opengl)
146 case BufferQueueingOpenGL:
147 return true;
148 case OpenGL:
149 case ThreadedOpenGL:
150 return true;
151#endif
152 case ThreadedPixmaps:
153 return true;
154 case MultipleWindows:
155 return true;
156 case WindowManagement:
157 return false;
158 case ApplicationState:
159 return true;
160 case ForeignWindows:
161 return true;
162 default:
163 return QPlatformIntegration::hasCapability(cap);
164 }
165}
166
167QPlatformWindow *QIOSIntegration::createPlatformWindow(QWindow *window) const
168{
169 return new QIOSWindow(window);
170}
171
172QPlatformWindow *QIOSIntegration::createForeignWindow(QWindow *window, WId nativeHandle) const
173{
174 return new QIOSWindow(window, nativeHandle);
175}
176
177QPlatformBackingStore *QIOSIntegration::createPlatformBackingStore(QWindow *window) const
178{
179 return new QRhiBackingStore(window);
180}
181
182#if QT_CONFIG(opengl)
183// Used when the QWindow's surface type is set by the client to QSurface::OpenGLSurface
184QPlatformOpenGLContext *QIOSIntegration::createPlatformOpenGLContext(QOpenGLContext *context) const
185{
186 return new QIOSContext(context);
187}
188#endif
189
190class QIOSOffscreenSurface : public QPlatformOffscreenSurface
191{
192public:
193 QIOSOffscreenSurface(QOffscreenSurface *offscreenSurface) : QPlatformOffscreenSurface(offscreenSurface) {}
194
195 QSurfaceFormat format() const override
196 {
197 Q_ASSERT(offscreenSurface());
198 return offscreenSurface()->requestedFormat();
199 }
200 bool isValid() const override { return true; }
201};
202
203QPlatformOffscreenSurface *QIOSIntegration::createPlatformOffscreenSurface(QOffscreenSurface *surface) const
204{
205 return new QIOSOffscreenSurface(surface);
206}
207
209{
210 return QIOSEventDispatcher::create();
211}
212
214{
215 return m_fontDatabase;
216}
217
218#if QT_CONFIG(clipboard)
219QPlatformClipboard *QIOSIntegration::clipboard() const
220{
221 return m_clipboard;
222}
223#endif
224
226{
227 return m_inputContext;
228}
229
231{
232 if (!m_platformServices)
233 m_platformServices = new QIOSServices;
234
235 return m_platformServices;
236}
237
238QVariant QIOSIntegration::styleHint(StyleHint hint) const
239{
240 switch (hint) {
241 case StartDragTime:
242 return 300;
243 case PasswordMaskDelay:
244 // this number is based on timing the native delay
245 // since there is no API to get it
246 return 2000;
247 case ShowIsMaximized:
248 return true;
249 case SetFocusOnTouchRelease:
250 return true;
251 default:
252 return QPlatformIntegration::styleHint(hint);
253 }
254}
255
257{
258 return QStringList(QLatin1StringView(QIOSTheme::name));
259}
260
262{
263 if (name == QLatin1StringView(QIOSTheme::name))
264 return new QIOSTheme;
265
266 return QPlatformIntegration::createPlatformTheme(name);
267}
268
270{
271 return m_touchDevice;
272}
273
274#if QT_CONFIG(tabletevent)
275QPointingDevice *QIOSIntegration::pencilDevice()
276{
277 return m_pencilDevice;
278}
279#endif
280
281#if QT_CONFIG(accessibility)
282QPlatformAccessibility *QIOSIntegration::accessibility() const
283{
284 if (!m_accessibility)
285 m_accessibility = new QIOSPlatformAccessibility;
286 return m_accessibility;
287}
288#endif
289
291{
292 return const_cast<QIOSIntegration *>(this);
293}
294
296{
297#if !TARGET_IPHONE_SIMULATOR
298 AudioServicesPlayAlertSound(kSystemSoundID_Vibrate);
299#endif
300}
301
303{
304 UIApplication.sharedApplication.applicationIconBadgeNumber = number;
305}
306
307// ---------------------------------------------------------
308
309#if defined(Q_OS_VISIONOS)
310void QIOSIntegration::openImmersiveSpace()
311{
312 [ImmersiveSpaceManager openImmersiveSpace];
313}
314
315void QIOSIntegration::dismissImmersiveSpace()
316{
317 [ImmersiveSpaceManager dismissImmersiveSpace];
318}
319
320void QIOSIntegration::setImmersiveSpaceCompositorLayer(CompositorLayer *layer)
321{
322 m_immersiveSpaceCompositorLayer = layer;
323}
324
325void QIOSIntegration::configureCompositorLayer(cp_layer_renderer_capabilities_t capabilities,
326 cp_layer_renderer_configuration_t configuration)
327{
328 if (m_immersiveSpaceCompositorLayer)
329 m_immersiveSpaceCompositorLayer->configure(capabilities, configuration);
330}
331
332void QIOSIntegration::renderCompositorLayer(cp_layer_renderer_t renderer)
333{
334 if (m_immersiveSpaceCompositorLayer)
335 m_immersiveSpaceCompositorLayer->render(renderer);
336}
337
338void QIOSIntegration::handleSpatialEvents(const char *jsonString)
339{
340 if (m_immersiveSpaceCompositorLayer) {
341 QJsonParseError error;
342 QJsonDocument doc = QJsonDocument::fromJson(QByteArray(jsonString), &error);
343 if (error.error != QJsonParseError::NoError) {
344 qWarning() << "Error parsing JSON: " << error.errorString();
345 return;
346 }
347 m_immersiveSpaceCompositorLayer->handleSpatialEvents(doc.object());
348 }
349}
350
351#endif
352
353// ---------------------------------------------------------
354
355void *QIOSIntegration::nativeResourceForWindow(const QByteArray &resource, QWindow *window)
356{
357 if (!window || !window->handle())
358 return 0;
359
360 QByteArray lowerCaseResource = resource.toLower();
361
362 QIOSWindow *platformWindow = static_cast<QIOSWindow *>(window->handle());
363
364 if (lowerCaseResource == "uiview")
365 return reinterpret_cast<void *>(platformWindow->winId());
366
367 return 0;
368}
369
370// ---------------------------------------------------------
371
372QT_END_NAMESPACE
373
374#include "moc_qiosintegration.cpp"
QVariant styleHint(StyleHint hint) const override
QPlatformTheme * createPlatformTheme(const QString &name) const override
void beep() const override
static QIOSIntegration * instance()
void setApplicationBadge(qint64 number) override
QPointingDevice * touchDevice()
QStringList themeNames() const override
QPlatformNativeInterface * nativeInterface() const override
QAbstractEventDispatcher * createEventDispatcher() const override
Factory function for the GUI event dispatcher.
QPlatformServices * services() const override
QPlatformInputContext * inputContext() const override
Returns the platforms input context.
QPlatformFontDatabase * fontDatabase() const override
Accessor for the platform integration's fontdatabase.
static const char * name
Definition qiostheme.h:44
Combined button and popup list for selecting options.
#define QIosOptionalPluginInterface_iid