# Sandbox.Diagnostics.FrameStats

Stats returned from the engine each frame describing what was rendered, and how much of it.

- Kind: struct
- Namespace: `Sandbox.Diagnostics`
- Assembly: `Sandbox.Engine`
- Modifiers: sealed

## Properties

- [`AggregateObjectDrawCalls`](/api/Sandbox.Diagnostics.FrameStats/AggregateObjectDrawCalls): Native draw calls issued from aggregate scene objects.
- [`AggregateObjectDraws`](/api/Sandbox.Diagnostics.FrameStats/AggregateObjectDraws): Primitive draws for aggregate scene objects (batched static prop / world geometry containers).
- [`AggregateObjectsFullyCulled`](/api/Sandbox.Diagnostics.FrameStats/AggregateObjectsFullyCulled): Aggregate scene objects rejected entirely by their bounding box this frame.
- [`AnimatableObjectDraws`](/api/Sandbox.Diagnostics.FrameStats/AnimatableObjectDraws): Primitive draws for animatable scene objects.
- [`BaseObjectDraws`](/api/Sandbox.Diagnostics.FrameStats/BaseObjectDraws): Primitive draws for base (static) scene objects.
- [`ConstantBufferBytes`](/api/Sandbox.Diagnostics.FrameStats/ConstantBufferBytes): Total bytes uploaded into constant buffers by the material system.
- [`ConstantBufferUpdates`](/api/Sandbox.Diagnostics.FrameStats/ConstantBufferUpdates): Number of constant-buffer updates issued by the material system.
- [`CopyMaterialChanges`](/api/Sandbox.Diagnostics.FrameStats/CopyMaterialChanges): Number of "copy" material changes (rebound copy of a previously seen material).
- [`Current`](/api/Sandbox.Diagnostics.FrameStats/Current)
- [`DisplayLists`](/api/Sandbox.Diagnostics.FrameStats/DisplayLists): Number of display lists submitted to the GPU.
- [`DrawCalls`](/api/Sandbox.Diagnostics.FrameStats/DrawCalls): Number of draw calls.
- [`FullMaterialSets`](/api/Sandbox.Diagnostics.FrameStats/FullMaterialSets): Number of full material sets (m_nNumMaterialSet minus similar sets, matching stats_display output).
- [`GpuStatsSummary`](/api/Sandbox.Diagnostics.FrameStats/GpuStatsSummary): Multi-line GPU resource summary from the render device (memory mgr, framebuffers, pipeline cache).
- [`InitialMaterialChanges`](/api/Sandbox.Diagnostics.FrameStats/InitialMaterialChanges): Number of initial material changes across both colour and shadow passes (first bind of a material this frame).
- [`InitialShadowMaterialChanges`](/api/Sandbox.Diagnostics.FrameStats/InitialShadowMaterialChanges): Initial material changes that occurred in the shadow / depth-only pass specifically.
- [`MaterialChanges`](/api/Sandbox.Diagnostics.FrameStats/MaterialChanges): Number of non-shadow (colour pass) material changes.
- [`MaterialComputes`](/api/Sandbox.Diagnostics.FrameStats/MaterialComputes): Number of material compute invocations.
- [`ObjectsCulledByFade`](/api/Sandbox.Diagnostics.FrameStats/ObjectsCulledByFade): Number of objects culled by distance fading.
- [`ObjectsCulledByScreenSize`](/api/Sandbox.Diagnostics.FrameStats/ObjectsCulledByScreenSize): Number of objects culled by screen size.
- [`ObjectsCulledByVis`](/api/Sandbox.Diagnostics.FrameStats/ObjectsCulledByVis): Number of objects culled by static visibility.
- [`ObjectsFading`](/api/Sandbox.Diagnostics.FrameStats/ObjectsFading): Number of objects currently being distance-faded.
- [`ObjectsPreCull`](/api/Sandbox.Diagnostics.FrameStats/ObjectsPreCull): Number of objects considered before culling.
- [`ObjectsRendered`](/api/Sandbox.Diagnostics.FrameStats/ObjectsRendered): Number of objects that passed all cull checks and were rendered.
- [`ObjectsTested`](/api/Sandbox.Diagnostics.FrameStats/ObjectsTested): Number of objects that were tested against cull checks.
- [`PendingStreamingRequests`](/api/Sandbox.Diagnostics.FrameStats/PendingStreamingRequests): In-flight resource streaming-data requests. Sustained > 0 indicates streaming pressure (mips/data still loading).
- [`PrimaryContexts`](/api/Sandbox.Diagnostics.FrameStats/PrimaryContexts): Number of primary render contexts created.
- [`RenderBatchDraws`](/api/Sandbox.Diagnostics.FrameStats/RenderBatchDraws): Number of render batch draw lists submitted.
- [`RenderTargetResolves`](/api/Sandbox.Diagnostics.FrameStats/RenderTargetResolves): Number of render target resolves.
- [`SceneViewsRendered`](/api/Sandbox.Diagnostics.FrameStats/SceneViewsRendered): Number of scene views rendered.
- [`SecondaryContexts`](/api/Sandbox.Diagnostics.FrameStats/SecondaryContexts): Number of secondary render contexts created.
- [`ShadowedLightsInView`](/api/Sandbox.Diagnostics.FrameStats/ShadowedLightsInView): Number of lights in view that cast shadows.
- [`ShadowMaps`](/api/Sandbox.Diagnostics.FrameStats/ShadowMaps): Number of shadow maps rendered this frame.
- [`ShadowMaterialChanges`](/api/Sandbox.Diagnostics.FrameStats/ShadowMaterialChanges): Number of depth-only (shadow pass) material changes.
- [`ShadowMaterialChangesAlphaTested`](/api/Sandbox.Diagnostics.FrameStats/ShadowMaterialChangesAlphaTested): Number of depth-only alpha-tested material changes.
- [`SimilarMaterialSets`](/api/Sandbox.Diagnostics.FrameStats/SimilarMaterialSets): Number of "similar" material sets (cheap reset against a near-identical material).
- [`TextureOnlyMaterialSets`](/api/Sandbox.Diagnostics.FrameStats/TextureOnlyMaterialSets): Number of texture-only material sets (only texture bindings changed).
- [`TexturePoolLimitBytes`](/api/Sandbox.Diagnostics.FrameStats/TexturePoolLimitBytes): Texture pool limit (dynamically tuned against GPU heap budget by the texture streamer), in bytes.
- [`TexturePoolNonEvictableBytes`](/api/Sandbox.Diagnostics.FrameStats/TexturePoolNonEvictableBytes): Portion of the texture pool occupied by non-evictable textures, in bytes.
- [`TexturePoolUsedBytes`](/api/Sandbox.Diagnostics.FrameStats/TexturePoolUsedBytes): Current texture pool memory usage as tracked by the texture streamer, in bytes.
- [`TrianglesRendered`](/api/Sandbox.Diagnostics.FrameStats/TrianglesRendered): Total number of triangles rendered.
- [`UnbatchableMaterialDraws`](/api/Sandbox.Diagnostics.FrameStats/UnbatchableMaterialDraws): Number of unbatchable material draws (materials that opted out of batching for the frame).
- [`UniqueMaterials`](/api/Sandbox.Diagnostics.FrameStats/UniqueMaterials): Number of unique materials seen this frame.
- [`UnshadowedLightsInView`](/api/Sandbox.Diagnostics.FrameStats/UnshadowedLightsInView): Number of lights in view that don't cast shadows.
- [`VfxEvals`](/api/Sandbox.Diagnostics.FrameStats/VfxEvals): Number of material Vfx evaluations this frame.
- [`VfxRuleChecks`](/api/Sandbox.Diagnostics.FrameStats/VfxRuleChecks): Number of material Vfx rule checks this frame.