Qt3DRender::QRenderSurfaceSelector Class
class Qt3DRender::QRenderSurfaceSelector提供一种指定渲染表面的方法。更多
| Header： | #include <QRenderSurfaceSelector> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake： | QT += 3drender |
| 在 QML 中： | RenderSurfaceSelector |
| 继承： | Qt3DRender::QFrameGraphNode |
| 状态： | 已废弃 |
属性
- externalRenderTargetSize : QSize
- surface : QObject*
- surfacePixelRatio : float
公共功能
| QRenderSurfaceSelector(Qt3DCore::QNode *parent = nullptr) | |
| QSize | externalRenderTargetSize() const |
| QObject * | surface() const |
| float | surfacePixelRatio() const |
公共插槽
| void | setExternalRenderTargetSize(const QSize &size) |
| void | setSurface(QObject *surfaceObject) |
| void | setSurfacePixelRatio(float ratio) |
信号
| void | externalRenderTargetSizeChanged(const QSize &size) |
| void | surfaceChanged(QObject *surface) |
| void | surfacePixelRatioChanged(float ratio) |
详细说明
Qt3DRender::QRenderSurfaceSelector 可用于选择 Qt3D 渲染内容的表面。曲面可以是窗口曲面或屏幕外曲面。当使用离屏表面时，externalRenderTargetSize 用于指定表面的实际大小。
当系统使用 DPI 缩放时，鼠标事件使用的逻辑表面尺寸和表面的实际 "物理 "尺寸可能会不同。surfacePixelRatio 是将逻辑尺寸转换为物理尺寸的因子。
另请参阅 QWindow,QOffscreenSurface, 和QSurface 。
属性文档
externalRenderTargetSize : QSize
保存外部渲染目标的大小。
访问功能：
| QSize | externalRenderTargetSize() const |
| void | setExternalRenderTargetSize(const QSize &size) |
通知信号：
| void | externalRenderTargetSizeChanged(const QSize &size) |
surface : QObject*
固定表面
访问功能：
| QObject * | surface() const |
| void | setSurface(QObject *surfaceObject) |
提示信号
| void | surfaceChanged(QObject *surface) |
surfacePixelRatio : float
保存曲面的表面像素比例。
访问功能：
| float | surfacePixelRatio() const |
| void | setSurfacePixelRatio(float ratio) |
通知信号：
| void | surfacePixelRatioChanged(float ratio) |
成员函数 文档
[explicit] QRenderSurfaceSelector::QRenderSurfaceSelector(Qt3DCore::QNode *parent = nullptr)
使用给定的parent 构建 QRenderSurfaceSelector。
[slot] void QRenderSurfaceSelector::setExternalRenderTargetSize(const QSize &size)
设置渲染目标size （如果与底层表面尺寸不同）。告诉拾取正确的尺寸。
注： externalRenderTargetSize 属性的设置函数。
另请参阅 externalRenderTargetSize().
[slot] void QRenderSurfaceSelector::setSurface(QObject *surfaceObject)
设置surfaceObject 。
注： 属性surface 的设置函数。
另请参见 surface() 。
© 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.
