Extended MPEG descriptor id. More...

#include <tsEDID.h>

Public Types
enum class	Type : uint8_t { REGULAR = 0x00 , PRIVATE = 0x01 , EXTENDED = 0x02 , TABLE_SPEC = 0x03 , INVALID = 0xFF }
	Enumeration of descriptor types. More...

Public Member Functions
	EDID ()=default
	Default constructor.

constexpr	EDID (uint64_t edid)
	Constructor from a 64-bit EDID value.

DID	did () const
	Get the descriptor id (aka tag).

DID	didExtDVB () const
	Get the DVB descriptor tag extension.

DID	didExtension () const
	Get the MPEG or DVB descriptor tag extension.

DID	didExtMPEG () const
	Get the MPEG descriptor tag extension.

uint64_t	encoded () const
	Get the 64-bit encoded EDID value.

bool	isExtension () const
	Check if the descriptor is an MPEG or DVB extension descriptor.

bool	isExtensionDVB () const
	Check if the descriptor is a DVB extension descriptor.

bool	isExtensionMPEG () const
	Check if the descriptor is an MPEG extension descriptor.

bool	isPrivateDual () const
	Check if the descriptor is a dual private descriptor (can be used as MPEG or DVB private descriptor).

bool	isPrivateDVB () const
	Check if the descriptor is a DVB or dual private descriptor.

bool	isPrivateMPEG () const
	Check if the descriptor is a MPEG or dual private descriptor.

bool	isRegular () const
	Check if the descriptor is a regular one.

bool	isTableSpecific () const
	Check if the descriptor is table-specific.

bool	isValid () const
	Check if the extended descriptor id is valid.

bool	matchRegularStandards (Standards std) const
	Check if the descriptor is a regular one and matches at least one standard.

bool	matchTableSpecific (TID tid, Standards std) const
	Check if the descriptor is table-specific and matches a given table id.

PDS	pds () const
	Get the DVB private data specifier.

REGID	privateId () const
	Get the MPEG registration identifier or DVB private data specifier.

REGID	regid () const
	Get the MPEG registration identifier.

Standards	standards () const
	Get the associated standards.

std::set< TID >	tableIds () const
	Get the required table-ids for a table-specific descriptor.

UString	toString () const
	Convert to a string object.

Type	type () const
	Get the descriptor type.

XDID	xdid () const
	Build an eXtension Descriptor Id from the EDID.

Static Public Member Functions
static EDID	Extension (XDID xdid)
	Build the EDID for an MPEG or DVB extension descriptor.

static constexpr EDID	ExtensionDVB (DID ext)
	Build the EDID for a DVB extension descriptor.

static constexpr EDID	ExtensionMPEG (DID ext)
	Build the EDID for an MPEG extension descriptor.

static constexpr EDID	PrivateDual (DID did, PDS pds)
	Build the EDID for a dual private descriptor.

static constexpr EDID	PrivateDVB (DID did, PDS pds)
	Build the EDID for a private DVB descriptor.

static constexpr EDID	PrivateMPEG (DID did, REGID regid)
	Build the EDID for a private MPEG descriptor.

static constexpr EDID	Regular (DID did, Standards std)
	Build the EDID for a regular descriptor.

static EDID	TableSpecific (DID did, Standards std, TID tid1, TID tid2=TID_NULL, TID tid3=TID_NULL, TID tid4=TID_NULL)
	Build the EDID for a table-specific descriptor.

Detailed Description

Extended MPEG descriptor id.

For convenience, it is sometimes useful to identify descriptors using an "extended DID" because a descriptor tag is not always enough to uniquely identify a descriptor.

A descriptor usually falls into one of the following categories:

