QSurfaceFormat Class

멤버 함수 문서

QSurfaceFormat::QSurfaceFormat()

초기화된 기본 QSurfaceFormat을 구축합니다.

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

주어진 포맷으로 QSurfaceFormat을 options 으로 구축합니다.

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를 지원하는 창을 요청할 수 있습니다.

이 기능은 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)

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

majorVersion()도 참조하세요 .

void QSurfaceFormat::setMinorVersion(int minor)

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

기본 버전은 2.0입니다.

minorVersion()도 참조하세요 .

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

on 이 참이면 형식 옵션 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 이 참이면 스테레오 버퍼링을 활성화하고, 그렇지 않으면 스테레오 버퍼링을 비활성화합니다.

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

스테레오 버퍼링은 왼쪽 눈과 오른쪽 눈 이미지를 생성하기 위한 추가 색상 버퍼를 제공합니다.

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)

원하는 major 및 minor OpenGL 버전을 설정합니다.

기본 버전은 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 형식 옵션이 설정되어 있으면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

options()도 참조하세요 .

QPair<int, int> QSurfaceFormat::version() const

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

예를 들어 format.version() >= qMakePair(3, 2)와 같이 버전 확인에 유용합니다.

setVersion()도 참조하세요 .

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

이 개체에 other 을 할당합니다.