QSurfaceFormat Class

멤버 함수 문서

QSurfaceFormat::QSurfaceFormat()

기본값으로 초기화된 QSurfaceFormat을 생성합니다.

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

주어진 형식 options 을 사용하여 QSurfaceFormat을 생성합니다.

QSurfaceFormat::QSurfaceFormat(const QSurfaceFormat &other)

other 의 복사본을 생성합니다.

[noexcept] QSurfaceFormat::~QSurfaceFormat()

QSurfaceFormat 를 삭제합니다.

int QSurfaceFormat::alphaBufferSize() const

색상 버퍼의 알파 채널 크기를 비트 단위로 가져옵니다.

setAlphaBufferSize()도 참조하십시오 .

int QSurfaceFormat::blueBufferSize() const

색상 버퍼의 파란색 채널 크기를 비트 단위로 가져옵니다.

setBlueBufferSize()도 참조하십시오 .

const QColorSpace &QSurfaceFormat::colorSpace() const

색 공간을 반환합니다.

setColorSpace()도 참조하십시오 .

[static] QSurfaceFormat QSurfaceFormat::defaultFormat()

전역 기본 표면 형식을 반환합니다.

setDefaultFormat()가 호출되지 않은 경우, 이는 기본 생성된 QSurfaceFormat 입니다.

setDefaultFormat()도 참조하십시오 .

int QSurfaceFormat::depthBufferSize() const

깊이 버퍼의 크기를 반환합니다.

setDepthBufferSize()도 참조하십시오 .

int QSurfaceFormat::greenBufferSize() const

색상 버퍼의 녹색 채널 크기를 비트 단위로 가져옵니다.

setGreenBufferSize()도 참조하십시오 .

bool QSurfaceFormat::hasAlpha() const

알파 버퍼 크기가 0보다 크면 ` true `를 반환합니다.

이는 해당 서페이스가 픽셀 단위 반투명 효과와 함께 사용될 수 있음을 의미합니다.

int QSurfaceFormat::majorVersion() const

OpenGL의 주요 버전을 반환합니다.

기본 버전은 2.0입니다.

setMajorVersion()도 참조하십시오 .

int QSurfaceFormat::minorVersion() const

OpenGL의 부버전을 반환합니다.

setMinorVersion()도 참조하십시오 .

QSurfaceFormat::FormatOptions QSurfaceFormat::options() const

현재 설정된 형식 옵션을 반환합니다.

setOption(), setOptions(), testOption()도 참조하십시오 .

QSurfaceFormat::OpenGLContextProfile QSurfaceFormat::profile() const

구성된 OpenGL 컨텍스트 프로필을 가져옵니다.

요청된 OpenGL 버전이 3.2 미만인 경우 이 설정은 무시됩니다.

setProfile()도 참조하십시오 .

int QSurfaceFormat::redBufferSize() const

색상 버퍼의 빨간색 채널 크기를 비트 단위로 가져옵니다.

setRedBufferSize()도 참조하십시오 .

QSurfaceFormat::RenderableType QSurfaceFormat::renderableType() const

렌더링 가능한 유형을 가져옵니다.

데스크톱 OpenGL, OpenGL ES 및 OpenVG 중에서 선택합니다.

setRenderableType()도 참조하십시오 .

int QSurfaceFormat::samples() const

멀티샘플링이 활성화된 경우 픽셀당 샘플 수를 반환하고, 멀티샘플링이 비활성화된 경우 ` -1 `를 반환합니다. 기본 반환 값은 ` -1`입니다.

setSamples()도 참조하십시오 .

void QSurfaceFormat::setAlphaBufferSize(int size)

색상 버퍼의 알파 채널 비트에 원하는 size 를 설정합니다.

alphaBufferSize()함수도 참조하십시오 .

void QSurfaceFormat::setBlueBufferSize(int size)

색상 버퍼의 파란색 채널에 원하는 size 을 비트 단위로 설정합니다.

