QOpenGLWindow Class

QSurfaceFormat format;
format.setDepthBufferSize(24);
format.setStencilBufferSize(8);
setFormat(format);

멤버 함수 문서

[explicit] QOpenGLWindow::QOpenGLWindow(QOpenGLWindow::UpdateBehavior updateBehavior = NoPartialUpdate, QWindow *parent = nullptr)

지정된 ` parent ` 및 ` updateBehavior`을 사용하여 새로운 `QOpenGLWindow`를 생성합니다.

QOpenGLWindow::UpdateBehavior도 참조하십시오 .

[explicit] QOpenGLWindow::QOpenGLWindow(QOpenGLContext *shareContext, QOpenGLWindow::UpdateBehavior updateBehavior = NoPartialUpdate, QWindow *parent = nullptr)

지정된 ` parent ` 및 ` updateBehavior`을 사용하여 새로운 `QOpenGLWindow`를 생성합니다. 이 `QOpenGLWindow`의 컨텍스트는 ` shareContext`과 공유됩니다.

QOpenGLWindow::UpdateBehavior 및 shareContext도 참조하십시오 .

[virtual noexcept] QOpenGLWindow::~QOpenGLWindow()

QOpenGLWindow 인스턴스를 파기하고 해당 리소스를 해제합니다.

소멸자에서 OpenGLWindow의 컨텍스트가 현재 컨텍스트로 설정되므로, 이 창이 제공하는 컨텍스트에 속한 OpenGL 리소스를 해제해야 할 수 있는 모든 자식 객체를 안전하게 소멸시킬 수 있습니다.

makeCurrent도 참조하십시오 .

QOpenGLContext *QOpenGLWindow::context() const

이 창에서 사용되는 ` QOpenGLContext `를 반환하며, 아직 초기화되지 않은 경우에는 ` 0 `를 반환합니다.

GLuint QOpenGLWindow::defaultFramebufferObject() const

이 창에서 사용하는 프레임버퍼 객체 핸들입니다.

업데이트 동작이 ` NoPartialUpdate`로 설정된 경우, 별도의 프레임버퍼 객체가 존재하지 않습니다. 이 경우 반환되는 값은 기본 프레임버퍼의 ID입니다.

그 외의 경우에는 프레임버퍼 객체의 ID 값이 반환되며, 아직 초기화되지 않은 경우에는 ` 0 `가 반환됩니다.

void QOpenGLWindow::doneCurrent()

컨텍스트를 해제합니다.

대부분의 경우 이 함수를 호출할 필요가 없습니다. 위젯이 ` paintGL()`를 호출할 때 컨텍스트가 올바르게 바인딩되고 해제되도록 보장하기 때문입니다.

makeCurrent()도 참조하십시오 .

[signal] void QOpenGLWindow::frameSwapped()

이 신호는 잠재적으로 차단 효과를 일으킬 수 있는 ` buffer swap `가 완료된 후에 발생합니다. 수직 갱신 주기와 동기화되어 지속적으로 화면을 다시 그리려는 애플리케이션은 이 신호가 발생하면 ` update()`를 호출해야 합니다. 이를 통해 기존의 타이머를 사용하는 방식에 비해 훨씬 더 부드러운 사용자 경험을 제공할 수 있습니다.

QImage QOpenGLWindow::grabFramebuffer()

프레임버퍼의 복사본을 반환합니다.

[virtual protected] void QOpenGLWindow::initializeGL()

이 가상 함수는 paintGL() 또는 resizeGL()이 처음 호출되기 전에 한 번 호출됩니다. 하위 클래스에서 이 함수를 재구현하십시오.

이 함수는 필요한 모든 OpenGL 리소스와 상태를 설정해야 합니다.

makeCurrent()을 호출할 필요는 없습니다. 이 함수가 호출될 때 이미 해당 작업이 완료되었기 때문입니다. 다만, 부분 업데이트 모드가 사용되는 경우 이 단계에서는 프레임버퍼를 아직 사용할 수 없으므로, 여기서 드로우 호출을 수행하지 마십시오. 대신 paintGL()에서 해당 호출을 수행하십시오.

paintGL() 및 resizeGL()도 참조하십시오 .

bool QOpenGLWindow::isValid() const

컨텍스트와 같은 창의 OpenGL 리소스가 성공적으로 초기화되면 ` true `를 반환합니다. 창이 노출(표시)되기 전까지는 반환 값이 항상 ` false `임을 유의하십시오.

void QOpenGLWindow::makeCurrent()

해당 컨텍스트를 현재 컨텍스트로 설정하고, 존재하는 경우 해당 컨텍스트에 프레임버퍼 객체를 바인딩하여 이 창에 대한 OpenGL 콘텐츠 렌더링을 준비합니다.

