QSurface Class

QSurface 클래스는 Qt에서 렌더링 가능한 서페이스의 추상화입니다. 더 보기...

Header: #include <QSurface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
상속됨:

QOffscreenSurfaceQWindow

공용 타입

enum SurfaceClass { Window, Offscreen }
enum SurfaceType { RasterSurface, OpenGLSurface, RasterGLSurface, OpenVGSurface, VulkanSurface, …, Direct3DSurface }

공용 함수

virtual ~QSurface()
virtual QSurfaceFormat format() const = 0
virtual QSize size() const = 0
bool supportsOpenGL() const
QSurface::SurfaceClass surfaceClass() const
virtual QPlatformSurface *surfaceHandle() const = 0
virtual QSurface::SurfaceType surfaceType() const = 0

보호된 함수

QSurface(QSurface::SurfaceClass type)

상세 설명

서페이스의 크기는 size() 함수로 액세스할 수 있습니다. 표면의 렌더링 특정 속성은 format() 함수를 통해 액세스할 수 있습니다.

멤버 유형 문서

enum QSurface::SurfaceClass

SurfaceClass 열거형은 표면의 실제 서브클래스를 설명합니다.

Constant설명
QSurface::Window0서페이스는 QWindow 의 인스턴스입니다.
QSurface::Offscreen1서페이스는 QOffscreenSurface 의 인스턴스입니다.

enum QSurface::SurfaceType

SurfaceType 열거형은 어떤 유형의 표면인지 설명합니다.

Constant설명
QSurface::RasterSurface0서페이스는 픽셀로 구성되며 Qt의 래스터 페인트 엔진과 같은 소프트웨어 래스터라이저를 사용하여 렌더링할 수 있습니다.
QSurface::OpenGLSurface1이 서페이스는 OpenGL 호환 서페이스이며 QOpenGLContext 와 함께 사용할 수 있습니다.
QSurface::RasterGLSurface2이 서페이스는 소프트웨어 래스터라이저를 사용하여 렌더링할 수 있으며 OpenGL도 지원합니다. 이 서페이스 유형은 내부 Qt 사용을 위한 것으로, 비공개 API를 사용해야 합니다.
QSurface::OpenVGSurface3이 서페이스는 OpenVG 호환 서페이스이며 OpenVG 컨텍스트와 함께 사용할 수 있습니다.
QSurface::VulkanSurface4이 서페이스는 벌칸 호환 서페이스이며 벌칸 그래픽 API와 함께 사용할 수 있습니다.
QSurface::MetalSurface5이 서페이스는 Metal 호환 서페이스이며 Apple의 Metal 그래픽 API와 함께 사용할 수 있습니다. 이 서피스 유형은 macOS 및 iOS에서만 지원됩니다.
QSurface::Direct3DSurface6이 서페이스는 Direct 3D 11 및 12 호환 서페이스이며 DXGI 및 Direct3D API와 함께 사용할 수 있습니다. 이 서피스 유형은 Windows에서만 지원됩니다.

멤버 함수 문서

[explicit protected] QSurface::QSurface(QSurface::SurfaceClass type)

주어진 type 으로 서페이스를 생성합니다.

[virtual noexcept] QSurface::~QSurface()

표면을 파괴합니다.

[pure virtual] QSurfaceFormat QSurface::format() const

서페이스의 형식을 반환합니다.

[pure virtual] QSize QSurface::size() const

서페이스의 크기를 픽셀 단위로 반환합니다.

bool QSurface::supportsOpenGL() const

서페이스가 OpenGL과 호환되고 QOpenGLContext 와 함께 사용할 수 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

QSurface::SurfaceClass QSurface::surfaceClass() const

이 서페이스의 서피스 클래스를 반환합니다.

[pure virtual] QPlatformSurface *QSurface::surfaceHandle() const

서페이스의 플랫폼별 구현에 대한 핸들을 반환합니다.

[pure virtual] QSurface::SurfaceType QSurface::surfaceType() const

서페이스의 유형을 반환합니다.

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