RenderStats QML Type

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

Import Statement: import QtQuick3D

속성

상세 설명

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 이 활성화된 경우에만 업데이트됩니다.

참고: 이 값은QQuickWindow 단위로 보고됩니다. 동일한 창 내에 View3D 인스턴스가 여러 개 있는 경우 DebugView 은 모든 View3D에 대해 동일한 값을 표시합니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.


extendedDataCollectionEnabled : bool [since 6.5]

이 프로퍼티는 렌더 패스 및 그리기 호출 통계를 처리하여 사용할 수 있는지 여부를 제어합니다. 약간의 성능 비용이 발생할 수 있으므로 선택 사항입니다.

drawCallCount, drawVertexCount, renderPassCount 와 같은 프로퍼티는 이 프로퍼티가 true로 설정된 경우에만 업데이트됩니다.

기본값은 false입니다.

참고: View3D 에 연결된 DebugView 의 가시성을 변경하면 DebugViewvisible 속성에 따라 값이 자동으로 토글됩니다.

이 속성은 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 이 활성화된 경우에만 업데이트됩니다.

참고: 이 값은QQuickWindow 단위로 보고됩니다. 동일한 창 내에 View3D 인스턴스가 여러 개 있는 경우 DebugView 은 모든 View3D에 대해 동일한 값을 표시합니다.

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


lastCompletedGpuTime : real [read-only, since 6.6]

GPU 타이밍 수집이 enabled in Qt Quick이고 관련 기능이 기본 그래픽 API에서 지원되는 경우, 이 프로퍼티에는 마지막으로 검색된 경과된 GPU 시간(밀리초)이 포함됩니다.

참고: 이 값은 비동기적으로 검색되며 일반적으로 이전 프레임보다 오래된 프레임을 참조하므로 다른 CPU 측 타이밍과 반드시 동기화되지 않을 수 있습니다.

참고: 결과는 View3D 이 속한 QQuickWindow 의 전체 콘텐츠 렌더링을 기반으로 합니다. 여기에는 모든 2D 요소와 해당 창 내의 모든 View3D 항목을 포함하여 Qt Quick 장면의 모든 콘텐츠가 포함됩니다.

이 프로퍼티는 Qt 6.6에 도입되었습니다.

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


materialGenerationTime : qint64 [read-only, since 6.5]

이 속성은 View3D 이 속한 창에서 DefaultMaterial, PrincipledMaterial, CustomMaterial 에 대한 셰이더 코드를 생성하고 처리하는 데 소요된 총 밀리초 수를 보유합니다.

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

참고: 이 값은QQuickWindow 단위로 보고됩니다. 동일한 창 내에 View3D 인스턴스가 여러 개 있는 경우 DebugView 은 모든 View3D에 대해 동일한 값을 표시합니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.


maxFrameTime : real [read-only]

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


meshDataSize : quint64 [read-only, since 6.5]

이 프로퍼티는 현재 View3D 의 창에 등록된 메시 데이터의 대략적인 크기(바이트)를 보유합니다. 이 값은 창별로 계산되므로 동일한 QQuickWindow 내에 View3D 객체가 여러 개 있는 경우 동일한 값을 보고할 가능성이 높습니다.

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

참고: 이 값은QQuickWindow 단위로 보고됩니다. 동일한 창 내에 View3D 인스턴스가 여러 개 있는 경우 DebugView 은 모든 View3D에 대해 동일한 값을 표시합니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.


pipelineCount : int [read-only, since 6.5]

이 속성은 View3D 이 속한 창에 대해 캐시된 그래픽 파이프라인의 총 수를 보유합니다.

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

참고: 이 값은QQuickWindow 단위로 보고됩니다. 동일한 창 내에 View3D 인스턴스가 여러 개 있는 경우 DebugView 은 모든 View3D에 대해 동일한 값을 표시합니다.

이 프로퍼티는 Qt 6.5에 도입되었습니다.


pipelineCreationTime : qint64 [read-only, since 6.5]

이 속성은 렌더링 하드웨어 인터페이스 수준에서 그래픽 파이프라인을 생성하는 데 소요된 총 밀리초 수를 보유합니다. 여기에는 무엇보다도 HLSL을 중간 포맷으로 컴파일하는 컴파일 시간, MSL 컴파일, glCompileShader를 사용한 GLSL 코드 컴파일 또는 프로그램 바이너리를 사용한 링크, 모든 수반되는 Vulkan 파이프라인 생성(예: SPIR-V -> ISA 컴파일)이 포함될 수 있습니다. 이 값은 View3D 이 속한 창에 있는 모든 Qt QuickQt Quick 3D 렌더링을 반영합니다.

참고: 이 값에는 Qt가 제어하는 연산이 포함됩니다. 기본 그래픽 API에 따라 일부 파이프라인(셰이더, 그래픽 상태) 관련 작업은 비동기적으로 발생할 수 있으며 그래픽 스택의 다양한 수준에서 캐싱의 영향을 받을 수 있습니다. QQuickWindow::releaseResources ()를 호출하거나 해당 DebugView 버튼을 클릭하여 캐시된 리소스를 해제하는 경우에도 기본 세부 정보(rhi 백엔드, 그래픽 API)에 따라 결과가 달라질 수 있으며, 다양한 요인으로 인해 이 카운터에 영향을 미칠 수도 있고 그렇지 않을 수도 있습니다.

이 타이밍은 일반적인 상위 수준의 표시로 제공됩니다. 애플리케이션 개발자는 materialGenerationTime 와 함께 이 값을 사용하여 모든 캐시(퍼시스턴트 및 인메모리 모두)가 따뜻해지면 애플리케이션의 정상적인 사용 중에 머티리얼 및 그래픽 파이프라인 처리에 소요되는 시간이 합리적으로 낮은지 확인할 수 있습니다. 애플리케이션의 첫 번째 실행에서 결론을 내리지 마세요. (아직 영구 디스크 기반 캐시의 이점을 누리지 못할 수 있기 때문입니다.)

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

참고: 이 값은QQuickWindow 단위로 보고됩니다. 동일한 창 내에 View3D 인스턴스가 여러 개 있는 경우 DebugView 은 모든 View3D에 대해 동일한 값을 표시합니다.

이 프로퍼티는 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 QuickQt Quick 3D 렌더링의 할당이 포함됩니다. OpenGL, Direct3D, Metal과 같은 그래픽 API의 경우 메모리 할당이 Qt의 제어하에 있지 않으므로 이 값은 0입니다.

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

참고: 이 값은QQuickWindow 단위로 보고됩니다. 동일한 창 내에 View3D 인스턴스가 여러 개 있는 경우 DebugView 은 모든 View3D에 대해 동일한 값을 표시합니다.

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


vmemUsedBytes : quint64 [read-only, since 6.5]

해당되는 경우 그래픽 메모리 할당자 라이브러리에서 할당에 사용한 바이트 수입니다. 여기에는 View3D 이 속한 QQuickWindow 의 모든 Qt QuickQt Quick 3D 렌더링의 할당이 포함됩니다. OpenGL, Direct3D, Metal과 같은 그래픽 API의 경우 이 값은 0입니다. 그 때는 메모리 할당이 Qt의 제어하에 있지 않기 때문입니다.

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

참고: 이 값은QQuickWindow 단위로 보고됩니다. 동일한 창 내에 View3D 인스턴스가 여러 개 있는 경우 DebugView 은 모든 View3D에 대해 동일한 값을 표시합니다.

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


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.