TSDuck v3.46-4964
MPEG Transport Stream Toolkit
Loading...
Searching...
No Matches
ts::SignalizationDemux Class Reference

#include <tsSignalizationDemux.h>

Inheritance diagram for ts::SignalizationDemux:
Collaboration diagram for ts::SignalizationDemux:

Public Member Functions

 SignalizationDemux (DuckContext &duck)
 SignalizationDemux (DuckContext &duck, SignalizationHandlerInterface *handler, std::initializer_list< TID > tids=std::initializer_list< TID >())
void addFilteredService (const UString &name)
void addFilteredServiceId (uint16_t sid)
bool addFilteredTableId (TID tid)
void addFilteredTableIds (std::initializer_list< TID > tids)
void addFullFilters ()
bool atIntraFrame (PID pid) const
CodecType codecType (PID pid, CodecType deftype=CodecType::UNDEFINED) const
void feedPacket (const TSPacket &pkt)
void getPIDs (PIDSet &pids) const
const Service & getService (uint16_t id) const
void getServiceIds (PID pid, std::set< uint16_t > &services) const
void getServiceIds (std::set< uint16_t > &services) const
void getServices (ServiceList &services) const
bool hasNIT () const
bool hasPAT () const
bool inAnyService (PID pid, std::set< uint16_t > service_ids) const
bool inService (PID pid, uint16_t service_id) const
PacketCounter intraFrameCount (PID pid) const
uint8_t intraFrameFirstCC (PID pid) const
uint64_t intraFrameFirstDTS (PID pid) const
PacketCounter intraFrameFirstIndex (PID pid) const
uint64_t intraFrameFirstPCR (PID pid) const
uint64_t intraFrameFirstPTS (PID pid) const
uint8_t intraFrameLastCC (PID pid) const
uint64_t intraFrameLastDTS (PID pid) const
PacketCounter intraFrameLastIndex (PID pid) const
uint64_t intraFrameLastPCR (PID pid) const
uint64_t intraFrameLastPTS (PID pid) const
bool isFilteredServiceId (uint16_t sid) const
bool isFilteredServiceName (const UString &name) const
bool isFilteredTableId (TID tid) const
bool isScrambled (PID pid) const
const NIT & lastNIT () const
const PAT & lastPAT () const
Time lastUTC () const
uint16_t networkId () const
PID nitPID () const
uint16_t originalNetworkId () const
PacketCounter packetCount (PID pid) const
PIDClass pidClass (PID pid, PIDClass defclass=PIDClass::UNDEFINED) const
PacketCounter pusiCount (PID pid) const
uint8_t pusiFirstCC (PID pid) const
uint64_t pusiFirstDTS (PID pid) const
PacketCounter pusiFirstIndex (PID pid) const
uint64_t pusiFirstPCR (PID pid) const
uint64_t pusiFirstPTS (PID pid) const
uint8_t pusiLastCC (PID pid) const
uint64_t pusiLastDTS (PID pid) const
PacketCounter pusiLastIndex (PID pid) const
uint64_t pusiLastPCR (PID pid) const
uint64_t pusiLastPTS (PID pid) const
PID referencePMTPID (PID pid) const
void removeAllFilteredServices ()
void removeFilteredService (const UString &name)
void removeFilteredServiceId (uint16_t sid)
bool removeFilteredTableId (TID tid)
void removeFilteredTableIds (std::initializer_list< TID > tids)
void reset ()
uint16_t serviceId (PID pid) const
void setHandler (SignalizationHandlerInterface *handler)
uint8_t streamType (PID pid, uint8_t deftype=ST_NULL) const
uint16_t transportStreamId () const

Detailed Description

General-purpose signalization demux.

Constructor & Destructor Documentation

◆ SignalizationDemux() [1/2]

ts::SignalizationDemux::SignalizationDemux ( DuckContext & duck)
explicit

Constructor for full services and PID's analysis.

All signalization is demuxed. A full map of services and PID's is internally built. This is the typical constructor to use the application only needs to query the structure of services and PID's. It is still possible to add a handler for signalization tables later.

When the demux is reset, the full filtered are restored.

Parameters
[in,out]duckTSDuck execution context. The reference is kept inside the demux. Contextual information (such as standards) are accumulated in the context from demuxed sections.

◆ SignalizationDemux() [2/2]

ts::SignalizationDemux::SignalizationDemux ( DuckContext & duck,
SignalizationHandlerInterface * handler,
std::initializer_list< TID > tids = std::initializer_list< TID >() )
explicit

Constructor with handler and selected signalization.

This is the typical constructor to use when the application wants to be notified of some signalization tables only. The internal map of services and PID's may be incomplete, depending on the selected signalization.

Parameters
[in,out]duckTSDuck execution context. The reference is kept inside the demux. Contextual information (such as standards) are accumulated in the context from demuxed sections.
[in]handlerThe object to invoke when a new complete signalization table is extracted.
[in]tidsThe set of TID's to demux. Unsupported table ids are ignored. If TID_PMT is specified, all PMT's are filtered. To filter PMT's for selected services, use addServiceId().

Member Function Documentation

◆ feedPacket()

void ts::SignalizationDemux::feedPacket ( const TSPacket & pkt)

This method feeds the demux with a TS packet.

Parameters
[in]pktA TS packet.

◆ setHandler()

void ts::SignalizationDemux::setHandler ( SignalizationHandlerInterface * handler)
inline

Replace the signalization handler.

Parameters
[in]handlerThe new handler.

◆ reset()

void ts::SignalizationDemux::reset ( )

Reset the demux, remove all signalization filters.

If this object was built using the first constructor (one parameter), full filtering is reset to its default state.

◆ addFullFilters()

void ts::SignalizationDemux::addFullFilters ( )

Add table filtering for full services and PID's analysis. All signalization is demuxed. A full map of services and PID's is internally built.

◆ addFilteredTableId()

bool ts::SignalizationDemux::addFilteredTableId ( TID tid)

Add a signalization table id to filter.

Parameters
[in]tidThe table id to add. Unsupported table ids are ignored. If TID_PMT is specified, all PMT's are filtered. To filter PMT's for selected services, use addServiceId().
Returns
True if the table id is filtered, false if this table id is not supported.

◆ addFilteredTableIds()

void ts::SignalizationDemux::addFilteredTableIds ( std::initializer_list< TID > tids)

Add signalization table ids to filter.

Parameters
[in]tidsThe table ids to add.

◆ removeFilteredTableId()

bool ts::SignalizationDemux::removeFilteredTableId ( TID tid)

Remove a signalization table id to filter.

Parameters
[in]tidThe table id to remove. Unsupported table ids are ignored.
Returns
True if the table id was actually removed, false if this table id was not filtered or not supported.

◆ removeFilteredTableIds()

void ts::SignalizationDemux::removeFilteredTableIds ( std::initializer_list< TID > tids)

Remove signalization table ids to filter.

Parameters
[in]tidsThe table ids to remove.

◆ isFilteredTableId()

bool ts::SignalizationDemux::isFilteredTableId ( TID tid) const
inline

Check if a signalization table id is filtered.

Parameters
[in]tidThe table id to check.
Returns
True if tid is filtered, false otherwise.

◆ addFilteredServiceId()

void ts::SignalizationDemux::addFilteredServiceId ( uint16_t sid)

Add a service id to filter.

Parameters
[in]sidThe service id to add.

◆ removeFilteredServiceId()

void ts::SignalizationDemux::removeFilteredServiceId ( uint16_t sid)

Remove a service id to filter.

Parameters
[in]sidThe service id to remove.

◆ isFilteredServiceId()

bool ts::SignalizationDemux::isFilteredServiceId ( uint16_t sid) const
inline

Check if a service id is filtered.

Parameters
[in]sidThe service id to check.
Returns
True if sid is filtered, false otherwise.

◆ removeAllFilteredServices()

void ts::SignalizationDemux::removeAllFilteredServices ( )

Remove all services to filter.

◆ addFilteredService()

void ts::SignalizationDemux::addFilteredService ( const UString & name)

Add a service to filter, by name or by id.

Parameters
[in]nameThe service name or id to add.

◆ removeFilteredService()

void ts::SignalizationDemux::removeFilteredService ( const UString & name)

Remove a service to filter, by name or by id.

Parameters
[in]nameThe service name or id to remove.

◆ isFilteredServiceName()

bool ts::SignalizationDemux::isFilteredServiceName ( const UString & name) const

Check if a service name is filtered.

Parameters
[in]nameThe service name or id to check.
Returns
True if name is filtered, false otherwise.

◆ hasPAT()

bool ts::SignalizationDemux::hasPAT ( ) const
inline

Check if a PAT has been received.

Returns
True if a PAT has been received, false otherwise.

◆ lastPAT()

const PAT & ts::SignalizationDemux::lastPAT ( ) const
inline

Return a constant reference to the last PAT which has been received.

Returns
A constant reference to the last PAT.

◆ hasNIT()

bool ts::SignalizationDemux::hasNIT ( ) const
inline

Check if a NIT Actual has been received.

Returns
True if a NIT Actual has been received, false otherwise.

◆ lastNIT()

const NIT & ts::SignalizationDemux::lastNIT ( ) const
inline

Return a constant reference to the last NIT Actual which has been received.

Returns
A constant reference to the last NIT Actual.

◆ transportStreamId()

uint16_t ts::SignalizationDemux::transportStreamId ( ) const
inline

Get the transport stream id.

Returns
The transport stream id or INVALID_TS_ID if unknown.

◆ originalNetworkId()

uint16_t ts::SignalizationDemux::originalNetworkId ( ) const
inline

Get the original network id (from the SDT).

Returns
The original network id or INVALID_NETWORK_ID if unknown.

◆ networkId()

uint16_t ts::SignalizationDemux::networkId ( ) const
inline

Get the actual network id (from the NIT).

Returns
The original network id or INVALID_NETWORK_ID if unknown.

◆ nitPID()

PID ts::SignalizationDemux::nitPID ( ) const

Get the NIT PID, either from last PAT or default PID.

Returns
The NIT PID.

◆ lastUTC()

Time ts::SignalizationDemux::lastUTC ( ) const
inline

Get the last UTC time from a TOT/TDT (DVB, ISDB) or STT (ATSC).

Returns
The last received UTC time or Time::Epoch if there was none.

◆ getServiceIds() [1/2]

void ts::SignalizationDemux::getServiceIds ( std::set< uint16_t > & services) const

Get the list of all service ids in the TS.

Parameters
[out]servicesThe set of all services ids in the TS, as found so far.

◆ getServices()

void ts::SignalizationDemux::getServices ( ServiceList & services) const

Get the list of all services in the TS.

Parameters
[out]servicesThe list of all services in the TS, as found so far.

◆ getService()

const Service & ts::SignalizationDemux::getService ( uint16_t id) const

Get the complete description of a service by id.

Parameters
[in]idService id.
Returns
A constant reference to the description of the service. If the service was not yet found, return the reference to a Service instance where the service id is set to INVALID_SERVICE_ID.

◆ getPIDs()

void ts::SignalizationDemux::getPIDs ( PIDSet & pids) const

Get the set of PID's in the TS.

Parameters
[out]pidsThe set of PID's in the TS.

◆ pidClass()

PIDClass ts::SignalizationDemux::pidClass ( PID pid,
PIDClass defclass = PIDClass::UNDEFINED ) const

Get the class of a PID in the TS.

Parameters
[in]pidThe PID to check.
[in]defclassThe default PID class to use if the actual one is unknown.
Returns
The PID class.

◆ codecType()

CodecType ts::SignalizationDemux::codecType ( PID pid,
CodecType deftype = CodecType::UNDEFINED ) const

Get the codec which is used in PID in the TS.

Parameters
[in]pidThe PID to check.
[in]deftypeThe default codec type to use if the actual type is unknown.
Returns
The codec type.

◆ streamType()

uint8_t ts::SignalizationDemux::streamType ( PID pid,
uint8_t deftype = ST_NULL ) const

Get the stream type (from PMT) of a PID in the TS.

Parameters
[in]pidThe PID to check.
[in]deftypeThe default stream type to use if the actual type is unknown.
Returns
The stream type (from PMT).

◆ isScrambled()

bool ts::SignalizationDemux::isScrambled ( PID pid) const
inline

Check if a PID contains scrambled packets.

Parameters
[in]pidThe PID to check.
Returns
True if at least one scrambled packets has been found in the PID.

◆ packetCount()

PacketCounter ts::SignalizationDemux::packetCount ( PID pid) const
inline

Get the number of TS packets in a PID.

Parameters
[in]pidThe PID to check.
Returns
The number of packets in that PID.

◆ pusiCount()

PacketCounter ts::SignalizationDemux::pusiCount ( PID pid) const
inline

Get the number of TS packets with payload unit start indicator (PUSI) in a PID.

Parameters
[in]pidThe PID to check.
Returns
The number of PUSI in that PID.

◆ pusiFirstIndex()

PacketCounter ts::SignalizationDemux::pusiFirstIndex ( PID pid) const
inline

Get the number of TS packets in a PID before its first payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The number of TS packets in the PID before its first payload unit start indicator (PUSI) or INVALID_PACKET_COUNTER if there is no PUSI in the PID.

◆ pusiFirstPCR()

uint64_t ts::SignalizationDemux::pusiFirstPCR ( PID pid) const
inline

Get the PCR in a PID at its first payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The PCR in the PID at its first PUSI or INVALID_PCR if there is none.

◆ pusiFirstPTS()

uint64_t ts::SignalizationDemux::pusiFirstPTS ( PID pid) const
inline

Get the PTS in a PID at its first payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The PTS in the PID at its first PUSI or INVALID_PTS if there is none.

◆ pusiFirstDTS()

uint64_t ts::SignalizationDemux::pusiFirstDTS ( PID pid) const
inline

Get the DTS in a PID at its first payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The DTS in the PID at its first PUSI or INVALID_DTS if there is none.

◆ pusiFirstCC()

uint8_t ts::SignalizationDemux::pusiFirstCC ( PID pid) const
inline

Get the continuity counter in a PID at its first payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The continuity counter in the PID at its first PUSI or INVALID_CC if there is none.

◆ pusiLastIndex()

PacketCounter ts::SignalizationDemux::pusiLastIndex ( PID pid) const
inline

Get the number of TS packets in a PID before its last payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The number of TS packets in the PID before its last payload unit start indicator (PUSI) or INVALID_PACKET_COUNTER if there is no PUSI in the PID.

◆ pusiLastPCR()

uint64_t ts::SignalizationDemux::pusiLastPCR ( PID pid) const
inline

Get the PCR in a PID at its last payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The PCR in the PID at its last PUSI or INVALID_PCR if there is none.

◆ pusiLastPTS()

uint64_t ts::SignalizationDemux::pusiLastPTS ( PID pid) const
inline

Get the PTS in a PID at its last payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The PTS in the PID at its last PUSI or INVALID_PTS if there is none.

◆ pusiLastDTS()

uint64_t ts::SignalizationDemux::pusiLastDTS ( PID pid) const
inline

Get the DTS in a PID at its last payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The DTS in the PID at its last PUSI or INVALID_DTS if there is none.

◆ pusiLastCC()

uint8_t ts::SignalizationDemux::pusiLastCC ( PID pid) const
inline

Get the continuity counter in a PID at its last payload unit start indicator (PUSI).

Parameters
[in]pidThe PID to check.
Returns
The continuity counter in the PID at its last PUSI or INVALID_CC if there is none.

◆ intraFrameCount()

PacketCounter ts::SignalizationDemux::intraFrameCount ( PID pid) const
inline

Get the number of video intra-frames in a PID.

Parameters
[in]pidThe PID to check.
Returns
The number of video intra-frames in that PID.

◆ intraFrameFirstIndex()

PacketCounter ts::SignalizationDemux::intraFrameFirstIndex ( PID pid) const
inline

Get the number of TS packets in a PID before its first video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The number of TS packets in the PID before its first video intra-frame or INVALID_PACKET_COUNTER if there is no video intra-frame in the PID.

◆ intraFrameFirstPCR()

uint64_t ts::SignalizationDemux::intraFrameFirstPCR ( PID pid) const
inline

Get the PCR in a PID at its first video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The PCR in the PID at its first video intra-frame or INVALID_PCR if there is none.

◆ intraFrameFirstPTS()

uint64_t ts::SignalizationDemux::intraFrameFirstPTS ( PID pid) const
inline

Get the PTS in a PID at its first video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The PTS in the PID at its first video intra-frame or INVALID_PTS if there is none.

◆ intraFrameFirstDTS()

uint64_t ts::SignalizationDemux::intraFrameFirstDTS ( PID pid) const
inline

Get the DTS in a PID at its first video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The DTS in the PID at its first video intra-frame or INVALID_DTS if there is none.

◆ intraFrameFirstCC()

uint8_t ts::SignalizationDemux::intraFrameFirstCC ( PID pid) const
inline

Get the continuity counter in a PID at its first video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The continuity counter in the PID at its first video intra-frame or INVALID_CC if there is none.

◆ intraFrameLastIndex()

PacketCounter ts::SignalizationDemux::intraFrameLastIndex ( PID pid) const
inline

Get the number of TS packets in a PID before its last video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The number of TS packets in the PID before its last video intra-frame or INVALID_PACKET_COUNTER if there is no video intra-frame in the PID.

◆ intraFrameLastPCR()

uint64_t ts::SignalizationDemux::intraFrameLastPCR ( PID pid) const
inline

Get the PCR in a PID at its last video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The PCR in the PID at its last video intra-frame or INVALID_PCR if there is none.

◆ intraFrameLastPTS()

uint64_t ts::SignalizationDemux::intraFrameLastPTS ( PID pid) const
inline

Get the PTS in a PID at its last video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The PTS in the PID at its last video intra-frame or INVALID_PTS if there is none.

◆ intraFrameLastDTS()

uint64_t ts::SignalizationDemux::intraFrameLastDTS ( PID pid) const
inline

Get the DTS in a PID at its last video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The DTS in the PID at its last video intra-frame or INVALID_DTS if there is none.

◆ intraFrameLastCC()

uint8_t ts::SignalizationDemux::intraFrameLastCC ( PID pid) const
inline

Get the continuity counter in a PID at its last video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
The continuity counter in the PID at its last video intra-frame or INVALID_CC if there is none.

◆ atIntraFrame()

bool ts::SignalizationDemux::atIntraFrame ( PID pid) const

Check if the past packet of a PID contained the start of a video intra-frame.

Parameters
[in]pidThe PID to check.
Returns
True if the past packet of a PID contained the start of a video intra-frame.

◆ inService()

bool ts::SignalizationDemux::inService ( PID pid,
uint16_t service_id ) const

Check if a PID is a component of a service.

Parameters
[in]pidThe PID to check.
[in]service_idService id.
Returns
True is pid is part of service_id.

◆ inAnyService()

bool ts::SignalizationDemux::inAnyService ( PID pid,
std::set< uint16_t > service_ids ) const

Check if a PID is a component of any service in a set of services.

Parameters
[in]pidThe PID to check.
[in]service_idsA set of service ids.
Returns
True is pid is part of any service in service_ids.

◆ serviceId()

uint16_t ts::SignalizationDemux::serviceId ( PID pid) const

Get the service of a PID.

Parameters
[in]pidThe PID to check.
Returns
The first service in which pid was found or INVALID_SERVICE_ID if there was none.

◆ referencePMTPID()

PID ts::SignalizationDemux::referencePMTPID ( PID pid) const

Get the PMT PID where a PID is referenced.

Parameters
[in]pidThe PID to check.
Returns
The PID of the PMT of the first service in which pid was found or PID_NULL if there was none.

◆ getServiceIds() [2/2]

void ts::SignalizationDemux::getServiceIds ( PID pid,
std::set< uint16_t > & services ) const

Get the services of a PID.

Parameters
[in]pidThe PID to check.
[out]servicesThe set of services in which pid was found.

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