QSGAbstractRenderer Class
QSGAbstractRenderer gives access to the scene graph nodes and rendering of a QSGEngine. 更多...
| 头文件: | #include <QSGAbstractRenderer> |
| qmake: | QT += quick |
| 开始支持版本: | Qt 5.4 |
| 基类: | QObject |
公有类型
| flags | ClearMode |
| enum | ClearModeBit { ClearColorBuffer, ClearDepthBuffer, ClearStencilBuffer } |
公有函数
| QColor | clearColor() const |
| ClearMode | clearMode() const |
| QRect | deviceRect() const |
| QMatrix4x4 | projectionMatrix() const |
| virtual void | renderScene(GLuint fboId = 0) = 0 |
| QSGRootNode * | rootNode() const |
| void | setClearColor(const QColor &color) |
| void | setClearMode(ClearMode mode) |
| void | setDeviceRect(const QRect &rect) |
| void | setDeviceRect(const QSize &size) |
| void | setProjectionMatrix(const QMatrix4x4 &matrix) |
| void | setProjectionMatrixToRect(const QRectF &rect) |
| void | setRootNode(QSGRootNode *node) |
| void | setViewportRect(const QRect &rect) |
| void | setViewportRect(const QSize &size) |
| QRect | viewportRect() const |
- 32 个公有函数继承自 QObject
信号
| void | sceneGraphChanged() |
- 2 个信号继承自 QObject
其他继承的成员
- 1 个属性继承自 QObject
- 1 个公有槽函数继承自 QObject
- 1 个公有变量继承自 QObject
- 10 个静态公有成员继承自 QObject
- 9 个受保护的函数继承自 QObject
- 2 个受保护的变量继承自 QObject
详细描述
QSGAbstractRenderer gives access to the scene graph nodes and rendering of a QSGEngine.
A QSGAbstractRenderer created by a QSGEngine allows you to set your QSGNode tree through setRootNode() and control the rendering viewport through setDeviceRect(), setViewportRect() and setProjectionMatrixToRect(). You can finally trigger the rendering to the desired framebuffer through renderScene().
The QSGAbstractRenderer is only available when used with a QSGEngine and isn't exposed when used internally by QQuickWindow.
成员类型
enum QSGAbstractRenderer::ClearModeBit
flags QSGAbstractRenderer::ClearMode
Used with setClearMode() to indicate which buffer should be cleared before the scene render.
| Constant | Value | Description |
|---|---|---|
QSGAbstractRenderer::ClearColorBuffer | 0x0001 | Clear the color buffer using clearColor(). |
QSGAbstractRenderer::ClearDepthBuffer | 0x0002 | Clear the depth buffer. |
QSGAbstractRenderer::ClearStencilBuffer | 0x0004 | Clear the stencil buffer. |
The ClearMode type is a typedef for QFlags<ClearModeBit>. It stores an OR combination of ClearModeBit values.
参见 setClearMode() and setClearColor().
成员函数
QColor QSGAbstractRenderer::clearColor() const
Returns the color that clears the framebuffer at the beginning of the rendering.
参见 setClearColor() and clearMode().
ClearMode QSGAbstractRenderer::clearMode() const
Flags defining which attachment of the framebuffer will be cleared before each scene render.
参见 setClearMode() and clearColor().
QRect QSGAbstractRenderer::deviceRect() const
Returns the device rect of the surface being rendered to.
参见 setDeviceRect().
QMatrix4x4 QSGAbstractRenderer::projectionMatrix() const
Returns the projection matrix
参见 setProjectionMatrix() and setProjectionMatrixToRect().
[pure virtual] void QSGAbstractRenderer::renderScene(GLuint fboId = 0)
Render the scene to the specified fboId
If fboId isn't specified, the scene graph will be rendered to the default framebuffer. You will have to call QOpenGLContext::swapBuffers() yourself afterward.
The framebuffer specified by fboId will be bound automatically.
参见 QOpenGLContext::swapBuffers() and QOpenGLFramebufferObject::handle().
QSGRootNode *QSGAbstractRenderer::rootNode() const
Returns the root of the QSGNode scene.
参见 setRootNode().
[signal] void QSGAbstractRenderer::sceneGraphChanged()
This signal is emitted on the first modification of a node in the tree after the last scene render.
void QSGAbstractRenderer::setClearColor(const QColor &color)
Use color to clear the framebuffer when clearMode() is set to QSGAbstractRenderer::ClearColorBuffer.
参见 clearColor() and setClearMode().
void QSGAbstractRenderer::setClearMode(ClearMode mode)
Defines which attachment of the framebuffer should be cleared before each scene render with the mode flag.
参见 clearMode() and setClearColor().
void QSGAbstractRenderer::setDeviceRect(const QRect &rect)
Sets rect as the geometry of the surface being rendered to.
参见 deviceRect().
void QSGAbstractRenderer::setDeviceRect(const QSize &size)
This is an overloaded function.
Sets the size of the surface being rendered to.
参见 deviceRect().
void QSGAbstractRenderer::setProjectionMatrix(const QMatrix4x4 &matrix)
Use matrix to project the QSGNode coordinates onto surface pixels.
参见 projectionMatrix() and setProjectionMatrixToRect().
void QSGAbstractRenderer::setProjectionMatrixToRect(const QRectF &rect)
Convenience method that calls setProjectionMatrix() with an orthographic matrix generated from rect.
参见 setProjectionMatrix() and projectionMatrix().
void QSGAbstractRenderer::setRootNode(QSGRootNode *node)
Sets the node as the root of the QSGNode scene that you want to render. You need to provide a node before trying to render the scene.
Note: This doesn't take ownership of node.
参见 rootNode().
void QSGAbstractRenderer::setViewportRect(const QRect &rect)
Sets rect as the geometry of the viewport to render on the surface.
参见 viewportRect().
void QSGAbstractRenderer::setViewportRect(const QSize &size)
This is an overloaded function.
Sets the size of the viewport to render on the surface.
参见 viewportRect().
QRect QSGAbstractRenderer::viewportRect() const
Returns the rect of the viewport to render.
参见 setViewportRect().