Qt3DRender::QRenderSurfaceSelector Class
class Qt3DRender::QRenderSurfaceSelector提供了一种指定渲染表面的方法。更多内容...
| 标题： | #include <qrendersurfaceselector.h> |
| 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
存储该画布的 surfacePixelRatio 值。
访问函数：
| 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()。
© 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.
