このページでは

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
ステータス: 非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

パブリック関数

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 がコンテンツをレンダリングするサーフェスを選択できます。サーフェスには、ウィンドウサーフェスとオフスクリーンサーフェスの2種類があります。オフスクリーンサーフェスを使用する場合、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.