Enum PortContract 

pub enum PortContract {
    Packets(MediaKindSet),
    Frames(MediaKindSet, MemoryDomainSet),
}

What one port deals in.

Split by encoding rather than carrying an optional domain, because the two halves ask different questions. Encoded media is always host memory, so Self::Packets has nowhere to put a domain and nowhere to forget one. Decoded frames always live somewhere specific, so Self::Frames always states it — an element that genuinely takes any backend says MemoryDomainSet::ALL, which reads as the deliberate claim it is rather than as an omission.

The two never link to each other. That falls out of the shape, and it matches MediaKind: no packet kind is a frame kind.

Variants

Packets(MediaKindSet)

Encoded media — MediaKind::VideoPacket/MediaKind::AudioPacket.

Frames(MediaKindSet, MemoryDomainSet)

Decoded frames — MediaKind::VideoFrame/MediaKind::AudioFrame — together with the backends their memory may live in.

Implementations

impl PortContract

pub const fn packet(kind: MediaKind) -> Self

One encoded kind.

pub const fn frame(kind: MediaKind, memory: MemoryDomain) -> Self

One decoded kind in one backend’s memory.

pub const fn any_frame(kind: MediaKind) -> Self

One decoded kind, wherever it lives — for an element that forwards or counts frames without reading them.

pub fn accepts(&self, produced: &PortContract) -> bool

Returns whether a producer emitting produced can feed a consumer accepting self.

Every kind the producer may emit has to be accepted, and so does every domain its frames may live in. Encoded media and decoded frames never satisfy each other.

Trait Implementations

impl Clone for PortContract

fn clone(&self) -> PortContract

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PortContract

impl Debug for PortContract

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

Formats the value using the given formatter.

impl Display for PortContract

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

Formats the value using the given formatter.

impl Eq for PortContract

impl PartialEq for PortContract

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PortContract