Back to Qt.io
Contact Us Blog Download Qt

QRhiViewport Class

ビューポートの矩形を指定します。詳細...

Header: #include <rhi/qrhi.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)
qmake: QT += gui-private
Since: Qt 6.6

パブリック関数

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 &v, size_t seed = 0)
bool operator!=(const QRhiViewport &a, const QRhiViewport &b)
bool operator==(const QRhiViewport &a, const QRhiViewport &b)

詳細説明

QRhiCommandBuffer::setViewport() と共に使用される。

QRhi はOpenGLスタイルのビューポート座標を想定しています。負の幅や高さは許されない。

典型的な使用法は以下のようなものである：

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);
// ...

注意: これは互換性保証に制限のあるRHI APIです。詳細はQRhi を参照してください。

QRhiCommandBuffer::setViewport(),QRhi::clipSpaceCorrMatrix(),QRhiScissorも参照のこと 。

メンバ関数ドキュメント

[constexpr noexcept] QRhiViewport::QRhiViewport()

空の矩形と 0.0f - 1.0f の深度範囲を持つビューポート記述を構築する。

QRhi::clipSpaceCorrMatrix()も参照 。

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

x,y,w,h で指定される矩形と、minDepth およびmaxDepth で指定される深度範囲を持つビューポート記述を構築します。

注意: x とy は左下の位置であると仮定されます。w とh は負であってはなりません。そうでない場合、ビューポートはQRhiCommandBuffer::setViewport() によって無視されます。

QRhi::clipSpaceCorrMatrix()も参照 。

float QRhiViewport::maxDepth() const

ビューポートの深度範囲のmaxDepth値を返します。

setMaxDepth()も参照 。

float QRhiViewport::minDepth() const

ビューポートの深度範囲のminDepth値を返します。

setMinDepth()も参照 。

void QRhiViewport::setMaxDepth(float maxDepth)

ビューポートの深度範囲のmaxDepth 。デフォルトでは 1.0f に設定されています。

maxDepth()も参照 。

void QRhiViewport::setMinDepth(float minDepth)

ビューポートの深度範囲のminDepth を設定します。デフォルトでは 0.0f に設定されています。

minDepth()も参照して ください。

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

ビューポートの位置とサイズをx,y,w,h に設定します。

注意： ビューポートは、左下を原点とする座標系で指定されます。

viewport()も参照 。

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

ビューポートの x, y, width, height を返します。

setViewport()も参照して ください。

関連する非メンバ

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

seed を計算の種として、v のハッシュ値を返します。

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

2 つのQRhiViewport オブジェクトa とb の値が等しい場合はfalse を返し、そうでない場合はtrue を返します。

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

つのQRhiViewport オブジェクトa とb の値が等しい場合、true を返します。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。