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()도 참조하세요 .