QOpenGLTimerQuery Class

멤버 함수 문서

[explicit] QOpenGLTimerQuery::QOpenGLTimerQuery(QObject *parent = nullptr)

지정된 ` parent`를 사용하여 `QOpenGLTimerQuery` 인스턴스를 생성합니다. 사용하기 전에 유효한 OpenGL 컨텍스트를 사용하여 ` create()`를 호출해야 합니다.

[virtual noexcept] QOpenGLTimerQuery::~QOpenGLTimerQuery()

QOpenGLTimerQuery 와 그 기반이 되는 OpenGL 리소스를 삭제합니다.

void QOpenGLTimerQuery::begin()

이 쿼리 객체에 의해 타이밍이 측정될 일련의 명령에 대한 OpenGL 명령 큐 내의 시작 지점을 지정합니다.

이는 간단한 사용 사례에 유용합니다. 일반적으로 recordTimestamp()을 사용하는 것이 더 좋습니다.

end(), isResultAvailable(), waitForResult() 및 recordTimestamp()도 참조하십시오 .

bool QOpenGLTimerQuery::create()

기본이 되는 OpenGL 타이머 쿼리 객체를 생성합니다. 이 함수가 성공하려면 쿼리 객체를 지원하는 유효한 OpenGL 컨텍스트가 현재 활성화되어 있어야 합니다.

OpenGL 타이머 쿼리 객체가 성공적으로 생성된 경우 ` true `을 반환합니다.

void QOpenGLTimerQuery::destroy()

기본이 되는 OpenGL 타이머 쿼리 객체를 삭제합니다. 이 함수를 호출할 때는 create()이 호출되었을 당시의 컨텍스트가 현재 컨텍스트여야 합니다.

void QOpenGLTimerQuery::end()

이 쿼리 객체에 의해 타이밍이 측정될 일련의 명령에 대해 OpenGL 명령 큐의 종료 지점을 표시합니다.

이는 간단한 사용 사례에 유용합니다. 일반적으로 recordTimestamp()를 사용하는 것이 더 좋습니다.

begin(), isResultAvailable(), waitForResult(), recordTimestamp()도 참조하십시오 .

bool QOpenGLTimerQuery::isCreated() const

기본이 되는 OpenGL 쿼리 객체가 생성된 경우 ` true `를 반환합니다. 이 함수가 ` true `를 반환하고 관련 OpenGL 컨텍스트가 현재 활성화된 상태라면, 이 객체를 사용하여 쿼리를 실행할 수 있습니다.

bool QOpenGLTimerQuery::isResultAvailable() const

OpenGL 타이머 쿼리 결과가 준비되어 있으면 ` true `를 반환합니다.

이 함수는 비차단 방식이며, 가급적 waitForResult()을 호출하기 전에 쿼리 결과의 유무를 확인하는 데 사용해야 합니다.

waitForResult()도 참조하십시오 .

GLuint QOpenGLTimerQuery::objectId() const

기본이 되는 OpenGL 쿼리 객체의 ID를 반환합니다.

void QOpenGLTimerQuery::recordTimestamp()

GPU가 이 마커에 도달했을 때 타임스탬프를 기록하도록 OpenGL 명령 큐에 마커를 배치합니다. 이 함수는 비차단 방식이며, 결과는 나중에 사용할 수 있게 됩니다.

결과가 준비되었는지 여부는 ` isResultAvailable()`를 사용하여 확인할 수 있습니다. 결과는 ` waitForResult()`를 사용하여 가져올 수 있으며, 결과가 아직 준비되지 않은 경우 이 함수는 차단됩니다.

waitForResult(), isResultAvailable(), begin(), end()도 참조하십시오 .

GLuint64 QOpenGLTimerQuery::waitForResult() const

OpenGL 타이머 쿼리의 결과를 반환합니다.

이 함수는 OpenGL에서 결과를 제공할 때까지 차단됩니다. 불필요한 차단 및 지연을 방지하고 결과가 준비되었는지 확인하려면 isResultAvailable()을 호출하는 것이 좋습니다.

isResultAvailable()도 참조하십시오 .

GLuint64 QOpenGLTimerQuery::waitForTimestamp() const

이전까지 발행된 모든 OpenGL 명령이 수신되었으나, GPU에서 반드시 실행된 것은 아닐 때 GPU의 현재 타임스탬프를 반환합니다.

이 함수는 결과가 반환될 때까지 차단됩니다.

recordTimestamp()도 참조하십시오 .