QRhiMetalInitParams Struct

Paramètres d'initialisation spécifiques au métal. En savoir plus...

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 de :	QRhiInitParams

Description détaillée

Remarque : il s'agit d'une API RHI dont la compatibilité est garantie de manière limitée ; pour plus de détails, consultez QRhi.

Une QRhi basée sur Metal ne nécessite aucun paramètre particulier pour son initialisation.

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

Remarque : la validation de l’APIMetal ne peut pas être activée par programmation via l’ QRhi. Il faut soit exécuter la version 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. Cette variable doit être définie très tôt dans l’environnement, de préférence avant le démarrage du processus ; tenter de la définir au moment de la création de l’ QRhi ne fonctionne pas dans la pratique. (probablement trop tard)

Remarque : QRhiSwapChain ne peut cibler que les instances QWindow dont le type de surface est défini sur QSurface::MetalSurface.

Utilisation de périphériques Metal existants

Lors de l’interopérabilité avec un autre moteur graphique, il peut s’avérer nécessaire d’obtenir une instance d’ QRhi utilisant le même périphérique Metal. Pour ce faire, il suffit de passer un pointeur vers une instance de QRhiMetalNativeHandles à la fonction QRhi::create(). Le périphérique doit alors être défini sur une valeur non nulle. En option, un objet de file d’attente de commandes peut également être spécifié.

L’ QRhi ne prend la propriété 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.