QRhiRenderTarget Class
Représente une cible de rendu à l'écran (swapchain) ou hors écran (texture). 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 : | 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 une instance de cette classe. C'est plutôt la sous-classe QRhiTextureRenderTarget qui est instanciable par les clients de l'API via newTextureRenderTarget(). L'autre sous-classe est QRhiSwapChainRenderTarget, qui est le type que QRhiSwapChain renvoie lorsqu'il appelle currentFrameRenderTarget().
Remarque : il s'agit d'une API RHI avec des garanties de compatibilité limitées, voir QRhi pour plus de détails.
Voir également QRhiSwapChainRenderTarget et QRhiTextureRenderTarget.
Documentation des fonctions membres
[pure virtual] float QRhiRenderTarget::devicePixelRatio() const
Renvoie le rapport de pixels de l'appareil. Pour QRhiTextureRenderTarget, cette valeur est toujours de 1. Pour les cibles extraites d'un site QRhiSwapChain, la valeur reflète le site device pixel ratio de la cible QWindow.
[pure virtual] QSize QRhiRenderTarget::pixelSize() const
Renvoie la taille en pixels.
Valable uniquement lorsque create() a été appelé avec succès. Jusqu'à ce moment, le résultat est une construction par défaut QSize.
Avec QRhiTextureRenderTarget, la taille renvoyée est la taille des pièces jointes associées au moment de create(), en pratique la taille de la première pièce jointe de couleur, ou le 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 retournée est toujours à jour.
QRhiRenderPassDescriptor *QRhiRenderTarget::renderPassDescriptor() const
Renvoie l'adresse QRhiRenderPassDescriptor associée.
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 pertinent pour cette cible de rendu.
void QRhiRenderTarget::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)
Définit l'adresse QRhiRenderPassDescriptor desc à utiliser avec cette cible de rendu.
Voir aussi 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.
