Back to Qt.io
Contact Us Blog Download Qt
本页内容

Qt3DRender::QRenderTargetOutput Class

class Qt3DRender::QRenderTargetOutput

QRenderTargetOutput 类允许指定渲染目标的附件（无论是颜色纹理、深度纹理等……）。更多内容……

头文件： #include <qrendertargetoutput.h>
CMake： find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake： QT += 3drender
在 QML 中： RenderTargetOutput
继承自： Qt3DCore::QNode
状态： 已弃用

该类已弃用。我们强烈建议在新代码中不要使用它。

公共类型

enum AttachmentPoint { Color0, Color1, Color2, Color3, Color4, …, Right }

属性

公共函数

QRenderTargetOutput(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint() const
Qt3DRender::QAbstractTexture::CubeMapFace face() const
int layer() const
int mipLevel() const
Qt3DRender::QAbstractTexture *texture() const

公共槽位

void setAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint)
void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)
void setLayer(int layer)
void setMipLevel(int level)
void setTexture(Qt3DRender::QAbstractTexture *texture)

信号

void attachmentPointChanged(Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint)
void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)
void layerChanged(int layer)
void mipLevelChanged(int mipLevel)
void textureChanged(Qt3DRender::QAbstractTexture *texture)

详细说明

QRenderTargetOutput 指定了附加到渲染目标的纹理的附加点和参数。除了附加点之外，还可以指定纹理的 Mip 级别、图层和立方贴图面。附加到 QRenderTargetOutput 上的纹理必须与给定的参数兼容。

注意：左（Left） 和右（Right）附着点是特殊值。它们不指向渲染目标对象，而是指用于立体渲染的两个后缓冲区中的任意一个。

成员类型文档

enum QRenderTargetOutput::AttachmentPoint

此枚举指定了连接点的值。

常量值描述
Qt3DRender::QRenderTargetOutput::Color00索引为 0 的颜色锚点
Qt3DRender::QRenderTargetOutput::Color11索引为 1 的颜色连接点
Qt3DRender::QRenderTargetOutput::Color22索引为 2 的颜色锚点
Qt3DRender::QRenderTargetOutput::Color33索引 3 处的颜色锚点
Qt3DRender::QRenderTargetOutput::Color44索引为 4 的颜色锚点
Qt3DRender::QRenderTargetOutput::Color55索引 5 处的颜色锚点
Qt3DRender::QRenderTargetOutput::Color66索引 6 处的颜色锚点
Qt3DRender::QRenderTargetOutput::Color77索引 7 处的颜色锚点
Qt3DRender::QRenderTargetOutput::Color88索引 8 处的颜色连接点
Qt3DRender::QRenderTargetOutput::Color99索引 9 处的颜色连接点
Qt3DRender::QRenderTargetOutput::Color1010索引 10 处的颜色连接点
Qt3DRender::QRenderTargetOutput::Color1111索引 11 处的颜色连接点
Qt3DRender::QRenderTargetOutput::Color1212索引 12 处的颜色连接点
Qt3DRender::QRenderTargetOutput::Color1313索引 13 处的颜色锚点
Qt3DRender::QRenderTargetOutput::Color1414索引 14 处的颜色连接点
Qt3DRender::QRenderTargetOutput::Color1515索引 15 处的颜色锚点
Qt3DRender::QRenderTargetOutput::Depth16深度锚点
Qt3DRender::QRenderTargetOutput::Stencil17模板锚点
Qt3DRender::QRenderTargetOutput::DepthStencil18深度模板锚点
Qt3DRender::QRenderTargetOutput::Left19背面左侧绘制缓冲区
Qt3DRender::QRenderTargetOutput::Right20后右绘制缓冲区

属性文档

attachmentPoint : AttachmentPoint

用于固定QRenderTargetOutput 的安装点。

访问功能：

Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint() const
void setAttachmentPoint(Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint)

通知信号：

void attachmentPointChanged(Qt3DRender::QRenderTargetOutput::AttachmentPoint attachmentPoint)

face : Qt3DRender::QAbstractTexture::CubeMapFace

保存渲染所指向的已附加立方贴图纹理的某个面。

访问函数：

Qt3DRender::QAbstractTexture::CubeMapFace face() const
void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)

通知器信号：

void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)

layer : int

保存渲染所指向的附加纹理的图层。

访问函数：

int layer() const
void setLayer(int layer)

通知器信号：

void layerChanged(int layer)

mipLevel : int

保存渲染所指向的附加纹理的MIP级别。

访问函数：

int mipLevel() const
void setMipLevel(int level)

通知信号：

void mipLevelChanged(int mipLevel)

texture : QAbstractTexture*

保存附加到附加点上的纹理。

访问函数：

Qt3DRender::QAbstractTexture *texture() const
void setTexture(Qt3DRender::QAbstractTexture *texture)

通知器信号：

void textureChanged(Qt3DRender::QAbstractTexture *texture)

成员函数文档

[explicit] QRenderTargetOutput::QRenderTargetOutput(Qt3DCore::QNode *parent = nullptr)

该构造函数会使用指定的parent 创建一个新的QRenderTargetOutput::QRenderTargetOutput 实例。

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