QSurface Class

QSurface 클래스는 Qt에서 렌더링 가능한 표면을 추상화한 것입니다. 더 보기...

헤더:	`#include <QSurface>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::Gui)`
qmake:	`QT += gui`
상속된 항목:	QOffscreenSurface 그리고 QWindow

상속받은 멤버를 포함한 모든 멤버 목록

공개 유형

enum	SurfaceClass { Window, Offscreen }
enum	SurfaceType { RasterSurface, OpenGLSurface, OpenVGSurface, VulkanSurface, MetalSurface, 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 열거형은 서페이스의 실제 하위 클래스를 나타냅니다.

상수	값	설명
`QSurface::Window`	`0`	이 서피스는 ` QWindow`의 인스턴스입니다.
`QSurface::Offscreen`	`1`	표면은 QOffscreenSurface 의 인스턴스입니다.

enum QSurface::SurfaceType

SurfaceType 열거형은 이 표면의 유형을 나타냅니다.

상수	값	설명
`QSurface::RasterSurface`	`0`	이 서페이스는 픽셀로 구성되어 있으며, Qt의 래스터 페인트 엔진과 같은 소프트웨어 래스터라이저를 사용하여 렌더링할 수 있습니다.
`QSurface::OpenGLSurface`	`1`	이 표면은 OpenGL과 호환되는 표면이며, QOpenGLContext 와 함께 사용할 수 있습니다.
`QSurface::OpenVGSurface`	`3`	이 서페이스는 OpenVG 호환 서페이스이며, OpenVG 컨텍스트와 함께 사용할 수 있습니다.
`QSurface::VulkanSurface`	`4`	이 서페이스는 Vulkan 호환 서페이스이며, Vulkan 그래픽 API와 함께 사용할 수 있습니다.
`QSurface::MetalSurface`	`5`	이 표면은 Metal 호환 표면이며 Apple의 Metal 그래픽 API와 함께 사용할 수 있습니다. 이 표면 유형은 macOS 및 iOS에서만 지원됩니다.
`QSurface::Direct3DSurface`	`6`	이 표면은 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

표면의 유형을 반환합니다.

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