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 // On visionOS the Swift entry point is used, which sets up the application
108 // delegate itself, so we don't want to install the QIOSApplicationDelegate
109#if !defined(Q_OS_VISIONOS)
110 if (QIOSEventDispatcher::isQtApplication()) {
111 qCDebug(lcQpaWindowScene) << "Replacing application delegate"
112 << UIApplication.sharedApplication.delegate << "with QIOSApplicationDelegate";
113 UIApplication.sharedApplication.delegate = [QIOSApplicationDelegate new];
114 }
115#endif
116}
117
118QIOSIntegration::~QIOSIntegration()
119{
120 delete m_fontDatabase;
121 m_fontDatabase = 0;
122
123#if QT_CONFIG(clipboard)
124 delete m_clipboard;
125 m_clipboard = 0;
126#endif
127
128 QMacMimeRegistry::destroyMimeTypes();
129
130 delete m_inputContext;
131 m_inputContext = 0;
132
133 foreach (QScreen *screen, QGuiApplication::screens())
134 QWindowSystemInterface::handleScreenRemoved(screen->handle());
135
136 delete m_platformServices;
137 m_platformServices = 0;
138
139 delete m_accessibility;
140 m_accessibility = 0;
141
142 delete m_optionalPlugins;
143 m_optionalPlugins = 0;
144}
145
146bool QIOSIntegration::hasCapability(Capability cap) const
147{
148 switch (cap) {
149#if QT_CONFIG(opengl)
150 case BufferQueueingOpenGL:
151 return true;
152 case OpenGL:
153 case ThreadedOpenGL:
154 return true;
155#endif
156 case ThreadedPixmaps:
157 return true;
158 case MultipleWindows:
159 return true;
160 case WindowManagement:
161 return false;
162 case ApplicationState:
163 return true;
164 case ForeignWindows:
165 return true;
166 default:
167 return QPlatformIntegration::hasCapability(cap);
168 }
169}
170
171QPlatformWindow *QIOSIntegration::createPlatformWindow(QWindow *window) const
172{
173 return new QIOSWindow(window);
174}
175
176QPlatformWindow *QIOSIntegration::createForeignWindow(QWindow *window, WId nativeHandle) const
177{
178 return new QIOSWindow(window, nativeHandle);
179}
180
181QPlatformBackingStore *QIOSIntegration::createPlatformBackingStore(QWindow *window) const
182{
183 return new QRhiBackingStore(window);
184}
185
186#if QT_CONFIG(opengl)
187// Used when the QWindow's surface type is set by the client to QSurface::OpenGLSurface
188QPlatformOpenGLContext *QIOSIntegration::createPlatformOpenGLContext(QOpenGLContext *context) const
189{
190 return new QIOSContext(context);
191}
192#endif
193
194class QIOSOffscreenSurface : public QPlatformOffscreenSurface
195{
196public:
197 QIOSOffscreenSurface(QOffscreenSurface *offscreenSurface) : QPlatformOffscreenSurface(offscreenSurface) {}
198
199 QSurfaceFormat format() const override
200 {
201 Q_ASSERT(offscreenSurface());
202 return offscreenSurface()->requestedFormat();
203 }
204 bool isValid() const override { return true; }
205};
206
207QPlatformOffscreenSurface *QIOSIntegration::createPlatformOffscreenSurface(QOffscreenSurface *surface) const
208{
209 return new QIOSOffscreenSurface(surface);
210}
211
213{
214 return QIOSEventDispatcher::create();
215}
216
218{
219 return m_fontDatabase;
220}
221
222#if QT_CONFIG(clipboard)
223QPlatformClipboard *QIOSIntegration::clipboard() const
224{
225 return m_clipboard;
226}
227#endif
228
230{
231 return m_inputContext;
232}
233
235{
236 if (!m_platformServices)
237 m_platformServices = new QIOSServices;
238
239 return m_platformServices;
240}
241
242QVariant QIOSIntegration::styleHint(StyleHint hint) const
243{
244 switch (hint) {
245 case StartDragTime:
246 return 300;
247 case PasswordMaskDelay:
248 // this number is based on timing the native delay
249 // since there is no API to get it
250 return 2000;
251 case ShowIsMaximized:
252 return true;
253 case SetFocusOnTouchRelease:
254 return true;
255 default:
256 return QPlatformIntegration::styleHint(hint);
257 }
258}
259
261{
262 return QStringList(QLatin1StringView(QIOSTheme::name));
263}
264
266{
267 if (name == QLatin1StringView(QIOSTheme::name))
268 return new QIOSTheme;
269
270 return QPlatformIntegration::createPlatformTheme(name);
271}
272
274{
275 return m_touchDevice;
276}
277
278#if QT_CONFIG(tabletevent)
279QPointingDevice *QIOSIntegration::pencilDevice()
280{
281 return m_pencilDevice;
282}
283#endif
284
285#if QT_CONFIG(accessibility)
286QPlatformAccessibility *QIOSIntegration::accessibility() const
287{
288 if (!m_accessibility)
289 m_accessibility = new QIOSPlatformAccessibility;
290 return m_accessibility;
291}
292#endif
293
295{
296 return const_cast<QIOSIntegration *>(this);
297}
298
300{
301#if !TARGET_IPHONE_SIMULATOR
302 AudioServicesPlayAlertSound(kSystemSoundID_Vibrate);
303#endif
304}
305
307{
308 UIApplication.sharedApplication.applicationIconBadgeNumber = number;
309}
310
311// ---------------------------------------------------------
312
313#if defined(Q_OS_VISIONOS)
314void QIOSIntegration::openImmersiveSpace()
315{
316 [ImmersiveSpaceManager openImmersiveSpace];
317}
318
319void QIOSIntegration::dismissImmersiveSpace()
320{
321 [ImmersiveSpaceManager dismissImmersiveSpace];
322}
323
324void QIOSIntegration::setImmersiveSpaceCompositorLayer(CompositorLayer *layer)
325{
326 m_immersiveSpaceCompositorLayer = layer;
327}
328
329void QIOSIntegration::configureCompositorLayer(cp_layer_renderer_capabilities_t capabilities,
330 cp_layer_renderer_configuration_t configuration)
331{
332 if (m_immersiveSpaceCompositorLayer)
333 m_immersiveSpaceCompositorLayer->configure(capabilities, configuration);
334}
335
336void QIOSIntegration::renderCompositorLayer(cp_layer_renderer_t renderer)
337{
338 if (m_immersiveSpaceCompositorLayer)
339 m_immersiveSpaceCompositorLayer->render(renderer);
340}
341
342void QIOSIntegration::handleSpatialEvents(const char *jsonString)
343{
344 if (m_immersiveSpaceCompositorLayer) {
345 QJsonParseError error;
346 QJsonDocument doc = QJsonDocument::fromJson(QByteArray(jsonString), &error);
347 if (error.error != QJsonParseError::NoError) {
348 qWarning() << "Error parsing JSON: " << error.errorString();
349 return;
350 }
351 m_immersiveSpaceCompositorLayer->handleSpatialEvents(doc.object());
352 }
353}
354
355#endif
356
357// ---------------------------------------------------------
358
359void *QIOSIntegration::nativeResourceForWindow(const QByteArray &resource, QWindow *window)
360{
361 if (!window || !window->handle())
362 return 0;
363
364 QByteArray lowerCaseResource = resource.toLower();
365
366 QIOSWindow *platformWindow = static_cast<QIOSWindow *>(window->handle());
367
368 if (lowerCaseResource == "uiview")
369 return reinterpret_cast<void *>(platformWindow->winId());
370
371 return 0;
372}
373
374// ---------------------------------------------------------
375
376QT_END_NAMESPACE
377
378#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