Enum SourceSpec 

pub enum SourceSpec {
    Rtsp {
        url: String,
        transport: RtspTransport,
        security: RtspSecurityPolicy,
    },
    File {
        path: PathBuf,
        loop_: bool,
    },
    V4l2 {
        device: String,
    },
    Custom {
        pipeline_fragment: String,
    },
}

Specification of a video source.

Defined in nv-core (not nv-media) to prevent downstream crates from transitively depending on GStreamer.

Variants

Rtsp

An RTSP stream.

The security field controls TLS enforcement. The default (PreferTls) promotes bare rtsp:// URLs to rtsps:// at pipeline construction time.

Fields

url: String

transport: RtspTransport

security: RtspSecurityPolicy

TLS security policy for this source. Default: PreferTls.

File

A local video file.

Fields

path: PathBuf

loop_: bool

Whether to loop the file when it reaches the end.

V4l2

A Video4Linux2 device (Linux only).

Fields

device: String

Custom

Escape hatch: a raw pipeline launch-line fragment.

The library constructs the pipeline internally for all other variants. Use this only for exotic sources not covered above.

Security note: Custom pipelines are gated by CustomPipelinePolicy at the runtime layer. The default policy rejects custom pipelines; set CustomPipelinePolicy::AllowTrusted on the runtime builder to enable them.

Fields

pipeline_fragment: String

Implementations

impl SourceSpec

pub fn rtsp(url: impl Into<String>) -> Self

Convenience constructor for an RTSP source with TCP transport.

The security policy is inferred from the URL scheme:

• rtsps:// or no recognized scheme → PreferTls
• rtsp:// → AllowInsecure

An explicit rtsp:// scheme is treated as a deliberate choice by the caller and is not promoted to rtsps://. Use rtsp_tls to force TLS promotion on a bare rtsp:// URL.

pub fn rtsp_tls(url: impl Into<String>) -> Self

Convenience constructor that forces PreferTls.

Unlike rtsp(), this promotes bare rtsp:// URLs to rtsps:// at pipeline construction time. Use this when you know the camera supports TLS but the URL was provided without the rtsps:// scheme.

pub fn rtsp_insecure(url: impl Into<String>) -> Self

Convenience constructor for an RTSP source with explicit insecure transport (AllowInsecure).

Equivalent to rtsp() for rtsp:// URLs. Useful when constructing a spec from a variable where you want to guarantee AllowInsecure regardless of the scheme.

pub fn file(path: impl Into<PathBuf>) -> Self

Convenience constructor for a local video file (non-looping).

pub fn file_looping(path: impl Into<PathBuf>) -> Self

Convenience constructor for a looping local video file.

The source seeks back to the start on EOS instead of stopping.

pub fn is_file_nonloop(&self) -> bool

Returns true if this is a non-looping file source.

Non-looping file sources treat EOS as terminal (not an error): the feed stops with StopReason::EndOfStream rather than attempting a restart.

Trait Implementations

impl Clone for SourceSpec

fn clone(&self) -> SourceSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceSpec

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

Formats the value using the given formatter.