StormByte-Multimedia 3.3.2
C++26 multimedia processing module of the StormByte suite
Loading...
Searching...
No Matches
StormByte::Multimedia::PreviewDiagnostics Struct Reference

Thread-safe diagnostics, cumulative since Open (including seeks). More...

#include <StormByte/multimedia/simple_player.hxx>

Collaboration diagram for StormByte::Multimedia::PreviewDiagnostics:

Public Attributes

Safe::String m_decoder
 Opened video codec name; empty without video.
Safe::String m_device
 Actual hardware-frame device type, otherwise empty.
PreviewDecodeBackend m_backend = PreviewDecodeBackend::Unknown
 Unknown until a frame is decoded.
std::uint64_t m_skipped_video = 0
 Processing-pressure drops, not seek trimming.
std::uint64_t m_shown_video = 0
 Successful video sink callbacks, not compositor presentations.
std::uint64_t m_audio_underruns = 0
std::uint64_t m_audio_clock_samples = 0
 Valid active-clock observations.
std::uint64_t m_converted_video = 0
 Successfully converted pictures.
std::size_t m_peak_queue_bytes = 0
 Decoded presentation payload only, not process RSS.
double m_download_seconds = 0
double m_linearization_seconds = 0
 HDR input matrix/primaries conversion plus linearization.
double m_tone_mapping_seconds = 0
double m_color_conversion_seconds = 0
 HDR output transfer/color conversion.
double m_rgba_packing_seconds = 0
 Allocation and packing; fused color conversion for SDR.
double m_conversion_fps = 0
 Pictures / sum of measured conversion-stage seconds; excludes queue waits.

Detailed Description

Thread-safe diagnostics, cumulative since Open (including seeks).

Stage seconds are elapsed wall time on the conversion worker, including setup, not summed CPU time across its internal threads. SDR swscale fuses color conversion and packing; its time is charged only to packing. Underruns count drained AudioClock episodes during active production, not device xruns; an invalid clock cannot measure them.

Member Data Documentation

◆ m_audio_clock_samples

std::uint64_t StormByte::Multimedia::PreviewDiagnostics::m_audio_clock_samples = 0

Valid active-clock observations.

◆ m_audio_underruns

std::uint64_t StormByte::Multimedia::PreviewDiagnostics::m_audio_underruns = 0

◆ m_backend

PreviewDecodeBackend StormByte::Multimedia::PreviewDiagnostics::m_backend = PreviewDecodeBackend::Unknown

Unknown until a frame is decoded.

◆ m_color_conversion_seconds

double StormByte::Multimedia::PreviewDiagnostics::m_color_conversion_seconds = 0

HDR output transfer/color conversion.

◆ m_conversion_fps

double StormByte::Multimedia::PreviewDiagnostics::m_conversion_fps = 0

Pictures / sum of measured conversion-stage seconds; excludes queue waits.

◆ m_converted_video

std::uint64_t StormByte::Multimedia::PreviewDiagnostics::m_converted_video = 0

Successfully converted pictures.

◆ m_decoder

Safe::String StormByte::Multimedia::PreviewDiagnostics::m_decoder

Opened video codec name; empty without video.

◆ m_device

Safe::String StormByte::Multimedia::PreviewDiagnostics::m_device

Actual hardware-frame device type, otherwise empty.

◆ m_download_seconds

double StormByte::Multimedia::PreviewDiagnostics::m_download_seconds = 0

◆ m_linearization_seconds

double StormByte::Multimedia::PreviewDiagnostics::m_linearization_seconds = 0

HDR input matrix/primaries conversion plus linearization.

◆ m_peak_queue_bytes

std::size_t StormByte::Multimedia::PreviewDiagnostics::m_peak_queue_bytes = 0

Decoded presentation payload only, not process RSS.

◆ m_rgba_packing_seconds

double StormByte::Multimedia::PreviewDiagnostics::m_rgba_packing_seconds = 0

Allocation and packing; fused color conversion for SDR.

◆ m_shown_video

std::uint64_t StormByte::Multimedia::PreviewDiagnostics::m_shown_video = 0

Successful video sink callbacks, not compositor presentations.

◆ m_skipped_video

std::uint64_t StormByte::Multimedia::PreviewDiagnostics::m_skipped_video = 0

Processing-pressure drops, not seek trimming.

◆ m_tone_mapping_seconds

double StormByte::Multimedia::PreviewDiagnostics::m_tone_mapping_seconds = 0

The documentation for this struct was generated from the following file: