QRhiRenderTarget Class
Représente une cible de rendu à l'écran (swapchain) ou hors écran (texture). 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 : | QRhiResource |
| Hérité par : |
Fonctions publiques
| virtual float | devicePixelRatio() const = 0 |
| virtual QSize | pixelSize() const = 0 |
| QRhiRenderPassDescriptor * | renderPassDescriptor() const |
| virtual int | sampleCount() const = 0 |
| void | setRenderPassDescriptor(QRhiRenderPassDescriptor *desc) |
Description détaillée
Les applications ne créent pas directement d’instance de cette classe. C’est plutôt la sous-classe QRhiTextureRenderTarget qui peut être instanciée par les clients de l’API via newTextureRenderTarget(). L’autre sous-classe est QRhiSwapChainRenderTarget, qui correspond au type renvoyé par QRhiSwapChain lors de l’appel de currentFrameRenderTarget().
Remarque : il s’agit d’une API RHI dont la compatibilité n’est pas entièrement garantie ; pour plus de détails, consultez QRhi.
Voir également QRhiSwapChainRenderTarget et QRhiTextureRenderTarget.
Documentation sur les fonctions membres
[pure virtual] float QRhiRenderTarget::devicePixelRatio() const
Renvoie le rapport de pixels de l'appareil. Pour QRhiTextureRenderTarget, cette valeur est toujours égale à 1. Pour les cibles récupérées à partir d'un QRhiSwapChain, la valeur reflète l'device pixel ratio de l'QWindow visée.
[pure virtual] QSize QRhiRenderTarget::pixelSize() const
Renvoie la taille en pixels.
Valable uniquement après l'appel réussi de la fonction create(). Jusqu'à ce moment-là, le résultat est un objet QSize construit par défaut.
Avec ` QRhiTextureRenderTarget `, la taille renvoyée correspond à celle des pièces jointes associées au moment de l’appel à `create()` ; en pratique, il s’agit de la taille de la première pièce jointe de couleur, ou du tampon de profondeur/stencil s’il n’y a pas de pièces jointes de couleur. Si les textures ou les tampons de rendu associés sont redimensionnés et reconstruits par la suite, alors `pixelSize()` effectue un appel implicite à `create()` afin de reconstruire les structures de données sous-jacentes. Cette vérification implicite est similaire à ce que fait ` QRhiCommandBuffer::beginPass()`, et garantit que la taille renvoyée est toujours à jour.
QRhiRenderPassDescriptor *QRhiRenderTarget::renderPassDescriptor() const
Renvoie l'QRhiRenderPassDescriptor associé.
Voir aussi setRenderPassDescriptor().
[pure virtual] int QRhiRenderTarget::sampleCount() const
Renvoie le nombre d'échantillons ou 1 si l'anticrénelage multi-échantillon n'est pas applicable à cette cible de rendu.
void QRhiRenderTarget::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)
Définit l'QRhiRenderPassDescriptor desc à utiliser avec cette cible de rendu.
Voir également renderPassDescriptor().
© 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.
