QRhiMetalInitParams Struct

Metallspezifische Initialisierungsparameter. Mehr...

Header:	`#include <rhi/qrhi.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS GuiPrivate)` `target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)`
qmake:	`QT += gui-private`
Seit:	Qt 6.6
Erbt von:	QRhiInitParams

Ausführliche Beschreibung

Hinweis: Dies ist eine RHI-API mit eingeschränkten Kompatibilitätsgarantien; weitere Informationen finden Sie unter QRhi.

Ein Metal-basiertes „ QRhi “ benötigt keine speziellen Parameter zur Initialisierung.

QRhiMetalInitParams params;
rhi = QRhi::create(QRhi::Metal, &params);

Hinweis: Die Metal-API-Validierung kann nicht programmgesteuert über die ` QRhi` aktiviert werden. Führen Sie stattdessen entweder die Debug-Version der Anwendung in XCode aus, indem Sie über cmake -G Xcode eine ` .xcodeproj `-Datei generieren, oder setzen Sie die Umgebungsvariable ` METAL_DEVICE_WRAPPER_TYPE=1`. 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 auf „ QWindow “-Instanzen angewendet werden, deren Oberflächentyp auf „ QSurface::MetalSurface “ gesetzt ist.

Arbeiten mit vorhandenen Metal-Geräten

Bei der Zusammenarbeit mit einer anderen Grafik-Engine kann es erforderlich sein, eine „ QRhi “-Instanz zu erhalten, die dasselbe Metal-Gerät verwendet. Dies lässt sich erreichen, indem ein Zeiger auf ein „ QRhiMetalNativeHandles “ an „ QRhi::create()“ übergeben wird. Das Gerät muss dann auf einen Wert ungleich Null gesetzt sein. Optional kann auch ein Befehlswarteschlangenobjekt angegeben werden.

Die ` QRhi ` übernimmt keine Eigentumsrechte an den externen Objekten.

© 2026 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.