Back to Qt.io
Contact Us Blog Download Qt

Qt3DRender::QRenderTargetOutput Class

class Qt3DRender::QRenderTargetOutput

QRenderTargetOutput 类允许指定渲染目标的附件（无论是色彩纹理还是深度纹理......）。更多

头文件： #include <QRenderTargetOutput>
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 用于指定附着到渲染目标的纹理的附着点和参数。除了附着点外，还可以指定纹理的 miplevel、图层和立方体贴图面。附加到 QRenderTargetOutput 的纹理必须与给定的参数兼容。

注意： 左侧和右侧附着点是特殊值。它们不指向用于立体渲染的任何一个背面缓冲区的渲染目标对象。

成员类型文档

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

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

访问功能：

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 实例。

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