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 핸들러를 페인트합니다. 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 에 대한 업데이트 동작을 반환합니다.