blueBufferSize()도 참조하십시오 .

[since 6.0] void QSurfaceFormat::setColorSpace(const QColorSpace &colorSpace)

선호하는 colorSpace 를 설정합니다.

예를 들어, 이를 통해 sRGB를 지원하는 플랫폼에서 sRGB를 지원하는 기본 프레임버퍼를 가진 창을 요청할 수 있습니다.

이 함수는 Qt 6.0에서 도입되었습니다.

colorSpace()도 참조하십시오 .

[static] void QSurfaceFormat::setDefaultFormat(const QSurfaceFormat &format)

전역 기본 표면 format 을 설정합니다.

이 형식은 QOpenGLContext, QWindow, QOpenGLWidget 및 이와 유사한 클래스에서 기본적으로 사용됩니다.

해당 클래스 고유의 setFormat() 함수를 사용하여 인스턴스 단위로 언제든지 재정의할 수 있습니다. 그러나 애플리케이션 시작 시 모든 창의 형식을 한 번에 설정하는 것이 더 편리한 경우가 많습니다. 또한 이 함수를 통해 형식을 설정하면 Qt가 내부적으로 생성한 컨텍스트와 서피스까지 포함하여 모든 컨텍스트와 서피스가 동일한 형식을 사용하게 되므로, 공유 컨텍스트가 필요한 경우에도 올바른 동작이 보장됩니다.

defaultFormat()도 참조하십시오 .

void QSurfaceFormat::setDepthBufferSize(int size)

최소 깊이 버퍼 크기를 size 로 설정합니다.

depthBufferSize()도 참조하십시오 .

void QSurfaceFormat::setGreenBufferSize(int size)

색상 버퍼의 녹색 채널 비트에 원하는 size 값을 설정합니다.

greenBufferSize()함수도 참조하십시오 .

void QSurfaceFormat::setMajorVersion(int major)

원하는 OpenGL 버전( major )을 설정합니다.

majorVersion()도 참조하십시오 .

void QSurfaceFormat::setMinorVersion(int minor)

원하는 OpenGL 버전( minor )을 설정합니다.

기본 버전은 2.0입니다.

minorVersion()도 참조하십시오 .

void QSurfaceFormat::setOption(QSurfaceFormat::FormatOption option, bool on = true)

on 가 true인 경우 형식 옵션 option 을 설정하고, 그렇지 않은 경우 해당 옵션을 해제합니다.

옵션이 제대로 적용되었는지 확인하려면, 표면/컨텍스트 생성 후 실제 형식과 요청된 형식을 비교하십시오.

setOptions(), options(), testOption()도 참조하십시오 .

void QSurfaceFormat::setOptions(QSurfaceFormat::FormatOptions options)

options 로 형식 옵션을 설정합니다.

옵션이 올바르게 적용되었는지 확인하려면, 표면/컨텍스트 생성 후 실제 형식과 요청된 형식을 비교하십시오.

options() 및 testOption()도 참조하십시오 .

void QSurfaceFormat::setProfile(QSurfaceFormat::OpenGLContextProfile profile)

원하는 OpenGL 컨텍스트 profile 를 설정합니다.

요청된 OpenGL 버전이 3.2 미만이면 이 설정은 무시됩니다.

profile()도 참조하십시오 .

void QSurfaceFormat::setRedBufferSize(int size)

색상 버퍼의 빨간색 채널 비트에 원하는 size 값을 설정합니다.

redBufferSize()도 참조하십시오 .

void QSurfaceFormat::setRenderableType(QSurfaceFormat::RenderableType type)

원하는 렌더링 가능한 객체 type 를 설정합니다.

데스크톱 OpenGL, OpenGL ES 및 OpenVG 중에서 선택합니다.

renderableType()도 참조하십시오 .

void QSurfaceFormat::setSamples(int numSamples)

