lsdetect 0.4.0

Line segment detector (LSD) in pure Rust, with a fast perspective warp and Python bindings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

//! The sample depths the crate's image inputs come in.

use std::fmt;

mod private {
    pub trait Sealed {}
    impl Sealed for u8 {}
    impl Sealed for u16 {}
    impl Sealed for f32 {}
    impl Sealed for f64 {}
}

/// A gray sample the detector can read.
pub trait Gray: Copy + Send + Sync + private::Sealed {
    /// The sample on the gray scale the detector's thresholds
    /// are calibrated for.
    fn to_gray(self) -> f64;

    /// The buffer itself when it already holds f64 grays.
    fn as_f64_slice(image: &[Self]) -> Option<&[f64]> {
        let _ = image;
        None
    }
}

impl Gray for u8 {
    fn to_gray(self) -> f64 {
        self as f64
    }
}

impl Gray for u16 {
    fn to_gray(self) -> f64 {
        self as f64 / 257.0
    }
}

impl Gray for f32 {
    fn to_gray(self) -> f64 {
        self as f64
    }
}

impl Gray for f64 {
    fn to_gray(self) -> f64 {
        self
    }

    fn as_f64_slice(image: &[Self]) -> Option<&[f64]> {
        Some(image)
    }
}

/// An RGB sample depth the warp can resample.
pub trait Sample: Copy + Send + Sync + private::Sealed {
    /// The sample as the float the interpolation runs on.
    fn to_f64(self) -> f64;
    /// The rounded interpolation result, back at this depth.
    fn from_f64(value: f64) -> Self;
}

impl Sample for u8 {
    fn to_f64(self) -> f64 {
        self as f64
    }

    fn from_f64(value: f64) -> Self {
        (value + 0.5) as u8
    }
}

impl Sample for u16 {
    fn to_f64(self) -> f64 {
        self as f64
    }

    fn from_f64(value: f64) -> Self {
        (value + 0.5) as u16
    }
}

/// The pixel buffer does not match the stated dimensions.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct SizeMismatch {
    /// Samples the dimensions demand.
    pub expected: usize,
    /// Samples the buffer holds.
    pub got: usize,
}

impl fmt::Display for SizeMismatch {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            f,
            "buffer holds {} samples, the dimensions demand {}",
            self.got, self.expected
        )
    }
}

impl std::error::Error for SizeMismatch {}