oximedia-virtual 0.1.3

Virtual production and LED wall tools for OxiMedia
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

//! Lens calibration and correction
//!
//! Provides lens calibration, distortion compensation, and FOV calculation.

pub mod calibrate;
pub mod distortion;
pub mod fov;

use serde::{Deserialize, Serialize};

/// Lens parameters
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LensParameters {
    /// Focal length in millimeters
    pub focal_length: f64,
    /// Sensor width in millimeters
    pub sensor_width: f64,
    /// Sensor height in millimeters
    pub sensor_height: f64,
    /// Radial distortion coefficients
    pub radial_distortion: Vec<f64>,
    /// Tangential distortion coefficients
    pub tangential_distortion: Vec<f64>,
}

impl LensParameters {
    /// Create new lens parameters
    #[must_use]
    pub fn new(focal_length: f64, sensor_width: f64, sensor_height: f64) -> Self {
        Self {
            focal_length,
            sensor_width,
            sensor_height,
            radial_distortion: vec![0.0, 0.0, 0.0],
            tangential_distortion: vec![0.0, 0.0],
        }
    }

    /// Get horizontal field of view in degrees
    #[must_use]
    pub fn horizontal_fov(&self) -> f64 {
        2.0 * (self.sensor_width / (2.0 * self.focal_length))
            .atan()
            .to_degrees()
    }

    /// Get vertical field of view in degrees
    #[must_use]
    pub fn vertical_fov(&self) -> f64 {
        2.0 * (self.sensor_height / (2.0 * self.focal_length))
            .atan()
            .to_degrees()
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_lens_parameters() {
        let lens = LensParameters::new(50.0, 36.0, 24.0);
        assert_eq!(lens.focal_length, 50.0);

        let hfov = lens.horizontal_fov();
        assert!(hfov > 0.0 && hfov < 180.0);
    }
}