THPDFRenderBackendStatistics Record
Aggregates attempt, success, failure, fallback and serialisation counters recorded across page render backend calls
Declaration
THPDFRenderBackendStatistics= record
AttemptCount: Int64;
SuccessCount: Int64;
FailureCount: Int64;
FallbackCount: Int64;
SerializedCallCount: Int64;
LastElapsedMilliseconds: Cardinal;
LastBackendName: AnsiString;
LastFailureReason: AnsiString;
end;Unit
HPDFPageRenderer
Fields
| Field | Purpose |
|---|---|
AttemptCount | Total render attempts dispatched to whichever backend |
SuccessCount | Attempts that yielded a bitmap |
FailureCount | Attempts that came to grief |
FallbackCount | Attempts the software fallback resolved after a backend failure |
SerializedCallCount | Attempts that had to run serialised under the render lock rather than concurrently |
LastElapsedMilliseconds | Duration of the most recent attempt, in milliseconds |
LastBackendName | Name of the backend that dealt with the most recent attempt |
LastFailureReason | Failure text reported by the latest failed attempt |
Usage notes
- Read the counters with
THotPDF.GetRenderBackendStatistics, which returns True once at least one attempt has been recorded THotPDF.ResetRenderBackendStatisticssets every counter back to zero under the render lockLastBackendNameandLastFailureReasondescribe only the most recent attempt and not the whole run