Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
QSSGFrameData Class Reference

\inmodule QtQuick3D More...

#include <qssgrenderextensions.h>

Collaboration diagram for QSSGFrameData:

Classes

struct  Result

Public Types

enum class  RenderResult : quint32 {
  AoTexture , DepthTexture , DepthTextureMS , ScreenTexture ,
  AccumTexture , RevealageTexture , NormalTexture
}
using TypeMask = QSSGRenderGraphObject::TypeT

Public Member Functions

void scheduleRenderResults (RenderResults results) const
 Schedule the given results to be made available for this frame.
Result getRenderResult (RenderResult id) const
QSSGRhiGraphicsPipelineState getPipelineState () const
QSSGCameraId activeCamera () const
QSSGRenderContextInterface * contextInterface () const
QSSGNodeIdList getLayerNodes (quint32 layerMask, TypeMask typeMask=NodeMask) const
QSSGNodeIdList getLayerNodes (QSSGCameraId cameraId, TypeMask typeMask=NodeMask) const

Static Public Attributes

static constexpr TypeMask NodeMask = QSSGRenderGraphObject::BaseType::Node

Friends

class QSSGLayerRenderData
class QSSGRenderHelpers

Detailed Description

\inmodule QtQuick3D

Since
6.7

Storage class containing data collected for a frame.

Definition at line 29 of file qssgrenderextensions.h.

Member Typedef Documentation

◆ TypeMask

using QSSGFrameData::TypeMask = QSSGRenderGraphObject::TypeT

Definition at line 50 of file qssgrenderextensions.h.

Member Enumeration Documentation

◆ RenderResult

enum class QSSGFrameData::RenderResult : quint32
strong
Enumerator
AoTexture 
DepthTexture 
DepthTextureMS 
ScreenTexture 
AccumTexture 
RevealageTexture 
NormalTexture 

Definition at line 32 of file qssgrenderextensions.h.

Member Function Documentation

◆ activeCamera()

QSSGCameraId QSSGFrameData::activeCamera ( ) const
nodiscard
Returns
The active camera for the scene, or null if non could be found.

Definition at line 90 of file qssgrenderextensions.cpp.

◆ contextInterface()

QSSGRenderContextInterface * QSSGFrameData::contextInterface ( ) const
nodiscard

Definition at line 101 of file qssgrenderextensions.cpp.

◆ getLayerNodes() [1/2]

QSSGNodeIdList QSSGFrameData::getLayerNodes ( QSSGCameraId cameraId,
TypeMask typeMask = NodeMask ) const
nodiscard
Returns
A list of layer nodes for the given cameraId that match the typeMask. If the camera does not have a layer mask, an empty list is returned.

Definition at line 124 of file qssgrenderextensions.cpp.

◆ getLayerNodes() [2/2]

QSSGNodeIdList QSSGFrameData::getLayerNodes ( quint32 layerMask,
TypeMask typeMask = NodeMask ) const
nodiscard
Returns
A list of layer nodes that match the layerMask and typeMask.

Definition at line 109 of file qssgrenderextensions.cpp.

◆ getPipelineState()

QSSGRhiGraphicsPipelineState QSSGFrameData::getPipelineState ( ) const
nodiscard
Returns
Base pipeline state for this frame

Definition at line 80 of file qssgrenderextensions.cpp.

◆ getRenderResult()

QSSGFrameData::Result QSSGFrameData::getRenderResult ( RenderResult id) const
Returns
The renderable texture result from id. \nullptr if no matching id was found.
Note
Even if the function returns a non-null result, the returned QSSGRhiRenderableTexture might not be ready unless the pass rendering to the texture has been executed.
The returned value is only valid within the current frame. On each new frame the renderable will be reset and should therefore be queried again.

Definition at line 28 of file qssgrenderextensions.cpp.

◆ scheduleRenderResults()

void QSSGFrameData::scheduleRenderResults ( RenderResults results) const

Schedule the given results to be made available for this frame.

This function should only be called during the prepare phase in \l QSSGRenderExtension::prepareData().

Note
The requested results might not be available if the underlying layer does not support them or if the layer does not contain any data that would make it necessary to produce the requested results, in which case \l getRenderResult() will return a empty result.
See also
QSSGRenderExtension::getRenderResult()

Definition at line 51 of file qssgrenderextensions.cpp.

◆ QSSGLayerRenderData

friend class QSSGLayerRenderData
friend

Definition at line 67 of file qssgrenderextensions.h.

◆ QSSGRenderHelpers

friend class QSSGRenderHelpers
friend

Definition at line 68 of file qssgrenderextensions.h.

Member Data Documentation

◆ NodeMask

TypeMask QSSGFrameData::NodeMask = QSSGRenderGraphObject::BaseType::Node
staticconstexpr

Definition at line 51 of file qssgrenderextensions.h.

The documentation for this class was generated from the following files: