TSDuck v3.38-3675
MPEG Transport Stream Toolkit
Loading...
Searching...
No Matches
ts::PESDemux Class Reference

This class extracts PES packets from TS packets. More...

#include <tsPESDemux.h>

Inheritance diagram for ts::PESDemux:
Collaboration diagram for ts::PESDemux:

Public Types

using SuperClass = TimeTrackerDemux
 Explicit reference to superclass.
 

Public Member Functions

 PESDemux (DuckContext &duck, PESHandlerInterface *handler=nullptr, const PIDSet &pids=AllPIDs)
 Constructor.
 
virtual ~PESDemux () override
 Destructor.
 
virtual void addPID (PID pid)
 Add one PID to filter.
 
virtual void addPIDs (const PIDSet &pids)
 Add several PID's to filter.
 
bool allAC3 (PID pid) const
 Check if all PES packets on the specified PID contain AC-3 audio.
 
int demuxId () const
 Get the "demux id" value, as previously stored by the application.
 
virtual void feedPacket (const TSPacket &pkt) override
 The following method feeds the demux with a TS packet.
 
void flushUnboundedPES ()
 Flush any unterminated unbounded PES packet on all PID's.
 
void flushUnboundedPES (PID pid)
 Flush any unterminated unbounded PES packet on the specified PID.
 
void getAC3Attributes (PID pid, AC3Attributes &attr) const
 Get the current AC-3 audio attributes on the specified PID.
 
void getAudioAttributes (PID pid, MPEG2AudioAttributes &attr) const
 Get the current audio attributes on the specified PID.
 
void getAVCAttributes (PID pid, AVCAttributes &attr) const
 Get the current AVC video attributes on the specified PID.
 
CodecType getDefaultCodec (PID pid) const
 Get the default codec type on a given PID.
 
void getHEVCAttributes (PID pid, HEVCAttributes &attr) const
 Get the current HEVC video attributes on the specified PID.
 
void getVideoAttributes (PID pid, MPEG2VideoAttributes &attr) const
 Get the current MPEG-2 video attributes on the specified PID.
 
virtual bool hasPID (PID pid) const
 Check if a PID is filtered.
 
virtual size_t pidCount () const
 Get the current number of PID's being filtered.
 
cn::milliseconds pidDuration (PID pid) const
 Get the number of milliseconds measured on a PID.
 
virtual void removePID (PID pid)
 Remove one PID to filter.
 
virtual void reset ()
 Reset the demux.
 
virtual void resetPID (PID pid)
 Reset the demuxing context for one single PID.
 
void setDefaultCodec (CodecType codec)
 Set the default audio or video codec for all analyzed PES PID's.
 
void setDefaultCodec (PID pid, CodecType codec)
 Set the default audio or video codec for one specific PES PID's.
 
void setDemuxId (int id)
 Set some arbitrary "demux id" value.
 
void setPESHandler (PESHandlerInterface *h)
 Replace the PES packet handler.
 
virtual void setPIDFilter (const PIDSet &pid_filter)
 Replace the list of PID's to filter.
 

Protected Member Functions

bool afterCallingHandler (bool executeDelayedOperations=true)
 Helper for subclass, after invoking an application-defined handler.
 
void beforeCallingHandler (PID pid=PID_NULL)
 Helper for subclass, before invoking an application-defined handler.
 
virtual void handlePESPacket (const PESPacket &packet)
 This hook is invoked when a complete PES packet is available.
 
virtual void immediateReset () override
 Reset the demux immediately.
 
virtual void immediateResetPID (PID pid) override
 Reset the demuxing context for one single PID immediately.
 

Protected Attributes

DuckContext_duck
 The TSDuck execution context is accessible to all subclasses.
 
PacketCounter _packet_count = 0
 Number of TS packets in the demultiplexed stream.
 
PIDSet _pid_filter {}
 Current set of filtered PID's.
 

Detailed Description

This class extracts PES packets from TS packets.

Constructor & Destructor Documentation

◆ PESDemux()

ts::PESDemux::PESDemux ( DuckContext duck,
PESHandlerInterface handler = nullptr,
const PIDSet pids = AllPIDs 
)
explicit

Constructor.

Parameters
[in,out]duckTSDuck execution context. The reference is kept inside the demux.
[in]handlerThe object to invoke when PES packets are analyzed.
[in]pidsThe set of PID's to demux.

Member Function Documentation

◆ feedPacket()

virtual void ts::PESDemux::feedPacket ( const TSPacket pkt)
overridevirtual

The following method feeds the demux with a TS packet.

Parameters
[in]pktA TS packet.

Reimplemented from ts::TimeTrackerDemux.

◆ flushUnboundedPES() [1/2]

void ts::PESDemux::flushUnboundedPES ( PID  pid)

Flush any unterminated unbounded PES packet on the specified PID.

Unbounded PES packets have no predetermined size. They implicitely end when the next PES packet starts on the same PID. However, at end of stream, there is no next PES packet and the previous buffered data are not considered as a full unbounded packet. These data are lost. This method shall be called at end of stream when the caller is certain that the buffered data from the PID form a complete PES packet. This PES packet is then processed.

Parameters
[in]pidPID containing an unbounded PES packet to complete.

◆ flushUnboundedPES() [2/2]

void ts::PESDemux::flushUnboundedPES ( )

Flush any unterminated unbounded PES packet on all PID's.

See also
flushUnboundedPES(PID)

◆ setPESHandler()

void ts::PESDemux::setPESHandler ( PESHandlerInterface h)
inline

Replace the PES packet handler.

Parameters
[in]hThe object to invoke when PES packets are analyzed.

◆ setDefaultCodec() [1/2]

void ts::PESDemux::setDefaultCodec ( CodecType  codec)
inline

Set the default audio or video codec for all analyzed PES PID's.

The analysis of the content of a PES packet sometimes depends on the PES data format. The PES demux uses several ways to determine the data format inside a PES packet. First, when the packet is identified in a PMT, the stream type may uniquely identify the format. Second, the content itself can be identified as a specific format. Finally, in the absence of other indications, the specified codec is used.

Parameters
[in]codecThe default codec to use.

◆ setDefaultCodec() [2/2]

void ts::PESDemux::setDefaultCodec ( PID  pid,
CodecType  codec 
)

Set the default audio or video codec for one specific PES PID's.

This is the same as setDefaultCodec(CodecType) for one specific PID. The codec of a PID is automatically determined from the characteristics of this PID in the PMT, if the PMT packets are passed to this demux.

Parameters
[in]pidThe PID to identify.
[in]codecThe default codec to use.
See also
setDefaultCodec(CodecType)

◆ getDefaultCodec()

CodecType ts::PESDemux::getDefaultCodec ( PID  pid) const

Get the default codec type on a given PID.

Parameters
[in]pidThe PID to check.
Returns
The default codec to use on pid.
See also
setDefaultCodec()

◆ getAudioAttributes()

void ts::PESDemux::getAudioAttributes ( PID  pid,
MPEG2AudioAttributes attr 
) const

Get the current audio attributes on the specified PID.

Parameters
[in]pidThe PID to check.
[out]attrThe returned attributes. Invoke its isValid() method to verify its validity.

◆ getVideoAttributes()

void ts::PESDemux::getVideoAttributes ( PID  pid,
MPEG2VideoAttributes attr 
) const

Get the current MPEG-2 video attributes on the specified PID.

Parameters
[in]pidThe PID to check.
[out]attrThe returned attributes. Invoke its isValid() method to verify its validity.

◆ getAVCAttributes()

void ts::PESDemux::getAVCAttributes ( PID  pid,
AVCAttributes attr 
) const

Get the current AVC video attributes on the specified PID.

Parameters
[in]pidThe PID to check.
[out]attrThe returned attributes. Invoke its isValid() method to verify its validity.

◆ getHEVCAttributes()

void ts::PESDemux::getHEVCAttributes ( PID  pid,
HEVCAttributes attr 
) const

Get the current HEVC video attributes on the specified PID.

Parameters
[in]pidThe PID to check.
[out]attrThe returned attributes. Invoke its isValid() method to verify its validity.

◆ getAC3Attributes()

void ts::PESDemux::getAC3Attributes ( PID  pid,
AC3Attributes attr 
) const

Get the current AC-3 audio attributes on the specified PID.

Parameters
[in]pidThe PID to check.
[out]attrThe returned attributes. Invoke its isValid() method to verify its validity.

◆ allAC3()

bool ts::PESDemux::allAC3 ( PID  pid) const

Check if all PES packets on the specified PID contain AC-3 audio.

Parameters
[in]pidThe PID to check.
Returns
True if all PES packets on the specified PID contain AC-3 audio. Due to the way AC-3 is detected, it is possible that some PES packets are erroneously detected as AC-3. Thus, getAC3Attributes() returns a valid value since some AC-3 was detected. But, on homogeneous streams, it is safe to assume that the PID really contains AC-3 only if all PES packets contain AC-3.

◆ handlePESPacket()

virtual void ts::PESDemux::handlePESPacket ( const PESPacket packet)
protectedvirtual

This hook is invoked when a complete PES packet is available.

Can be overloaded by subclasses to add intermediate processing.

Parameters
[in]packetThe PES packet.

Reimplemented in ts::TeletextDemux.

◆ immediateReset()

virtual void ts::PESDemux::immediateReset ( )
overrideprotectedvirtual

Reset the demux immediately.

Reimplemented from ts::TimeTrackerDemux.

Reimplemented in ts::TeletextDemux.

◆ immediateResetPID()

virtual void ts::PESDemux::immediateResetPID ( PID  pid)
overrideprotectedvirtual

Reset the demuxing context for one single PID immediately.

Parameters
[in]pidThe PID to reset.

Reimplemented from ts::TimeTrackerDemux.

Reimplemented in ts::TeletextDemux.

◆ pidDuration()

cn::milliseconds ts::TimeTrackerDemux::pidDuration ( PID  pid) const
inherited

Get the number of milliseconds measured on a PID.

Parameters
[in]pidThe 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.

◆ 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_filterThe list of PID's to filter.

◆ addPID()

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

Add one PID to filter.

Parameters
[in]pidThe new PID to filter.

Reimplemented in ts::MPEDemux.

◆ addPIDs()

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

Add several PID's to filter.

Parameters
[in]pidsThe 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]pidThe PID to no longer filter.

Reimplemented in ts::MPEDemux.

◆ pidCount()

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

Get the current number of PID's being filtered.

Returns
The current number of PID's being filtered.

◆ hasPID()

virtual bool ts::AbstractDemux::hasPID ( PID  pid) const
virtualinherited

Check if a PID is filtered.

Parameters
[in]pidThe 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]pidThe 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]idApplication-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:

try {
_handler->handleEvent(*this, pid, ...);
}
catch (...) {
throw;
}
bool afterCallingHandler(bool executeDelayedOperations=true)
Helper for subclass, after invoking an application-defined handler.
void beforeCallingHandler(PID pid=PID_NULL)
Helper for subclass, before invoking an application-defined handler.
Parameters
[in]pidThe 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  executeDelayedOperations = true)
protectedinherited

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

Parameters
[in]executeDelayedOperationsWhen 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: