Struct MediaSource 

#[non_exhaustive]
pub struct MediaSource {
    pub id: SourceId,
    pub locator: String,
    pub kind: MediaKind,
    pub color_metadata: Option<ColorMetadata>,
    pub has_audio: bool,
    pub generator: Option<Generator>,
    pub composition: Option<CompositionId>,
    pub fingerprint: Option<MediaFingerprint>,
    pub provider: Option<ProviderSource>,
}

A host-resolved media resource.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: SourceId

Stable source identity.

locator: String

Opaque URI or host locator; the engine does not open it. Required except for MediaKind::Generated and MediaKind::Composition sources.

kind: MediaKind

Media payload domain.

color_metadata: Option<ColorMetadata>

The color a MediaKind::Video source’s pictures are in, overriding frame and stream tags on every host. Recorded at import or declared to correct missing or wrong tags; None leaves the tags in charge. Stills are always read as sRGB code values.

has_audio: bool

Whether the media has an audio stream. This is a fact of the file, recorded the same by every host whether or not it can decode the stream; a host that cannot plays the source silent.

MediaKind::Audio always does. A MediaKind::Video source must declare it for its clips on a visual track to contribute to the mix.

generator: Option<Generator>

What a MediaKind::Generated source draws; present exactly for that kind.

composition: Option<CompositionId>

The composition a MediaKind::Composition source shows; present exactly for that kind.

fingerprint: Option<MediaFingerprint>

What the host found at the locator when the project recorded it, so another host can tell whether media it finds is the same. Generated sources have none.

provider: Option<ProviderSource>

The extension provider and settings that supply this source’s media when the host’s own decoders do not read it.

Implementations

impl MediaSource

pub fn new(id: SourceId, locator: impl Into<String>, kind: MediaKind) -> Self

Creates a silent-by-default source without explicit color metadata.

pub const fn generated(id: SourceId, generator: Generator) -> Self

Creates a source the engine draws itself.

pub const fn composition(id: SourceId, composition: CompositionId) -> Self

Creates a source that shows composition composition.

pub const fn is_host_supplied(&self) -> bool

Returns whether a host supplies this source’s media; the engine draws generated and composition sources itself.

pub const fn is_audible(&self) -> bool

Returns whether this source can contribute samples to the audio mix.

pub fn effective_color_metadata(&self) -> ColorMetadata

Returns declared color metadata or the SDR BT.709 limited-range fallback.

Trait Implementations

impl Clone for MediaSource

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MediaSource

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MediaSource

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MediaSource

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for MediaSource

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MediaSource