QRhiMetalInitParams Struct
Metallspezifische Initialisierungsparameter. Mehr...
Kopfzeile: | #include <rhi/qrhi.h> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
qmake: | QT += gui-private |
Since: | Qt 6.6 |
Erbt: | QRhiInitParams |
Detaillierte Beschreibung
Hinweis: Dies ist eine RHI API mit begrenzten Kompatibilitätsgarantien, siehe QRhi für Details.
Eine Metal-basierte QRhi benötigt keine speziellen Parameter für die Initialisierung.
QRhiMetalInitParams params; rhi = QRhi::create(QRhi::Metal, ¶ms);
Hinweis: Die Validierung der Metal-API kann nicht programmatisch durch die QRhi aktiviert werden. Stattdessen muss entweder der Debug-Build der Anwendung in XCode ausgeführt werden, indem eine .xcodeproj
Datei über cmake -G Xcode
erzeugt wird, oder die Umgebungsvariable METAL_DEVICE_WRAPPER_TYPE=1
gesetzt werden. Die Variable muss frühzeitig in der Umgebung gesetzt werden, vorzugsweise vor dem Start des Prozesses; der Versuch, sie zum Zeitpunkt der Erstellung von QRhi zu setzen, funktioniert in der Praxis nicht. (wahrscheinlich zu spät)
Hinweis: QRhiSwapChain kann nur QWindow Instanzen ansprechen, deren Oberflächentyp auf QSurface::MetalSurface gesetzt ist.
Arbeiten mit bestehenden Metal-Geräten
Beim Zusammenspiel mit einer anderen Grafik-Engine kann es notwendig sein, eine QRhi Instanz zu erhalten, die das gleiche Metal-Gerät verwendet. Dies kann erreicht werden, indem ein Zeiger auf ein QRhiMetalNativeHandles an QRhi::create() übergeben wird. Das Gerät muss dann auf einen Nicht-Null-Wert gesetzt werden. Optional kann auch ein Befehlswarteschlangenobjekt angegeben werden.
Die QRhi übernimmt keine der externen Objekte.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.