QOpenGLTimeMonitor Class

멤버 함수 문서

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

주어진 parent 로 QOpenGLTimeMonitor 인스턴스를 생성합니다. 사용하기 전에 유효한 OpenGL 컨텍스트로 create()를 호출해야 합니다.

setSampleCount() 및 create()도 참조하세요 .

[virtual noexcept] QOpenGLTimeMonitor::~QOpenGLTimeMonitor()

QOpenGLTimeMonitor 및 모든 기본 OpenGL 리소스를 삭제합니다.

bool QOpenGLTimeMonitor::create()

recordSample()에 대한 연속적인 호출 사이에 OpenGL 명령을 실행하는 데 걸리는 시간을 추적하는 데 사용할 sampleCount() OpenGL 타이머 쿼리 객체를 인스턴스화합니다.

OpenGL 타이머 쿼리 객체를 만들 수 있으면 true 을 반환합니다.

destroy(), setSampleCount() 및 recordSample()도 참조하세요 .

void QOpenGLTimeMonitor::destroy()

이 인스턴스 내에서 사용된 모든 OpenGL 타이머 쿼리 객체를 삭제합니다.

create()도 참조하세요 .

bool QOpenGLTimeMonitor::isCreated() const

기본 OpenGL 쿼리 객체가 생성된 경우 true 을 반환합니다. true 을 반환하고 연결된 OpenGL 컨텍스트가 최신이면 이 객체를 사용하여 시간 샘플을 기록할 수 있습니다.

bool QOpenGLTimeMonitor::isResultAvailable() const

OpenGL 타이머 쿼리 결과를 사용할 수 있는 경우 true 를 반환합니다.

waitForSamples() 및 waitForIntervals()도 참조하세요 .

QList<GLuint> QOpenGLTimeMonitor::objectIds() const

OpenGL 타이머 쿼리 객체의 객체 ID가 포함된 QList 를 반환합니다.

int QOpenGLTimeMonitor::recordSample()

OpenGL 명령 대기열의 이 지점에서 OpenGL 타이머 쿼리를 발행합니다. 애플리케이션의 렌더링 함수에서 이 함수를 순서대로 호출하면 이 함수를 연속적으로 호출하는 사이에 OpenGL 명령을 실행하는 데 걸린 GPU 시간에 대한 세부 정보가 쌓입니다.

setSampleCount(), isResultAvailable(), waitForSamples() 및 waitForIntervals()도 참조하세요 .

void QOpenGLTimeMonitor::reset()

다른 렌더링 프레임에서 사용할 수 있도록 시간 모니터를 재설정합니다. 이전 결과를 얻은 후 다음 프레임에서 처음으로 recordSample()를 호출하기 전에 이 함수를 호출하세요.

recordSample()도 참조하세요 .

int QOpenGLTimeMonitor::sampleCount() const

setSampleCount()로 요청된 샘플 포인트의 수를 반환합니다. setSampleCount () 다음에 create가 성공적으로 호출된 경우 반환되는 값은 실제 사용할 수 있는 샘플 포인트 수입니다.

샘플 개수의 기본값은 2이며, 단일 인터벌을 측정하게 됩니다.

setSampleCount()도 참조하세요 .

void QOpenGLTimeMonitor::setSampleCount(int sampleCount)

샘플 포인트 수를 sampleCount 로 설정합니다. 이 함수로 샘플 수를 설정한 후에는 create()를 호출하여 기본 OpenGL 타이머 쿼리 객체를 인스턴스화해야 합니다.

새로운 sampleCount 은 2 이상이어야 합니다.

sampleCount(), create() 및 recordSample()도 참조하세요 .

QList<GLuint64> QOpenGLTimeMonitor::waitForIntervals() const

recordSample() 호출로 구분된 시간 간격이 포함된 QList 을 반환합니다. 결과 벡터에는 실제 타임스탬프 샘플이 아닌 중간 간격을 나타내므로 요소가 하나 더 적게 포함됩니다.

이 함수는 OpenGL이 결과를 사용할 수 있다고 표시할 때까지 차단됩니다. 이 함수를 호출하기 전에 isResultAvailable()를 사용하여 결과의 사용 가능 여부를 확인하는 것이 좋습니다.

waitForSamples() 및 isResultAvailable()도 참조하세요 .

QList<GLuint64> QOpenGLTimeMonitor::waitForSamples() const

recordSample()로 촬영한 GPU 타임스탬프가 포함된 QList 를 반환합니다.

이 함수는 OpenGL이 결과를 사용할 수 있다고 표시할 때까지 차단됩니다. 이 함수를 호출하기 전에 isResultAvailable()를 사용하여 결과의 사용 가능 여부를 확인하는 것이 좋습니다.

waitForIntervals() 및 isResultAvailable()도 참조하세요 .