대부분의 경우 paintGL()를 호출하기 전에 이 함수가 자동으로 호출되므로, 별도로 호출할 필요는 없습니다. 다만, GUI 스레드나 메인 스레드 이외의 스레드가 서피스나 프레임버퍼 내용을 업데이트하고자 하는 고급 멀티스레드 시나리오를 지원하기 위해 이 함수가 제공됩니다. 스레딩 관련 문제에 대한 자세한 내용은 QOpenGLContext 을 참조하십시오.

이 함수는 기본 플랫폼 창이 이미 소멸된 경우에도 호출하기에 적합합니다. 즉, QOpenGLWindow 의 서브클래스 소멸자에서 이 함수를 호출해도 안전합니다. 네이티브 창이 더 이상 없는 경우, 대신 오프스크린 서페이스가 사용됩니다. 이를 통해 이 함수가 먼저 호출되는 한, 소멸자 내의 OpenGL 리소스 정리 작업이 항상 정상적으로 수행되도록 보장합니다.

QOpenGLContext, context(), paintGL(), doneCurrent()도 참조하십시오 .

[override virtual protected] void QOpenGLWindow::paintEvent(QPaintEvent *event)

QPaintDeviceWindow::paintEvent(QPaintEvent *event)를 재구현합니다.

event 핸들러를 그립니다. paintGL()를 호출합니다.

paintGL()도 참조하십시오 .

[virtual protected] void QOpenGLWindow::paintGL()

이 가상 함수는 창 내용을 그려야 할 때마다 호출됩니다. 하위 클래스에서 이 함수를 재정의하십시오.

makeCurrent()을 호출할 필요는 없습니다. 이 함수가 호출될 때 이미 해당 작업이 수행되었기 때문입니다.

이 함수를 호출하기 전에 컨텍스트와 프레임버퍼(있는 경우)가 바인딩되며, glViewport() 호출을 통해 뷰포트가 설정됩니다. 그 외의 상태는 설정되지 않으며, 프레임워크에 의해 지우기나 그리기 작업이 수행되지 않습니다.

initializeGL(), resizeGL(), paintUnderGL(), paintOverGL() 및 UpdateBehavior도 참조하십시오 .

[virtual protected] void QOpenGLWindow::paintOverGL()

이 가상 함수는 ` paintGL()`이 호출될 때마다 호출됩니다.

업데이트 모드가 ` NoPartialUpdate`로 설정되어 있을 때, 이 함수와 ` paintGL()` 사이에는 차이가 없으며, 두 함수 중 어느 쪽에서 렌더링을 수행하더라도 동일한 결과가 나옵니다.

paintUnderGL()와 마찬가지로, 이 함수에서 렌더링은 업데이트 동작과 관계없이 창의 기본 프레임버퍼를 대상으로 합니다. 이 함수는 paintGL()가 반환되고 블릿(PartialUpdateBlit) 또는 쿼드 그리기(PartialUpdateBlend)가 완료된 후에 호출됩니다.

paintGL(), paintUnderGL(), UpdateBehavior도 참조하십시오 .

[virtual protected] void QOpenGLWindow::paintUnderGL()

paintGL()이 호출될 때마다 이 가상 함수가 호출됩니다.

업데이트 모드가 ` NoPartialUpdate`로 설정된 경우, 이 함수와 ` paintGL()` 간에는 차이가 없으며, 두 함수 중 어느 쪽에서 렌더링을 수행하더라도 동일한 결과가 나옵니다.

이 차이는 추가 프레임버퍼 객체가 사용되는 ` PartialUpdateBlend`을 사용할 때 두드러집니다. 이 경우, ` paintGL()`는 내용을 보존하는 이 추가 프레임버퍼 객체를 대상으로 하는 반면, `paintUnderGL()` 및 ` paintOverGL()`는 기본 프레임버퍼, 즉 창 표면을 직접 대상으로 하며, 이 프레임버퍼의 내용은 각 프레임이 표시된 후 사라집니다.

paintGL(), paintOverGL() 및 UpdateBehavior도 참조하십시오 .

[override virtual protected] void QOpenGLWindow::resizeEvent(QResizeEvent *event)

QWindow::resizeEvent(QResizeEvent *ev)를 재구현합니다.

event 핸들러의 크기 조정. resizeGL()를 호출합니다.

resizeGL()도 참조하십시오 .

[virtual protected] void QOpenGLWindow::resizeGL(int w, int h)

이 가상 함수는 위젯의 크기가 조정될 때마다 호출됩니다. 하위 클래스에서 이 함수를 재구현하십시오. 새로운 크기는 ` w ` 및 ` h`에 전달됩니다.

initializeGL() 및 paintGL()도 참조하십시오 .

QOpenGLContext *QOpenGLWindow::shareContext() const

이 창 QOpenGLContext 와 공유하도록 요청된 QOpenGLContext 를 반환합니다.

QOpenGLWindow::UpdateBehavior QOpenGLWindow::updateBehavior() const

이 ` QOpenGLWindow`의 업데이트 동작을 반환합니다.