Regular descriptor (tag in the range 0x00-0x3F for MPEG, 0x40-7F for DVB, unspecified for other standards). This descriptor is usually associated to a standard (MPEG, DVB, ATSC, ISDB, etc.)
Private MPEG descriptor (unofficial name). Must be associated with a 32-bit registration id, or REGID, in a preceding MPEG registration_descriptor. This descriptor can be in the same descriptor list or a higher descriptor list.
Private DVB descriptor (tag in the range 0x80-0xFF). Must be associated with a 32-bit private data specifier or PDS, in a preceding private_data_specifier descriptor in the same descriptor list.
Dual private descriptor: Can be used either as private MPEG or private DVB descriptor. The same 32-bit value is used as MPEG registration id and DVB private data specifier.
MPEG or DVB extension descriptor (tag == 0x3F or 0x7F). Must be associated with a 8-bit tag extension.
Table-specific descriptor. Its tag reuses a tag which is otherwise used by some regular descriptor, typically in the MPEG-defined range 0x00-0x3F. Such a descriptor can only be found in one or more specific tables such as AIT, INT or UNT (DVB). In these tables, the descriptor tag is interpreted as this table-specific descriptor. Of course, the regular descriptor which normally uses this tag value cannot be present in these tables. The descriptor tag must be associated with an 8-bit table id (and the associated standard). If the table-specific descriptor is used in several tables, up to 4 different table ids can be set in the EDID. Table-specific descriptors for more than 4 tables are not supported (in practice, the maximum is 2 tables).

The "extended DID" or EDID is a 64-bit value as used in the file tsDID.names. The C++ class EDID encapsulates this value, nothing more.

The EDID 64-bit value is structured as follow: 0xSSSSTTRRRRRRRRDD.

0xSSSS, 16 bits: Mask of associated standards. See enum class Standards.
0xTT, 8 bits: Descriptor type. The possible values are:
- 0x00: Regular descriptor for the specified standard.
- 0x01: Private descriptor, needs a registration id or private data specifier.
- 0x02: Extension descriptor. The descriptor tag must be 0x3F (MPEG) or 0x7F (DVB).
- 0x03: Table-specific descriptor.
- 0xFF: Invalid.
0xRRRRRRRR, 32 bits: Registration value. It depends on the descriptor type.
- 0x00: Unused, registration value = 0xFFFFFFFF.
- 0x01: Registration value = 32-bit REGID and/or PDS.
- 0x02: Registration value = 0xFFFFFFVV where 0xVV is the extended descriptor tag.
- 0x03: Registration value = 0xYYXXWWVV where 0xVV, 0xWW, 0xXX, 0xYY are the parent table ids, in increasing order. The unused table id values are set to 0xFF.
- other: Unused, registration value = 0xFFFFFFFF.
0xDD, 8 bits: Descriptor id or tag.

Member Enumeration Documentation

◆ Type

enum class ts::EDID::Type : uint8_t

strong

Enumeration of descriptor types.

Enumerator
REGULAR	Regular descriptor for the specified standard.
PRIVATE	Private MPEG or DVB descriptor, needs a REGID or PDS.
EXTENDED	MPEG or DVB extension descriptor. The descriptor tag must be 0x3F or 0x7F.
TABLE_SPEC	Table-specific descriptor.
INVALID	Invalid.

Constructor & Destructor Documentation

◆ EDID() [1/2]

ts::EDID::EDID ( )

default

Default constructor.

The initial value is invalid.

◆ EDID() [2/2]

constexpr ts::EDID::EDID ( uint64_t edid )

inlineexplicitconstexpr

Constructor from a 64-bit EDID value.

Parameters

[in] edid 64-bit EDID value.

Member Function Documentation

◆ Regular()

static constexpr EDID ts::EDID::Regular	(	DID	did,
		Standards	std
	)

inlinestaticconstexpr

Build the EDID for a regular descriptor.

Parameters

[in]	did	Descriptor tag.
[in]	std	Relevant standards.

Returns: The corresponding EDID.

◆ PrivateMPEG()

static constexpr EDID ts::EDID::PrivateMPEG	(	DID	did,
		REGID	regid
	)

inlinestaticconstexpr

Build the EDID for a private MPEG descriptor.

Parameters

[in]	did	Descriptor tag.
[in]	regid	Associated registration id.

Returns: The corresponding EDID.

◆ PrivateDVB()

static constexpr EDID ts::EDID::PrivateDVB	(	DID	did,
		PDS	pds
	)

inlinestaticconstexpr

Build the EDID for a private DVB descriptor.

Parameters

[in]	did	Descriptor tag.
[in]	pds	Associated private data specifier.

Returns: The corresponding EDID.

◆ PrivateDual()

static constexpr EDID ts::EDID::PrivateDual	(	DID	did,
		PDS	pds
	)

inlinestaticconstexpr

Build the EDID for a dual private descriptor.

This kind of descriptor can be used in a DVB context using a private data specifier descriptor or in a simple MPEG context using a registration descriptor. In both cases, the value of the private data specifier and the registration id are identical.

Parameters

[in]	did	Descriptor tag.
[in]	pds	Associated registration id and private data specifier.

Returns: The corresponding EDID.

◆ ExtensionMPEG()

static constexpr EDID ts::EDID::ExtensionMPEG ( DID ext )

inlinestaticconstexpr

Build the EDID for an MPEG extension descriptor.

Parameters

[in] ext Associated tag extension. The descriptor tag is implicitly DID_MPEG_EXTENSION.

Returns: The corresponding EDID.

◆ ExtensionDVB()

static constexpr EDID ts::EDID::ExtensionDVB ( DID ext )

inlinestaticconstexpr

Build the EDID for a DVB extension descriptor.

Parameters

[in] ext Associated tag extension. The descriptor tag is implicitly DID_DVB_EXTENSION.

Returns: The corresponding EDID.

◆ Extension()

static EDID ts::EDID::Extension ( XDID xdid )

static

Build the EDID for an MPEG or DVB extension descriptor.

Parameters

[in] xdid Extension descriptor id. If this is not an extension descriptor, create a regular descriptor EDID without standard.

Returns: The corresponding EDID.

◆ TableSpecific()

static EDID ts::EDID::TableSpecific	(	DID	did,
		Standards	std,
		TID	tid1,
		TID	tid2 = `TID_NULL`,
		TID	tid3 = `TID_NULL`,
		TID	tid4 = `TID_NULL`
	)

static

Build the EDID for a table-specific descriptor.

Parameters

[in]	did	Descriptor tag.
[in]	std	Relevant standards for the table.
[in]	tid1	Associated required table id.
[in]	tid2	Optional second table id.
[in]	tid3	Optional third table id.
[in]	tid4	Optional fourth table id.

Returns: The corresponding EDID.

◆ isValid()

bool ts::EDID::isValid ( ) const

inline

Check if the extended descriptor id is valid.

Returns: True if valid.

◆ type()

Type ts::EDID::type ( ) const

inline

Get the descriptor type.

Returns: The descriptor type.

◆ standards()

Standards ts::EDID::standards ( ) const

inline

Get the associated standards.

Returns: The mask of associated standards.

◆ isRegular()

bool ts::EDID::isRegular ( ) const

inline

Check if the descriptor is a regular one.

Returns: True if the descriptor is a standard one.

◆ did()

DID ts::EDID::did ( ) const

inline

Get the descriptor id (aka tag).

Returns: The descriptor id.

◆ isPrivateMPEG()

bool ts::EDID::isPrivateMPEG ( ) const

inline

Check if the descriptor is a MPEG or dual private descriptor.

Returns: True if the descriptor is a MPEG or dual private descriptor.

◆ isPrivateDVB()

bool ts::EDID::isPrivateDVB ( ) const

inline

Check if the descriptor is a DVB or dual private descriptor.

Returns: True if the descriptor is a DVB or dual private descriptor.

◆ isPrivateDual()

bool ts::EDID::isPrivateDual ( ) const

inline

Check if the descriptor is a dual private descriptor (can be used as MPEG or DVB private descriptor).

Returns: True if the descriptor is a dual private descriptor.

◆ regid()

REGID ts::EDID::regid ( ) const

inline

Get the MPEG registration identifier.

Returns: The MPEG registration identifier or REGID_NULL if this is not a private descriptor.

◆ pds()

PDS ts::EDID::pds ( ) const

inline

Get the DVB private data specifier.

Returns: The DVB private data specifier or PDS_NULL if this is not a private descriptor.

◆ privateId()

REGID ts::EDID::privateId ( ) const

inline

Get the MPEG registration identifier or DVB private data specifier.

Returns: The REGID/PDS or REGID_NULL if this is not a private descriptor.

◆ isExtensionMPEG()

bool ts::EDID::isExtensionMPEG ( ) const

inline

Check if the descriptor is an MPEG extension descriptor.

Returns: True if the descriptor is an MPEG extension descriptor.

◆ isExtensionDVB()

bool ts::EDID::isExtensionDVB ( ) const

inline

Check if the descriptor is a DVB extension descriptor.

Returns: True if the descriptor is a DVB extension descriptor.

◆ isExtension()

bool ts::EDID::isExtension ( ) const

inline

Check if the descriptor is an MPEG or DVB extension descriptor.

Returns: True if the descriptor is an MPEG or DVB extension descriptor.

◆ didExtMPEG()

DID ts::EDID::didExtMPEG ( ) const

inline

Get the MPEG descriptor tag extension.

Returns: The descriptor tag extension or XDID_NULL if this is not an MPEG extension descriptor.

◆ didExtDVB()

DID ts::EDID::didExtDVB ( ) const

inline

Get the DVB descriptor tag extension.

Returns: The descriptor tag extension or XDID_NULL if this is not a DVB extension descriptor.

◆ didExtension()

DID ts::EDID::didExtension ( ) const

inline

Get the MPEG or DVB descriptor tag extension.

Returns: The descriptor tag extension or XDID_NULL if this is not an extension descriptor.

◆ isTableSpecific()

bool ts::EDID::isTableSpecific ( ) const

inline

Check if the descriptor is table-specific.

Returns: True if the descriptor is table-specific.

◆ tableIds()

std::set< TID > ts::EDID::tableIds ( ) const

Get the required table-ids for a table-specific descriptor.

Returns: The set of possible table ids, empty if this is not a table-specific descriptor.

◆ matchTableSpecific()

bool ts::EDID::matchTableSpecific	(	TID	tid,
		Standards	std
	)		const

Check if the descriptor is table-specific and matches a given table id.

Parameters

[in]	tid	A table id to test.
[in]	std	Relevant standards.

Returns: True if the descriptor is table-specific for tid.

◆ matchRegularStandards()

bool ts::EDID::matchRegularStandards ( Standards std ) const

Check if the descriptor is a regular one and matches at least one standard.

Parameters

[in] std Relevant standards to test.

Returns: True if the descriptor is a regular one and matches at least one standard in std. If the regular descriptor has declared no standard, then it matches by default. If the regular descriptor has declared standards but none of them are in std, return true if all its standards are compatible with std. This is the way we discover new standards in the transport stream.

◆ xdid()

XDID ts::EDID::xdid ( ) const

Build an eXtension Descriptor Id from the EDID.

Returns: The corresponding eXtension Descriptor Id.

◆ encoded()

uint64_t ts::EDID::encoded ( ) const

inline

Get the 64-bit encoded EDID value.

There is not real usage for this in an application, except looking up names into the DTV names file.

Returns: The 64-bit encoded EDID value.

◆ toString()

UString ts::EDID::toString ( ) const

Convert to a string object.

Note: The EDID class does not implement StringifyInterface because we don't want to make it virtual and keep the instance size small, without vtable pointer.

Returns: This object, converted as a string.

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

tsEDID.h

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ Type

Constructor & Destructor Documentation

◆ EDID() [1/2]

◆ EDID() [2/2]

Member Function Documentation

◆ Regular()

◆ PrivateMPEG()

◆ PrivateDVB()

◆ PrivateDual()

◆ ExtensionMPEG()

◆ ExtensionDVB()

◆ Extension()

◆ TableSpecific()

◆ isValid()

◆ type()

◆ standards()

◆ isRegular()

◆ did()

◆ isPrivateMPEG()

◆ isPrivateDVB()

◆ isPrivateDual()

◆ regid()

◆ pds()

◆ privateId()

◆ isExtensionMPEG()

◆ isExtensionDVB()

◆ isExtension()

◆ didExtMPEG()

◆ didExtDVB()

◆ didExtension()

◆ isTableSpecific()

◆ tableIds()

◆ matchTableSpecific()

◆ matchRegularStandards()

◆ xdid()

◆ encoded()

◆ toString()