Struct TsHeader 

pub struct TsHeader {
    pub tei: bool,
    pub pusi: bool,
    pub pid: u16,
    pub scrambling: u8,
    pub has_adaptation: bool,
    pub has_payload: bool,
    pub continuity_counter: u8,
}

Parsed TS header — the 4-byte transport header fields.

Fields

tei: bool

Transport Error Indicator — set by the demodulator when an uncorrectable error is present in the packet.

pusi: bool

Payload Unit Start Indicator — first byte of the payload is a new PES packet or PSI section header when set.

pid: u16

13-bit Packet Identifier.

scrambling: u8

2-bit transport_scrambling_control (0 = not scrambled).

has_adaptation: bool

Adaptation field present flag (adaptation_field_control bit 1).

has_payload: bool

Payload present flag (adaptation_field_control bit 0).

continuity_counter: u8

4-bit continuity_counter (wraps 0..=15 per PID).

Implementations

impl TsHeader

pub fn parse(raw4: &[u8]) -> Result<Self>

Parse a 4-byte TS transport header.

pub const fn serialized_len() -> usize

Number of bytes written by serialize_into.

pub fn serialize_into(&self, buf: &mut [u8]) -> Result<usize>

Serialize this header into the first 4 bytes of buf.

pub fn scrambling_control(&self) -> ScramblingControl

Typed view of the 2-bit transport_scrambling_control field.

See ScramblingControl for the spec citation (H.222.0 Table 2-4 + ETSI TS 100 289 §5.1 Table 1).

Examples found in repository

examples/iter_packets.rs (line 35)

fn main() {
    let path = env::args()
        .nth(1)
        .unwrap_or_else(|| "mpeg-ts/tests/fixtures/m6-single.ts".to_string());

    let buf = fs::read(&path).unwrap_or_else(|e| {
        eprintln!("error: cannot read {path}: {e}");
        std::process::exit(1);
    });

    let mut total = 0u64;
    let mut scrambled = 0u64;
    let mut pid_counts: HashMap<u16, u64> = HashMap::new();

    for pkt in iter_packets(&buf) {
        total += 1;
        let hdr = &pkt.header;
        *pid_counts.entry(hdr.pid).or_insert(0) += 1;

        let sc = hdr.scrambling_control();
        let afc = hdr.adaptation_field_control();

        if sc != ScramblingControl::NotScrambled {
            scrambled += 1;
        }

        if total <= 5 || hdr.pusi {
            println!(
                "pkt {:>6}: pid=0x{:04X} cc={:2} scrambling={} afc={}",
                total, hdr.pid, hdr.continuity_counter, sc, afc,
            );
        }
    }

    let clear = total - scrambled;
    println!("\n--- summary ---");
    println!("total packets : {total}");
    println!("clear packets : {clear}");
    println!("scrambled pkts: {scrambled}");
    println!("distinct PIDs : {}", pid_counts.len());

    if total == 0 {
        eprintln!("warning: no packets found in {path}");
        std::process::exit(1);
    }
}

pub fn adaptation_field_control(&self) -> AdaptationFieldControl

Typed view of the adaptation_field_control 2-bit field, derived from the has_adaptation/has_payload flags.

See AdaptationFieldControl for the spec citation (H.222.0 Table 2-5).

Examples found in repository

examples/iter_packets.rs (line 36)

fn main() {
    let path = env::args()
        .nth(1)
        .unwrap_or_else(|| "mpeg-ts/tests/fixtures/m6-single.ts".to_string());

    let buf = fs::read(&path).unwrap_or_else(|e| {
        eprintln!("error: cannot read {path}: {e}");
        std::process::exit(1);
    });

    let mut total = 0u64;
    let mut scrambled = 0u64;
    let mut pid_counts: HashMap<u16, u64> = HashMap::new();

    for pkt in iter_packets(&buf) {
        total += 1;
        let hdr = &pkt.header;
        *pid_counts.entry(hdr.pid).or_insert(0) += 1;

        let sc = hdr.scrambling_control();
        let afc = hdr.adaptation_field_control();

        if sc != ScramblingControl::NotScrambled {
            scrambled += 1;
        }

        if total <= 5 || hdr.pusi {
            println!(
                "pkt {:>6}: pid=0x{:04X} cc={:2} scrambling={} afc={}",
                total, hdr.pid, hdr.continuity_counter, sc, afc,
            );
        }
    }

    let clear = total - scrambled;
    println!("\n--- summary ---");
    println!("total packets : {total}");
    println!("clear packets : {clear}");
    println!("scrambled pkts: {scrambled}");
    println!("distinct PIDs : {}", pid_counts.len());

    if total == 0 {
        eprintln!("warning: no packets found in {path}");
        std::process::exit(1);
    }
}

Trait Implementations

impl Clone for TsHeader

fn clone(&self) -> TsHeader

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TsHeader

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for TsHeader

impl<'a> Parse<'a> for TsHeader

type Error = Error

The error type this implementer returns. Typically the enclosing crate’s Error enum.

fn parse(bytes: &'a [u8]) -> Result<Self>

Parse bytes as Self. Returns Err(Self::Error) on any protocol violation or buffer underrun.

impl PartialEq for TsHeader

fn eq(&self, other: &TsHeader) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TsHeader

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Serialize for TsHeader

type Error = Error

The error type this implementer returns (usually the same as the corresponding Parse impl, but need not be).

fn serialized_len(&self) -> usize

Number of bytes serialize_into will write.

fn serialize_into(&self, buf: &mut [u8]) -> Result<usize>

Write the serialised form into buf. Returns the number of bytes written (always equal to serialized_len()).

fn to_bytes(&self) -> Vec<u8>

where Self::Error: Debug,

Convenience: allocate a Vec and serialise into it.

impl StructuralPartialEq for TsHeader