Class DecklinkRendererProps

Namespace

VisioForge.Core.Types.Decklink

Assembly

VisioForge.Core.dll

Performance and quality metrics for DeckLink video renderer.

public class DecklinkRendererProps

Inheritance

object

DecklinkRendererProps

Inherited Members

object.Equals(object?)

object.Equals(object?, object?)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object?, object?)

object.ToString()

Remarks

Provides real-time statistics about the DeckLink output performance, helping to identify timing issues, dropped frames, and synchronization problems. These metrics are crucial for maintaining broadcast-quality output and diagnosing performance bottlenecks in the rendering pipeline.

Properties

AvgFrameRate

Gets or sets the average frame rate achieved by the renderer.

public int AvgFrameRate { get; set; }

Property Value

int

Remarks

Measured in frames per second. This should match the target frame rate for smooth playback. Lower values indicate performance issues or system resource constraints.

AvgSyncOffset

Gets or sets the average synchronization offset in milliseconds.

public int AvgSyncOffset { get; set; }

Property Value

int

Remarks

Measures the time difference between when a frame was scheduled for output and when it was actually rendered. Positive values indicate late frames, negative values indicate early frames. Values close to zero indicate good synchronization. High values may cause audio/video sync issues.

DevSyncOffset

Gets or sets the standard deviation of synchronization offset.

public int DevSyncOffset { get; set; }

Property Value

int

Remarks

Indicates the consistency of frame timing. Low values mean consistent frame delivery, while high values indicate irregular timing that can cause visible stuttering or judder. Broadcast applications typically require very low deviation for smooth output.

FramesDrawn

Gets or sets the total number of frames successfully rendered since playback started.

public int FramesDrawn { get; set; }

Property Value

int

Remarks

This counter helps calculate the actual vs expected frame count to identify if frames are being dropped. In a perfect scenario, this should match the expected frame count based on duration and frame rate.

FramesDroppedInRenderer

Gets or sets the number of frames dropped by the renderer.

public int FramesDroppedInRenderer { get; set; }

Property Value

int

Remarks

Dropped frames occur when the renderer cannot keep up with the source frame rate, typically due to system performance limitations or incorrect timing. Any dropped frames in broadcast applications are considered critical errors as they result in visible glitches.

Jitter

Gets or sets the average time variation between successive frames (jitter) in milliseconds.

public int Jitter { get; set; }

Property Value

int

Remarks

Measures timing irregularity in frame delivery. Low jitter values indicate smooth, consistent frame pacing. High jitter can cause motion artifacts and is particularly problematic for live broadcast where timing precision is critical. Values should be as close to zero as possible.