PresentationBuffer Class

The PresentationBuffer helps re-ordering pictures based on their presentation time. This is necessary when DTS are not equal to PTS.

Inheritance Hierarchy

SystemObject
StreamCodersPresentationBuffer

Namespace: StreamCoders
Assembly: MediaBase (in MediaBase.dll) Version: 2.0.5.0 (2.0.5.0)

Syntax

C++

Copy

public class PresentationBuffer

Public Class PresentationBuffer

public ref class PresentationBuffer

type PresentationBuffer =  class end

The PresentationBuffer type exposes the following members.

Constructors

	Name	Description
	PresentationBuffer	Initializes a new instance of the PresentationBuffer class. The OutputQueue with the default constructor does not have a Count limit.
	PresentationBuffer(Int32)	Initializes a new instance of the PresentationBuffer class.

Top

Properties

	Name	Description
	Count	Gets the number of items current held in the presentation buffer.
	CurrentReorderDelay	Current re-order delay of the presentation buffer.
	MaximumReorderDelay	The maximum delay introduced when re-ordering of pictures in the presentation is necessary.

Top

Methods

	Name	Description
	AddFrame(MediaBufferByte)	Adds a frame to the presentation buffer.
	AddFrame(MediaBufferByte, CancellationToken)	Adds a new frame to the presentation buffer.
	Clear	Clears this PresentationBuffer to its blank/initial state.

Top

Fields

	Name	Description
	OutputQueue

Top

Extension Methods

	Name	Description
	Copy	Overloaded. Creates a copy of the object. (Defined by ObjectExtensions.)
	Copy(Object)	Overloaded. Creates a deep copy of the object using the supplied object as a target for the copy operation. (Defined by ObjectExtensions.)

Top

Remarks

In scenarios with B-Frames it is necessary to re-order pictures from decode order to presentation order.

PresentationBuffer automatically detects non-monotonically increasing presentation times and introduces an artificial delay in the playout so that the most recent decoded frames can be ordered correctly.

At best the presentation buffer introduces a delay of 1 frame, at worst it can be up to 16 frames for H.264 when using B-Frames or in general with any decoder, it can introduce a delay of the IPB-frame distance.

Reference

StreamCoders Namespace