Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QRhiViewport Class

Spécifie un rectangle de visualisation. 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

Fonctions publiques

QRhiViewport()
QRhiViewport(float x, float y, float w, float h, float minDepth = 0.0f, float maxDepth = 1.0f)
float maxDepth() const
float minDepth() const
void setMaxDepth(float maxDepth)
void setMinDepth(float minDepth)
void setViewport(float x, float y, float w, float h)
std::array<float, 4> viewport() const
size_t qHash(const QRhiViewport &key, size_t seed = 0)
bool operator!=(const QRhiViewport &a, const QRhiViewport &b)
bool operator==(const QRhiViewport &a, const QRhiViewport &b)

Description détaillée

Utilisé avec QRhiCommandBuffer::setViewport().

QRhi Suppose des coordonnées d'affichage de type OpenGL, ce qui signifie que x et y sont en bas à gauche. Une largeur ou une hauteur négative n'est pas autorisée.

L'utilisation typique est la suivante :

const QSize outputSizeInPixels = swapchain->currentPixelSize();
const QRhiViewport viewport(0, 0, outputSizeInPixels.width(), outputSizeInPixels.height());
cb->beginPass(swapchain->currentFrameRenderTarget(), Qt::black, { 1.0f, 0 });
cb->setGraphicsPipeline(ps);
cb->setViewport(viewport);
// ...

Note : Il s'agit d'une API RHI avec des garanties de compatibilité limitées, voir QRhi pour plus de détails.

Voir également QRhiCommandBuffer::setViewport(), QRhi::clipSpaceCorrMatrix() et QRhiScissor.

Documentation des fonctions membres

[constexpr noexcept] QRhiViewport::QRhiViewport()

Construit une description de la fenêtre de visualisation avec un rectangle vide et une profondeur comprise entre 0,0 et 1,0.

Voir aussi QRhi::clipSpaceCorrMatrix().

QRhiViewport::QRhiViewport(float x, float y, float w, float h, float minDepth = 0.0f, float maxDepth = 1.0f)

Construit une description de la fenêtre de visualisation avec le rectangle spécifié par x, y, w, h et la plage de profondeur minDepth et maxDepth.

Note : x et y sont supposés être la position en bas à gauche. w et h ne doivent pas être négatifs, sinon la fenêtre sera ignorée par QRhiCommandBuffer::setViewport().

Voir également QRhi::clipSpaceCorrMatrix().

float QRhiViewport::maxDepth() const

Renvoie la valeur maxDepth de la plage de profondeur de la fenêtre de visualisation.

Voir également setMaxDepth().

float QRhiViewport::minDepth() const

Renvoie la valeur minDepth de la plage de profondeur de la fenêtre de visualisation.

Voir également setMinDepth().

void QRhiViewport::setMaxDepth(float maxDepth)

Définit l'adresse maxDepth de la plage de profondeur de la fenêtre de visualisation. Par défaut, cette valeur est fixée à 1,0f.

Voir également maxDepth().

void QRhiViewport::setMinDepth(float minDepth)

Définit l'adresse minDepth de la plage de profondeur de la fenêtre de visualisation. Par défaut, cette valeur est fixée à 0,0f.

Voir également minDepth().

void QRhiViewport::setViewport(float x, float y, float w, float h)

Définit la position et la taille de la fenêtre de visualisation sur x, y, w, et h.

Remarque : les fenêtres d'affichage sont spécifiées dans un système de coordonnées dont l'origine se situe en bas à gauche.

Voir également viewport().

std::array<float, 4> QRhiViewport::viewport() const

Renvoie les valeurs x, y, largeur et hauteur de la fenêtre.

Voir également setViewport().

Non-membres associés

[noexcept] size_t qHash(const QRhiViewport &key, size_t seed = 0)

Renvoie la valeur de hachage pour key, en utilisant seed comme base de calcul.

[noexcept] bool operator!=(const QRhiViewport &a, const QRhiViewport &b)

Renvoie false si les valeurs des deux objets QRhiViewport a et b sont égales ; sinon, renvoie true.

[noexcept] bool operator==(const QRhiViewport &a, const QRhiViewport &b)

Renvoie true si les valeurs des deux objets QRhiViewport a et b sont égales.

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