ts::TimeTrackerDemux Class Reference

#include <tsTimeTrackerDemux.h>

Inheritance diagram for ts::TimeTrackerDemux:

Collaboration diagram for ts::TimeTrackerDemux:

Public Types
using	SuperClass = AbstractDemux

Public Member Functions
	TimeTrackerDemux (DuckContext &duck, const PIDSet &pid_filter=NoPID())
virtual void	addPID (PID pid)
virtual void	addPIDs (const PIDSet &pids)
int	demuxId () const
DuckContext &	duck ()
virtual void	feedPacket (const TSPacket &pkt) override
virtual bool	isFilteredPID (PID pid) const
virtual size_t	pidCount () const
cn::milliseconds	pidDuration (PID pid) const
PacketCounter	processedPackets () const
virtual void	removePID (PID pid)
Report &	report ()
virtual void	reset ()
virtual void	resetPID (PID pid)
void	setDemuxId (int id)
virtual void	setPIDFilter (const PIDSet &pid_filter)
PacketCounter	totalPackets () const

Protected Member Functions
bool	afterCallingHandler (bool execute_delayed_operations=true)
void	beforeCallingHandler (PID pid=PID_NULL)
virtual void	immediateReset () override
virtual void	immediateResetPID (PID pid) override

Detailed Description

A demux which tracks time stamps per PID.

Typically used as a superclass by other demux which need time tracking in addition to other demux activities.

Member Typedef Documentation

SuperClass

using ts::TimeTrackerDemux::SuperClass = AbstractDemux

Explicit reference to superclass.

Constructor & Destructor Documentation

TimeTrackerDemux()

ts::TimeTrackerDemux::TimeTrackerDemux ( DuckContext & duck, const PIDSet & pid_filter = NoPID() )

explicit

Constructor.

Parameters

[in,out]	duck	TSDuck execution context. The reference is kept inside the demux.
[in]	pid_filter	The initial set of PID's to demux.

Member Function Documentation

pidDuration()

cn::milliseconds ts::TimeTrackerDemux::pidDuration

(

PID

pid

)

const

Get the number of milliseconds measured on a PID.

Parameters

[in]

pid

The PID to check.

Returns

The number of milliseconds of the content of the specified pid, since the beginning of the stream, based on the PTS of this PID. If no PTS were found on this PID, use PCR's from another PID. Return zero is no timing information was found.

feedPacket()

virtual void ts::TimeTrackerDemux::feedPacket ( const TSPacket & pkt )

overridevirtual

The following method feeds the demux with a TS packet.

Parameters

[in]

pkt

A TS packet.

Reimplemented from ts::AbstractDemux.

Reimplemented in ts::PESDemux.

immediateReset()

virtual void ts::TimeTrackerDemux::immediateReset ( )

overrideprotectedvirtual

Reset the demux immediately.

Reimplemented from ts::AbstractDemux.

Reimplemented in ts::PESDemux, and ts::TeletextDemux.

immediateResetPID()

virtual void ts::TimeTrackerDemux::immediateResetPID ( PID pid )

overrideprotectedvirtual

Reset the demuxing context for one single PID immediately.

Parameters

[in]

pid

The PID to reset.

Reimplemented from ts::AbstractDemux.

Reimplemented in ts::PESDemux, and ts::TeletextDemux.

report()

Report & ts::AbstractDemux::report ( )

inlineinherited

Get the associated Report.

Returns

A reference to the associated Report.

duck()

DuckContext & ts::AbstractDemux::duck ( )

inlineinherited

Get the associated TSDuck execution context.

Returns

A reference to the associated DuckContext.

setPIDFilter()

virtual void ts::AbstractDemux::setPIDFilter ( const PIDSet & pid_filter )

virtualinherited

Replace the list of PID's to filter. The method resetPID() is invoked on each removed PID.

Parameters

[in]

pid_filter

The list of PID's to filter.

addPID()

virtual void ts::AbstractDemux::addPID ( PID pid )

inlinevirtualinherited

Add one PID to filter.

Parameters

[in]

pid

