QRhiViewport 类

指定一个视口矩形。更多...

头文件	#include <QRhiViewport>
CMake	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake	QT += gui
自	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 风格的视口坐标，意味着 x 和 y 是左下角。不允许负宽度或高度。

典型用法如下

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、宽度和高度。

另请参阅：setViewport。

QRhiViewport 类

公共函数

详细描述

成员函数文档

`[constexpr noexcept]` QRhiViewport::QRhiViewport()

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

float QRhiViewport::maxDepth() const

float QRhiViewport::minDepth() const

void QRhiViewport::setMaxDepth(float maxDepth)

void QRhiViewport::setMinDepth(float minDepth)

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

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

相关非成员函数

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

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

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

QRhiViewport 类

公共函数

相关非成员函数

详细描述

成员函数文档

[constexpr noexcept] QRhiViewport::QRhiViewport()

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

float QRhiViewport::maxDepth() const

float QRhiViewport::minDepth() const

void QRhiViewport::setMaxDepth(float maxDepth)

void QRhiViewport::setMinDepth(float minDepth)

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

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

相关非成员函数

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

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

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

`[constexpr noexcept]` QRhiViewport::QRhiViewport()

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

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

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