Enum mpv::Error

pub enum Error {
    MPV_ERROR_SUCCESS,
    MPV_ERROR_EVENT_QUEUE_FULL,
    MPV_ERROR_NOMEM,
    MPV_ERROR_UNINITIALIZED,
    MPV_ERROR_INVALID_PARAMETER,
    MPV_ERROR_OPTION_NOT_FOUND,
    MPV_ERROR_OPTION_FORMAT,
    MPV_ERROR_OPTION_ERROR,
    MPV_ERROR_PROPERTY_NOT_FOUND,
    MPV_ERROR_PROPERTY_FORMAT,
    MPV_ERROR_PROPERTY_UNAVAILABLE,
    MPV_ERROR_PROPERTY_ERROR,
    MPV_ERROR_COMMAND,
    MPV_ERROR_LOADING_FAILED,
    MPV_ERROR_AO_INIT_FAILED,
    MPV_ERROR_VO_INIT_FAILED,
    MPV_ERROR_NOTHING_TO_PLAY,
    MPV_ERROR_UNKNOWN_FORMAT,
    MPV_ERROR_UNSUPPORTED,
    MPV_ERROR_NOT_IMPLEMENTED,
}

MPV_ERROR_SUCCESS

No error happened (used to signal successful operation)

MPV_ERROR_EVENT_QUEUE_FULL

The event ringbuffer is full. This means the client is choked, and can't receive any events. This can happen when too many asynchronous requests have been made, but not answered. Probably never happens in practice, unless the mpv core is frozen for some reason, and the client keeps making asynchronous requests. (Bugs in the client API implementation could also trigger this, e.g. if events become "lost".)

MPV_ERROR_NOMEM

'Memory allocation failed' error

MPV_ERROR_UNINITIALIZED

The mpv core wasn't configured and initialized yet. See mpv.init() for additional details

MPV_ERROR_INVALID_PARAMETER

Generic catch-all error if a parameter is set to an invalid or unsupported value. This is used if there is no better error code.

Example

Typically this is sent when you are trying to set properties or options where the value is not supported, but the format itself is

assert!(mpv.set_option("speed",-1.0).err() == Error::MPV_ERROR_UNINITIALIZED);
// setting option "speed" with a negative value makes no sense
// however sending floats for speed make sense, hence it did not send MPV_ERROR_OPTION_FORMAT

MPV_ERROR_OPTION_NOT_FOUND

Trying to set an option that doesn't exist.

Example

assert!(mpv.set_option("option_that_does_not_exist",0.5).err() == Error::MPV_ERROR_OPTION_NOT_FOUND);

MPV_ERROR_OPTION_FORMAT

Trying to set an option using an unsupported format.

Example

Sending a 'sid' value as a float.

Note that in most of the cases, when the libmpv option/property expect an integer and gets a &str, it will try to convert the said str and a integer.

assert!(mpv.set_option("loop","2").is_ok());
assert!(mpv.set_option("sid",4.5).err() == Error::MPV_ERROR_OPTION_FORMAT);

MPV_ERROR_OPTION_ERROR

Setting the option failed. Typically this happens if the provided option value could not be parsed

MPV_ERROR_PROPERTY_NOT_FOUND

The accessed property doesn't exist

MPV_ERROR_PROPERTY_FORMAT

Trying to set or get a property using an unsupported MPV_FORMAT. See MPV_ERROR_OPTION_FORMAT for more details.

MPV_ERROR_PROPERTY_UNAVAILABLE

The property exists, but is not available.

Example

This usually happens when the associated subsystem is not active, e.g. querying audio parameters while audio is disabled.

MPV_ERROR_PROPERTY_ERROR

Error setting or getting a property

MPV_ERROR_COMMAND

General error when running a command with mpv_command and similar

MPV_ERROR_LOADING_FAILED

Generic error on loading (used with MpvEventEndFile.error).

MPV_ERROR_AO_INIT_FAILED

Initializing the audio output failed.

MPV_ERROR_VO_INIT_FAILED

Initializing the video output failed.

MPV_ERROR_NOTHING_TO_PLAY

There was no audio or video data to play. This also happens if the file was recognized, but did not contain any audio or video streams, or no streams were selected.

MPV_ERROR_UNKNOWN_FORMAT

When trying to load the file, the file format could not be determined, or the file was too broken to open it.

MPV_ERROR_UNSUPPORTED

Generic error for signaling that certain system requirements are not fulfilled.

MPV_ERROR_NOT_IMPLEMENTED

The libmpv API function which was called is a stub only Note that unimplemented mpv-rs functions will simply panic with unimplemented!()

Variants

MPV_ERROR_SUCCESSMPV_ERROR_EVENT_QUEUE_FULLMPV_ERROR_NOMEMMPV_ERROR_UNINITIALIZEDMPV_ERROR_INVALID_PARAMETERMPV_ERROR_OPTION_NOT_FOUNDMPV_ERROR_OPTION_FORMATMPV_ERROR_OPTION_ERRORMPV_ERROR_PROPERTY_NOT_FOUNDMPV_ERROR_PROPERTY_FORMATMPV_ERROR_PROPERTY_UNAVAILABLEMPV_ERROR_PROPERTY_ERRORMPV_ERROR_COMMANDMPV_ERROR_LOADING_FAILEDMPV_ERROR_AO_INIT_FAILEDMPV_ERROR_VO_INIT_FAILEDMPV_ERROR_NOTHING_TO_PLAYMPV_ERROR_UNKNOWN_FORMATMPV_ERROR_UNSUPPORTEDMPV_ERROR_NOT_IMPLEMENTED

Trait Implementations

impl Error for Error

fn description(&self) -> &str

A short description of the error.

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

The lower-level cause of this error, if any.

impl Display for Error

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

Formats the value using the given formatter.

impl Debug for Error

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Copy for Error

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl FromPrimitive for Error

fn from_i64(n: i64) -> Option<Self>

Convert an i64 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_u64(n: u64) -> Option<Self>

Convert an u64 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_isize(n: isize) -> Option<Self>

Convert an isize to return an optional value of this type. If the value cannot be represented by this value, the None is returned.

fn from_i8(n: i8) -> Option<Self>

Convert an i8 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_i16(n: i16) -> Option<Self>

Convert an i16 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_i32(n: i32) -> Option<Self>

Convert an i32 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_usize(n: usize) -> Option<Self>

Convert a usize to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_u8(n: u8) -> Option<Self>

Convert an u8 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_u16(n: u16) -> Option<Self>

Convert an u16 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_u32(n: u32) -> Option<Self>

Convert an u32 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_f32(n: f32) -> Option<Self>

Convert a f32 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.

fn from_f64(n: f64) -> Option<Self>

Convert a f64 to return an optional value of this type. If the type cannot be represented by this value, the None is returned.