Enum Error 

pub enum Error {
    Spawn {
        source: Error,
        path: String,
    },
    NoStdout,
    Io(Error),
    EndOfStream {
        frames_read: u64,
    },
    InvalidFormat {
        width: u32,
        height: u32,
        framerate: f64,
    },
    CameraNotFound {
        id: String,
    },
}

Failure modes for the GStreamer video capture pipe.

Variants

Spawn

gst-launch-1.0 could not be launched. The PATH snapshot in the message makes CI diagnoses easier.

Fields

source: Error

The OS-level reason the spawn failed.

path: String

$PATH at the moment of failure.

NoStdout

Stdout was not piped.

Io(Error)

I/O error while reading from the child’s stdout.

EndOfStream

Pipeline ended before the requested frame was read.

Fields

frames_read: u64

Frames actually delivered before EOF.

InvalidFormat

Dimensions or framerate would produce zero-byte frames.

Fields

width: u32

Requested width in pixels.

height: u32

Requested height in pixels.

framerate: f64

Requested framerate in fps.

CameraNotFound

The picker handed us a camera_id that no longer matches any device on the host — typically the camera was unplugged between list_cameras() and from_camera(). Callers should re-enumerate and re-prompt (M-CAM.4 / AUT — see milestone-2-record-and-export.md).

Fields

id: String

The id the caller passed in.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.