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

Coherent, allocation-free value for one worker execution. More...

#include <StormByte/multimedia/pipeline/activity.hxx>

Public Member Functions

std::chrono::nanoseconds Elapsed () const noexcept
 Observed lifetime of this execution, frozen on termination.
bool operator== (const WorkerActivitySnapshot &other) const noexcept=default
 Compare complete samples, including identities and reference ticks.

Public Attributes

std::uint64_t Id = 0
 Process-unique worker identity.
std::uint64_t Generation = 0
 Increments on each new execution.
ActivityRole Role = ActivityRole::Main
 Execution domain.
int Track = -1
 Source track for a demux feeder; -1 for the main worker.
bool Available = false
 False until this execution starts.
ActivityState State = ActivityState::Unknown
 State at SampledAt.
std::chrono::nanoseconds StartedAt {}
 Beginning of this generation.
std::chrono::nanoseconds SampledAt {}
 Coherent reference tick, frozen at termination.
std::chrono::nanoseconds FinishedAt {}
 Termination tick; zero while live.
std::chrono::nanoseconds Unknown {}
 Unclassified wall time.
std::chrono::nanoseconds Preparing {}
 Setup wall time.
std::chrono::nanoseconds Processing {}
 Process wall time minus instrumented waits.
std::chrono::nanoseconds WaitingInput {}
 Upstream waits.
std::chrono::nanoseconds WaitingOutput {}
 Local downstream waits.
std::chrono::nanoseconds WaitingBudget {}
 Aggregate budget waits.
std::chrono::nanoseconds Paused {}
 Cooperative pause waits.

Detailed Description

Coherent, allocation-free value for one worker execution.

Steady-clock references are process-local nanoseconds, not UTC. SampledAt includes the currently open interval; after termination it equals FinishedAt and the entire value is immutable until another Start. The seven durations sum exactly to Elapsed(), including unclassified time. Compare only samples with the same topology Run, stage Id, worker Id and Generation. Workers are independent: never sum their percentages as one exclusive stage state.

Member Function Documentation

◆ Elapsed()

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Elapsed ( ) const
inlinenoexcept

Observed lifetime of this execution, frozen on termination.

Returns
Wall time accounted by the seven categories.

◆ operator==()

bool StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::operator== ( const WorkerActivitySnapshot & other) const
defaultnoexcept

Compare complete samples, including identities and reference ticks.

Parameters
otherSample to compare.
Returns
True when every field matches.

Member Data Documentation

◆ Available

bool StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Available = false

False until this execution starts.

◆ FinishedAt

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::FinishedAt {}

Termination tick; zero while live.

◆ Generation

std::uint64_t StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Generation = 0

Increments on each new execution.

◆ Id

std::uint64_t StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Id = 0

Process-unique worker identity.

◆ Paused

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Paused {}

Cooperative pause waits.

◆ Preparing

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Preparing {}

Setup wall time.

◆ Processing

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Processing {}

Process wall time minus instrumented waits.

◆ Role

ActivityRole StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Role = ActivityRole::Main

Execution domain.

◆ SampledAt

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::SampledAt {}

Coherent reference tick, frozen at termination.

◆ StartedAt

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::StartedAt {}

Beginning of this generation.

◆ State

ActivityState StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::State = ActivityState::Unknown

State at SampledAt.

◆ Track

int StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Track = -1

Source track for a demux feeder; -1 for the main worker.

◆ Unknown

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::Unknown {}

Unclassified wall time.

◆ WaitingBudget

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::WaitingBudget {}

Aggregate budget waits.

◆ WaitingInput

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::WaitingInput {}

Upstream waits.

◆ WaitingOutput

std::chrono::nanoseconds StormByte::Multimedia::Pipeline::WorkerActivitySnapshot::WaitingOutput {}

Local downstream waits.


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