RenderStats QML Type

씬 렌더링에 대한 정보를 제공합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• drawCallCount : quint64 (since 6.5)
• drawVertexCount : quint64 (since 6.5)
• effectGenerationTime : qint64 (since 6.5)
• extendedDataCollectionEnabled : bool (since 6.5)
• fps : int
• frameTime : real
• graphicsAPIName : string (since 6.5)
• imageDataSize : quint64 (since 6.5)
• lastCompletedGpuTime : real (since 6.6)
• materialGenerationTime : qint64 (since 6.5)
• maxFrameTime : real
• meshDataSize : quint64 (since 6.5)
• pipelineCount : int (since 6.5)
• pipelineCreationTime : qint64 (since 6.5)
• renderPassCount : int (since 6.5)
• renderPrepareTime : real
• renderTime : real
• syncTime : real
• vmemAllocCount : quint32 (since 6.5)
• vmemUsedBytes : quint64 (since 6.5)

상세 설명

RenderStats 유형은 씬 렌더링 통계에 대한 정보를 제공합니다. 이 유형은 직접 생성할 수는 없지만, ` View3D`에서 가져올 수 있습니다.

DebugView 항목을 사용하여 데이터를 화면에 표시할 수 있습니다.

속성 설명

drawCallCount : quint64 [read-only, since 6.5]

이 속성은 View3D 의 마지막 렌더링 과정에서 등록된 드로우 콜의 총 개수(인덱싱되지 않은 드로우 콜, 인덱싱된 드로우 콜, 인스턴스화된 드로우 콜 및 인스턴스화된 인덱싱된 드로우 콜 포함)를 나타냅니다.

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

drawVertexCount : quint64 [read-only, since 6.5]

이 속성은 View3D 의 마지막 렌더링 과정에서 등록된 드로우 콜의 총 정점 수를 나타냅니다.

이 값에는 View3D 의 마지막 렌더링 중에 등록된 드로우 콜의 정점 수와 인덱스 수가 포함됩니다. 이 수치가 완전히 정확하다고 보장되지는 않지만, 씬 렌더링의 복잡성을 잘 나타내 줄 것으로 예상됩니다.

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

effectGenerationTime : qint64 [read-only, since 6.5]

이 속성은 ‘ View3D ’이 속한 창에서 후처리 효과용 셰이더 코드를 생성하고 처리하는 데 소요된 총 시간을 밀리초 단위로 저장합니다.

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

extendedDataCollectionEnabled : bool [since 6.5]

이 속성은 렌더 패스 및 드로우 콜 통계가 처리되어 제공될지 여부를 제어합니다. 이로 인해 약간의 성능 저하가 발생할 수 있으므로 선택 사항입니다.

drawCallCount, drawVertexCount 또는 renderPassCount 와 같은 속성은 이 속성이 true로 설정된 경우에만 업데이트됩니다.

기본값은 false입니다.

이 속성은 Qt 6.5에서 도입되었습니다.

fps : int [read-only]

이 속성은 지난 1초 동안 렌더링된 프레임 수를 저장합니다.

frameTime : real [read-only]

이 속성은 마지막 프레임 이후 경과한 시간을 밀리초 단위로 저장합니다.

graphicsAPIName : string [read-only, since 6.5]

이 속성은 현재 사용 중인 그래픽 API(RHI) 백엔드의 이름을 저장합니다.

이 속성은 Qt 6.5에서 도입되었습니다.

imageDataSize : quint64 [read-only, since 6.5]

이 속성은 현재 ` View3D`의 창에 등록된 텍스처 맵의 이미지 데이터 대략적인 크기(바이트 단위)를 저장합니다. 이 값은 창별로 적용되므로, 동일한 ` QQuickWindow` 내에 여러 개의 ` View3D ` 객체가 있는 경우, 이들 객체는 대부분 동일한 값을 반환할 것입니다.

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

lastCompletedGpuTime : real [read-only, since 6.6]

GPU 시간 측정 데이터 수집이 enabled in Qt Quick, 그리고 해당 기능이 기본 그래픽 API에서 지원되는 경우, 이 속성에는 마지막으로 가져온 GPU 경과 시간(밀리초 단위)이 포함됩니다.

이 속성은 Qt 6.6에서 도입되었습니다.

QQuickGraphicsConfiguration::setTimestamps()도 참조하십시오 .

materialGenerationTime : qint64 [read-only, since 6.5]

이 속성은 ` View3D `가 속한 창에서 ` DefaultMaterial`, ` PrincipledMaterial` 및 ` CustomMaterial `에 대한 셰이더 코드를 생성하고 처리하는 데 소요된 총 시간을 밀리초 단위로 저장합니다.

이 값은 extendedDataCollectionEnabled 이 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

maxFrameTime : real [read-only]

이 속성은 지난 1초 동안 단일 프레임을 렌더링하는 데 소요된 최대 시간을 저장합니다.

meshDataSize : quint64 [read-only, since 6.5]

이 속성은 현재 ‘ View3D ’의 창에 등록된 메시 데이터의 대략적인 크기(바이트 단위)를 저장합니다. 이 값은 창별로 적용되므로, 동일한 ‘ QQuickWindow ’ 내에 여러 개의 ‘ View3D ’ 객체가 있는 경우, 해당 객체들은 대부분 동일한 값을 반환할 것입니다.

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

pipelineCount : int [read-only, since 6.5]

이 속성은 ` View3D `가 속한 창의 캐시된 그래픽 파이프라인 총 개수를 저장합니다.

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

pipelineCreationTime : qint64 [read-only, since 6.5]

이 속성은 렌더링 하드웨어 인터페이스 수준에서 그래픽 파이프라인을 생성하는 데 소요된 총 시간을 밀리초 단위로 나타냅니다. 여기에는 특히 HLSL을 중간 형식으로 컴파일하는 시간, MSL 컴파일 시간, glCompileShader를 사용한 GLSL 코드 컴파일 또는 프로그램 바이너리를 사용한 링크 시간, 그리고 Vulkan 파이프라인 생성 및 이에 수반되는 모든 과정(예: SPIR-V → ISA 컴파일) 등이 포함될 수 있습니다. 이 값은 ` View3D `이 속한 창에서 수행된 모든 ` Qt Quick ` 및 ` Qt Quick 3D ` 렌더링을 반영합니다.

이 타이밍 정보는 일반적이고 개략적인 지표로 제공됩니다. 애플리케이션 개발자는 ` materialGenerationTime`와 함께 이러한 값을 활용하여, 모든 캐시(영구 캐시 및 메모리 내 캐시 모두)가 예열된 상태에서 애플리케이션을 정상적으로 사용할 때 머티리얼 및 그래픽 파이프라인 처리에 소요되는 시간이 합리적으로 낮은지 확인할 수 있습니다. 애플리케이션을 처음 실행했을 때의 결과만으로 결론을 내리지 마십시오. (이 시점에서는 아직 디스크 기반의 영구 캐시 이점을 누리지 못할 수 있기 때문입니다)

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

renderPassCount : int [read-only, since 6.5]

이 속성은 View3D 의 마지막 렌더링 과정에서 등록된 렌더 패스의 총 개수를 저장합니다.

실시간 섀도 매핑, 후처리 효과, 깊이 및 스크린 텍스처, 특정 앤티앨리어싱 기법 등 많은 기능이 여러 개의 추가 렌더 패스를 수반합니다. 이 수치가 모든 렌더 패스를 절대적으로 포함한다고 보장되지는 않지만, 씬 렌더링의 복잡성을 잘 나타내 줄 것으로 예상됩니다.

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

renderPrepareTime : real [read-only]

이 속성은 렌더링의 준비 단계에 소요된 시간을 밀리초 단위로 저장합니다. 이는 renderTime 에 보고된 총 렌더링 시간의 일부입니다.

renderTime : real [read-only]

이 속성은 준비 단계와 드로우 콜 기록을 모두 포함하여 새 프레임을 생성하는 데 소요된 시간을 나타냅니다. 값은 밀리초 단위입니다.

syncTime : real [read-only]

이 속성은 동기화 함수 내에서 소요된 시간을 밀리초 단위로 저장합니다. 객체의 속성 값은 동기화 과정에서 업데이트됩니다.

vmemAllocCount : quint32 [read-only, since 6.5]

해당되는 경우, 그래픽 메모리 할당기 라이브러리에 의해 수행된 할당 횟수입니다. 여기에는 View3D 가 속한 QQuickWindow 내에서 모든 Qt Quick 및 Qt Quick 3D 렌더링에 의한 할당이 포함됩니다. OpenGL, Direct3D, Metal과 같은 그래픽 API를 사용할 때는 메모리 할당이 Qt의 제어 범위를 벗어나므로 이 값은 0입니다.

이 값은 extendedDataCollectionEnabled 이 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.

vmemUsedBytes : quint64 [read-only, since 6.5]

해당되는 경우, 그래픽 메모리 할당기 라이브러리가 수행한 할당에 사용된 바이트 수입니다. 여기에는 View3D 가 속한 QQuickWindow 에서 Qt Quick 및 Qt Quick 3D 렌더링에 의한 모든 할당이 포함됩니다. OpenGL, Direct3D, Metal과 같은 그래픽 API를 사용하는 경우, 메모리 할당이 Qt의 제어 범위를 벗어나므로 이 값은 0입니다.

이 값은 extendedDataCollectionEnabled 가 활성화된 경우에만 업데이트됩니다.

이 속성은 Qt 6.5에서 도입되었습니다.