이 페이지에서

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가 콘텐츠를 렌더링할 표면을 선택하는 데 사용됩니다. 표면은 창 표면이거나 오프스크린 표면일 수 있습니다. 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.