멀티샘플링이 활성화되어 있을 때 픽셀당 샘플 수를 numSamples 로 설정하십시오. 기본적으로 멀티샘플링은 비활성화되어 있습니다.

samples()도 참조하십시오 .

void QSurfaceFormat::setStencilBufferSize(int size)

선호하는 스텐실 버퍼 크기를 size 비트로 설정합니다.

stencilBufferSize()도 참조하십시오 .

void QSurfaceFormat::setStereo(bool enable)

enable 가 true인 경우 스테레오 버퍼링을 활성화하고, 그렇지 않은 경우 비활성화합니다.

스테레오 버퍼링은 기본적으로 비활성화되어 있습니다.

스테레오 버퍼링은 왼쪽 눈과 오른쪽 눈용 이미지를 생성하기 위해 추가적인 컬러 버퍼를 제공합니다.

stereo()도 참조하십시오 .

void QSurfaceFormat::setSwapBehavior(QSurfaceFormat::SwapBehavior behavior)

서페이스의 스왑 behavior 을 설정합니다.

스왑 동작은 싱글, 더블 또는 트리플 버퍼링 중 어느 것을 사용할지 지정합니다. 기본값인 DefaultSwapBehavior 는 플랫폼의 기본 스왑 동작을 적용합니다.

swapBehavior()도 참조하십시오 .

void QSurfaceFormat::setSwapInterval(int interval)

선호하는 스왑 간격을 설정합니다. 스왑 간격은 버퍼 스왑이 발생하기 전에 표시되는 최소 비디오 프레임 수를 지정합니다. 이 설정을 사용하면 창에 그려지는 GL 그래픽을 화면의 수직 갱신 주기와 동기화할 수 있습니다.

interval 값을 0으로 설정하면 수직 갱신 동기화가 해제되며, 0보다 큰 값을 설정하면 수직 동기화가 활성화됩니다. 예를 들어 interval 을 10과 같이 더 큰 값으로 설정하면, 버퍼 스왑 사이에 10회의 수직 리트레이스가 발생합니다.

기본 간격은 1입니다.

스왑 간격 변경이 기본 플랫폼에서 지원되지 않을 수 있습니다. 이 경우 요청은 아무런 오류 메시지 없이 무시됩니다.

swapInterval()도 참조하십시오 .

void QSurfaceFormat::setVersion(int major, int minor)

원하는 OpenGL 버전( major )과 OpenGL 버전( minor )을 설정합니다.

기본 버전은 2.0입니다.

version()도 참조하십시오 .

int QSurfaceFormat::stencilBufferSize() const

스텐실 버퍼의 크기를 비트 단위로 반환합니다.

setStencilBufferSize()도 참조하십시오 .

bool QSurfaceFormat::stereo() const

스테레오 버퍼링이 활성화되어 있으면 true 를 반환하고, 그렇지 않으면 false를 반환합니다. 스테레오 버퍼링은 기본적으로 비활성화되어 있습니다.

setStereo()도 참조하십시오 .

QSurfaceFormat::SwapBehavior QSurfaceFormat::swapBehavior() const

구성된 스왑 동작을 반환합니다.

setSwapBehavior()도 참조하십시오 .

int QSurfaceFormat::swapInterval() const

스왑 간격을 반환합니다.

setSwapInterval()도 참조하십시오 .

bool QSurfaceFormat::testOption(QSurfaceFormat::FormatOption option) const

option 형식 옵션이 설정되어 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

options()도 참조하십시오 .

std::pair<int, int> QSurfaceFormat::version() const

OpenGL 버전을 나타내는 std::pair<int, int>를 반환합니다.

버전 확인에 유용합니다. 예를 들어, format.version() >= std::pair(3, 2)

setVersion()도 참조하십시오 .

QSurfaceFormat &QSurfaceFormat::operator=(const QSurfaceFormat &other)

이 객체에 ` other `를 할당합니다.