QRhiMetalInitParams Struct
Paramètres d'initialisation spécifiques au métal. Plus d'informations...
| En-tête : | #include <rhi/qrhi.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate)target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake : | QT += gui-private |
| Depuis : | Qt 6.6 |
| Hérite : | QRhiInitParams |
Description détaillée
Note : Il s'agit d'une API RHI avec des garanties de compatibilité limitées, voir QRhi pour plus de détails.
Un site QRhi basé sur Metal n'a besoin d'aucun paramètre spécial pour l'initialisation.
QRhiMetalInitParams params; rhi = QRhi::create(QRhi::Metal, ¶ms);
Note : La validation de l'API Metal ne peut pas être activée de manière programmatique par QRhi. A la place, il faut soit exécuter la compilation de débogage de l'application dans XCode, en générant un fichier .xcodeproj via cmake -G Xcode, soit définir la variable d'environnement METAL_DEVICE_WRAPPER_TYPE=1. La variable doit être définie tôt dans l'environnement, de préférence avant le début du processus ; tenter de la définir au moment de la création de QRhi n'est pas fonctionnel dans la pratique. (trop tard probablement)
Remarque : QRhiSwapChain ne peut cibler que les instances QWindow dont le type de surface est QSurface::MetalSurface.
Travailler avec des dispositifs Metal existants
Lors de l'interopérabilité avec un autre moteur graphique, il peut être nécessaire d'obtenir une instance QRhi qui utilise le même périphérique Metal. Pour ce faire, il suffit de passer un pointeur sur QRhiMetalNativeHandles à QRhi::create(). Le périphérique doit alors être défini à une valeur non nulle. En option, un objet de file d'attente de commandes peut également être spécifié.
QRhi n'est propriétaire d'aucun des objets externes.
© 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.
