Enum CvError 

pub enum CvError {
    InvalidDimensions {
        width: u32,
        height: u32,
    },
    InvalidRoi {
        x: u32,
        y: u32,
        width: u32,
        height: u32,
    },
    InvalidKernelSize {
        size: usize,
    },
    ColorConversion {
        message: String,
    },
    UnsupportedFormat {
        format: String,
    },
    DetectionFailed {
        message: String,
    },
    TransformError {
        message: String,
    },
    TrackingError {
        message: String,
    },
    InsufficientData {
        expected: usize,
        actual: usize,
    },
    MatrixError {
        message: String,
    },
    InvalidParameter {
        name: String,
        value: String,
    },
    Core(OxiError),
    OnnxRuntime {
        message: String,
    },
    ModelLoad {
        message: String,
    },
    TensorError {
        message: String,
    },
    ShapeMismatch {
        expected: Vec<usize>,
        actual: Vec<usize>,
    },
    Io(Error),
}

Error type for computer vision operations.

This enum covers all possible errors that can occur during image processing, detection, and transformation operations.

Examples

use oximedia_cv::error::{CvError, CvResult};

fn process_image(width: u32, height: u32) -> CvResult<()> {
    if width == 0 || height == 0 {
        return Err(CvError::InvalidDimensions { width, height });
    }
    Ok(())
}

Variants

InvalidDimensions

Invalid image dimensions (width or height is zero).

Fields

width: u32

Image width.

height: u32

Image height.

InvalidRoi

Invalid region of interest.

Fields

x: u32

ROI x coordinate.

y: u32

ROI y coordinate.

width: u32

ROI width.

height: u32

ROI height.

InvalidKernelSize

Invalid kernel size for filter operations.

Fields

size: usize

The invalid kernel size.

ColorConversion

Color space conversion error.

Fields

message: String

Description of the error.

UnsupportedFormat

Unsupported pixel format.

Fields

format: String

The unsupported format name.

DetectionFailed

Detection failed.

Fields

message: String

Description of the failure.

TransformError

Transform computation failed.

Fields

message: String

Description of the error.

TrackingError

Tracking operation failed.

Fields

message: String

Description of the error.

InsufficientData

Insufficient data for operation.

Fields

expected: usize

Expected number of bytes.

actual: usize

Actual number of bytes.

MatrixError

Matrix operation error.

Fields

message: String

Description of the error.

InvalidParameter

Invalid parameter value.

Fields

name: String

Parameter name.

value: String

Invalid value description.

Core(OxiError)

Core error from oximedia-core.

OnnxRuntime

ONNX Runtime error.

Fields

message: String

Description of the error.

ModelLoad

Model loading error.

Fields

message: String

Description of the error.

TensorError

Tensor operation error.

Fields

message: String

Description of the error.

ShapeMismatch

Shape mismatch error.

Fields

expected: Vec<usize>

Expected shape.

actual: Vec<usize>

Actual shape.

Io(Error)

I/O error.

Implementations

impl CvError

pub const fn invalid_dimensions(width: u32, height: u32) -> Self

Creates a new invalid dimensions error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::invalid_dimensions(0, 100);
assert!(matches!(err, CvError::InvalidDimensions { width: 0, height: 100 }));

pub const fn invalid_roi(x: u32, y: u32, width: u32, height: u32) -> Self

Creates a new invalid ROI error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::invalid_roi(10, 20, 0, 50);
assert!(matches!(err, CvError::InvalidRoi { .. }));

pub const fn invalid_kernel_size(size: usize) -> Self

Creates a new invalid kernel size error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::invalid_kernel_size(4);
assert!(matches!(err, CvError::InvalidKernelSize { size: 4 }));

pub fn color_conversion(message: impl Into<String>) -> Self

Creates a new color conversion error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::color_conversion("Invalid color values");
assert!(matches!(err, CvError::ColorConversion { .. }));

pub fn unsupported_format(format: impl Into<String>) -> Self

Creates a new unsupported format error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::unsupported_format("YUV444");
assert!(matches!(err, CvError::UnsupportedFormat { .. }));

pub fn detection_failed(message: impl Into<String>) -> Self

Creates a new detection failed error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::detection_failed("No faces found");
assert!(matches!(err, CvError::DetectionFailed { .. }));

pub fn transform_error(message: impl Into<String>) -> Self

Creates a new transform error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::transform_error("Matrix is singular");
assert!(matches!(err, CvError::TransformError { .. }));

pub fn tracking_error(message: impl Into<String>) -> Self

Creates a new tracking error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::tracking_error("Tracker not initialized");
assert!(matches!(err, CvError::TrackingError { .. }));

pub const fn insufficient_data(expected: usize, actual: usize) -> Self

Creates a new insufficient data error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::insufficient_data(1024, 512);
assert!(matches!(err, CvError::InsufficientData { expected: 1024, actual: 512 }));

pub fn matrix_error(message: impl Into<String>) -> Self

Creates a new matrix error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::matrix_error("Matrix dimensions mismatch");
assert!(matches!(err, CvError::MatrixError { .. }));

pub fn invalid_parameter( name: impl Into<String>, value: impl Into<String>, ) -> Self

Creates a new invalid parameter error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::invalid_parameter("sigma", "-1.0");
assert!(matches!(err, CvError::InvalidParameter { .. }));

pub fn onnx_runtime(message: impl Into<String>) -> Self

Creates a new ONNX Runtime error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::onnx_runtime("Session initialization failed");
assert!(matches!(err, CvError::OnnxRuntime { .. }));

pub fn model_load(message: impl Into<String>) -> Self

Creates a new model load error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::model_load("File not found");
assert!(matches!(err, CvError::ModelLoad { .. }));

pub fn tensor_error(message: impl Into<String>) -> Self

Creates a new tensor error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::tensor_error("Invalid data type");
assert!(matches!(err, CvError::TensorError { .. }));

pub fn shape_mismatch(expected: Vec<usize>, actual: Vec<usize>) -> Self

Creates a new shape mismatch error.

Examples

use oximedia_cv::error::CvError;

let err = CvError::shape_mismatch(vec![1, 3, 224, 224], vec![1, 3, 256, 256]);
assert!(matches!(err, CvError::ShapeMismatch { .. }));

Trait Implementations

impl Debug for CvError

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

Formats the value using the given formatter.

impl Display for CvError

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

Formats the value using the given formatter.

impl Error for CvError

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 CvError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<OxiError> for CvError

fn from(source: OxiError) -> Self

Converts to this type from the input type.