QForwardRenderer Class

class Qt3DExtras::QForwardRenderer

QForwardRenderer は、デフォルトのFrameGraph実装の順方向レンダラーを提供します。詳細...

ヘッダ #include <QForwardRenderer>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake QT += 3dextras
QML で ForwardRenderer
を継承しています: Qt3DRender::QTechniqueFilter
ステータス非推奨

プロパティ

パブリック機能

Qt3DRender::QClearBuffers::BufferType buffersToClear() const
Qt3DCore::QEntity *camera() const
QColor clearColor() const
QSize externalRenderTargetSize() const
float gamma() const
bool isFrustumCullingEnabled() const
bool showDebugOverlay() const
QObject *surface() const
QRectF viewportRect() const

パブリックスロット

void setBuffersToClear(Qt3DRender::QClearBuffers::BufferType)
void setCamera(Qt3DCore::QEntity *camera)
void setClearColor(const QColor &clearColor)
void setExternalRenderTargetSize(const QSize &size)
void setFrustumCullingEnabled(bool enabled)
void setGamma(float gamma)
void setShowDebugOverlay(bool showDebugOverlay)
void setSurface(QObject *surface)
void setViewportRect(const QRectF &viewportRect)

シグナル

void buffersToClearChanged(Qt3DRender::QClearBuffers::BufferType)
void cameraChanged(Qt3DCore::QEntity *camera)
void clearColorChanged(const QColor &clearColor)
void externalRenderTargetSizeChanged(const QSize &size)
void frustumCullingEnabledChanged(bool enabled)
void gammaChanged(float gamma)
void showDebugOverlayChanged(bool showDebugOverlay)
void surfaceChanged(QObject *surface)
void viewportRectChanged(const QRectF &viewportRect)

詳細説明

フォワード・レンダリングは、OpenGLが伝統的に使用しているものです。これは、一度に1つのオブジェクトをシェーディングしながらバックバッファに直接レンダリングします。

QForwardRendererは、Qt3DRender::QViewportQt3DRender::QCameraSelectorQt3DRender::QClearBuffers を含む1つのリーフのFrameGraphツリーです。 QForwardRendererは、名前が "renderingStyle"、値が "forward "であるデフォルトの要件フィルタキーを持っています。テクニックをフィルタリングする必要がある場合は、このフィルタキーに基づいて行う必要があります。

デフォルトでは、ビューポートは画面全体を占め、クリアカラーは白です。フルスタムカリングも有効になっている。

プロパティの説明

buffersToClear : Qt3DRender::QClearBuffers::BufferType

クリアされる現在のバッファを保持する。デフォルト値は ColorDepthBuffer。

アクセス関数:

Qt3DRender::QClearBuffers::BufferType buffersToClear() const
void setBuffersToClear(Qt3DRender::QClearBuffers::BufferType)

通知シグナル:

void buffersToClearChanged(Qt3DRender::QClearBuffers::BufferType)

camera : Qt3DCore::QEntity*

シーンのレンダリングに使用される現在のカメラエンティティを保持します。

注: カメラは、QCameraLens をコンポーネントの 1 つとして持つ QEntity です。

アクセス関数:

Qt3DCore::QEntity *camera() const
void setCamera(Qt3DCore::QEntity *camera)

通知シグナル:

void cameraChanged(Qt3DCore::QEntity *camera)

clearColor : QColor

シーンの現在のクリアカラーを保持する。レンダリング前にフレームバッファはクリアカラーに初期化される。

アクセス関数:

QColor clearColor() const
void setClearColor(const QColor &clearColor)

通知シグナル

void clearColorChanged(const QColor &clearColor)

externalRenderTargetSize : QSize

外部レンダーターゲットのサイズを含む。外部レンダーターゲットは、レンダリングがウィンドウサーフェスをターゲットにしない場合に関連します(surface で設定)。

アクセス関数:

QSize externalRenderTargetSize() const
void setExternalRenderTargetSize(const QSize &size)

通知シグナル:

void externalRenderTargetSizeChanged(const QSize &size)

frustumCulling : bool

レンダラーがシーンにフラストラムカリングを適用するかどうかを示します。

アクセス関数:

bool isFrustumCullingEnabled() const
void setFrustumCullingEnabled(bool enabled)

通知シグナル

void frustumCullingEnabledChanged(bool enabled)

gamma : float

レンダラーがシーンに適用するガンマ値を保持します。

アクセス関数:

float gamma() const
void setGamma(float gamma)

通知シグナル

void gammaChanged(float gamma)

showDebugOverlay : bool

trueの場合、デバッグオーバーレイがシーン上にレンダリングされます。このオーバーレイは、実行時のレンダリング状態に関する詳細情報を表示し、ユーザーがロギングのオンとオフを切り替えられるようにします。

アクセス関数

bool showDebugOverlay() const
void setShowDebugOverlay(bool showDebugOverlay)

通知シグナル

void showDebugOverlayChanged(bool showDebugOverlay)

surface : QObject*

現在のレンダーサーフェスを保持します。

アクセス関数:

QObject *surface() const
void setSurface(QObject *surface)

通知シグナル

void surfaceChanged(QObject *surface)

viewportRect : QRectF

現在の正規化されたビューポート矩形を保持します。

アクセス関数:

QRectF viewportRect() const
void setViewportRect(const QRectF &viewportRect)

通知シグナル:

void viewportRectChanged(const QRectF &viewportRect)

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