The new PID to filter.

Reimplemented in ts::MPEDemux.

addPIDs()

virtual void ts::AbstractDemux::addPIDs ( const PIDSet & pids )

inlinevirtualinherited

Add several PID's to filter.

Parameters

[in]

pids

The list of new PID's to filter.

Reimplemented in ts::MPEDemux.

removePID()

virtual void ts::AbstractDemux::removePID ( PID pid )

virtualinherited

Remove one PID to filter. The method resetPID() is invoked on pid.

Parameters

[in]

pid

The PID to no longer filter.

Reimplemented in ts::MPEDemux.

pidCount()

virtual size_t ts::AbstractDemux::pidCount ( ) const

inlinevirtualinherited

Get the current number of PID's being filtered.

Returns

The current number of PID's being filtered.

totalPackets()

PacketCounter ts::AbstractDemux::totalPackets ( ) const

inlineinherited

Get the current total number of TS packets which were processed by the demux.

Returns

The current number of TS packets which were processed by the demux.

processedPackets()

PacketCounter ts::AbstractDemux::processedPackets ( ) const

inlineinherited

Get the number of processed TS packets in filtered PIDs.

Returns

The number of processed TS packets.

isFilteredPID()

virtual bool ts::AbstractDemux::isFilteredPID ( PID pid ) const

inlinevirtualinherited

Check if a PID is filtered.

Parameters

[in]

pid

The PID to test.

Returns

Tue if pid is filtered.

reset()

virtual void ts::AbstractDemux::reset ( )

virtualinherited

Reset the demux.

Useful when the transport stream changes. The PID filter and the handlers are not modified.

If invoked in an application-handler, the operation is delayed until the handler terminates. For subclass implementers, see beforeCallingHandler() and override immediateReset() instead of reset().

Reimplemented in ts::StandaloneTableDemux.

resetPID()

virtual void ts::AbstractDemux::resetPID ( PID pid )

virtualinherited

Reset the demuxing context for one single PID. Forget all previous partially demuxed data on this PID.

If invoked in an application-handler, the operation is delayed until the handler terminates. For subclass implementers, see beforeCallingHandler() and override immediateResetPID() instead of resetPID().

Parameters

[in]

pid

The PID to reset.

Reimplemented in ts::StandaloneTableDemux.

setDemuxId()

void ts::AbstractDemux::setDemuxId ( int id )

inlineinherited

Set some arbitrary "demux id" value. This value is chosen and set by the application. It can be retrieved later if a table or section handler is used by several demux. The demux id is not interpreted by the demux, it is only stored for the application. The initial value of a demux id is zero.

Parameters

[in]

id

Application-defined demux id to assign.

demuxId()

int ts::AbstractDemux::demuxId ( ) const

inlineinherited

Get the "demux id" value, as previously stored by the application.

Returns

The application-defined demux id.

beforeCallingHandler()

void ts::AbstractDemux::beforeCallingHandler ( PID pid = PID_NULL )

protectedinherited

Helper for subclass, before invoking an application-defined handler.

The idea is to protect the integrity of the demux during the execution of an application-defined handler. The handler is invoked in the middle of an operation but the handler may call reset() or resetPID(). Executing the reset in the middle of an operation may be problematic. By using beforeCallingHandler() and afterCallingHandler(), all reset operations in between are delayed after the execution of the handler.

Example:

beforeCallingHandler(pid);
try {
    _handler->handleEvent(*this, pid, ...);
}
catch (...) {
    afterCallingHandler(false);
    throw;
}
afterCallingHandler();

Parameters

[in]

pid

The PID for which the handler will be called. All reset operations on this PID will be delayed until afterCallingHandler().

afterCallingHandler()

bool ts::AbstractDemux::afterCallingHandler ( bool execute_delayed_operations = true )

protectedinherited

Helper for subclass, after invoking an application-defined handler.

Parameters

[in]

execute_delayed_operations

When true (the default), execute all pending reset operations.

Returns

True if a delayed reset was executed.

See also

beforeCallingHandler()

---

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

• tsTimeTrackerDemux.h