이 페이지에서

Qt3DRender::QViewport Class

class Qt3DRender::QViewport

Qt3D 씬의 뷰포트. 더 보기...

헤더: #include <qviewport.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML에서: Viewport
상속: Qt3DRender::QFrameGraphNode
상태: 사용 중단됨

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

속성

공개 함수

QViewport(Qt3DCore::QNode *parent = nullptr)
float gamma() const
QRectF normalizedRect() const

공개 슬롯

void setGamma(float gamma)
void setNormalizedRect(const QRectF &normalizedRect)

신호

void gammaChanged(float gamma)
void normalizedRectChanged(const QRectF &normalizedRect)

상세 설명

Qt3DRender::QViewport 씬의 이 속성은 Qt3D가 렌더링 표면의 어느 부분에 렌더링할지 지정합니다. 뷰포트 외부의 영역은 변경되지 않습니다. 또한 감마와 같이 해당 뷰포트의 렌더링에 대한 전역 매개변수도 제어합니다.

속성 문서

gamma : float

뷰포트의 감마 계수를 지정합니다. 기본값은 2.2이며, 대부분의 화면에서 적절한 결과를 보여줍니다.

액세스 함수:

float gamma() const
void setGamma(float gamma)

알림 신호:

void gammaChanged(float gamma)

normalizedRect : QRectF

뷰포트의 정규화된 사각형을 지정합니다. 즉, 뷰포트 사각형은 렌더링 표면 크기를 기준으로 상대적으로 지정됩니다. 표면 전체 크기를 차지하는 뷰포트는 [0.0, 0.0, 1.0, 1.0]으로 지정되며, 이것이 기본값입니다.

액세스 함수:

QRectF normalizedRect() const
void setNormalizedRect(const QRectF &normalizedRect)

알림 신호:

void normalizedRectChanged(const QRectF &normalizedRect)

멤버 함수 문서

[explicit] QViewport::QViewport(Qt3DCore::QNode *parent = nullptr)

지정된 ` parent`를 사용하여 `QViewport`를 생성합니다.

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