Record TRenderStatistics

Hierarchy
Properties

Unit

Declaration

type TRenderStatistics = record

Description

Statistics about what was rendered during last frame. You will usually access this by scene manager property, see TCastleAbstractViewport.Statistics.

Overview

Fields

Public ShapesRendered: Cardinal;
Public ShapesVisible: Cardinal;
Public BoxesOcclusionQueriedCount: Cardinal;
Public ScenesRendered: Cardinal;
Public ScenesVisible: Cardinal;

Methods

Public function ToString: String;

Description

Fields

Public ShapesRendered: Cardinal;

How many shapes were rendered (send to OpenGL) versus all shapes that were potentially visible. Potentially visible shapes are the ones with TShape.Visible inside a 3D object with TCastleTransform.GetExists.

When ShapesRendered is much smaller than ShapesVisible, it means that the algorithm for removing invisible scene parts works good. This includes per-shape frustum culling (see TCastleScene.FrustumCulling), distance culling (TCastleScene.DistanceCulling), occlusion culling (see TSceneRenderingAttributes.UseOcclusionQuery).

Public ShapesVisible: Cardinal;

How many shapes were rendered (send to OpenGL) versus all shapes that were potentially visible. Potentially visible shapes are the ones with TShape.Visible inside a 3D object with TCastleTransform.GetExists.

When ShapesRendered is much smaller than ShapesVisible, it means that the algorithm for removing invisible scene parts works good. This includes per-shape frustum culling (see TCastleScene.FrustumCulling), distance culling (TCastleScene.DistanceCulling), occlusion culling (see TSceneRenderingAttributes.UseOcclusionQuery).

Public BoxesOcclusionQueriedCount: Cardinal;

The number of shapes that were not rendered, but their bounding box was rendered to check with occlusion query. This is always zero when not using occlusion query (see TSceneRenderingAttributes.UseOcclusionQuery). Basically, this measures the "invisible overhead" of occlusion query.

Public ScenesRendered: Cardinal;

TCastleScene rendered vs all visible.

Public ScenesVisible: Cardinal;

TCastleScene rendered vs all visible.

Methods

Public function ToString: String;

Present the statistics information as a multi-line string. Display it e.g. by assigning to TCastleLabel.Caption.


Generated by PasDoc 0.15.0.