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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

/*
 * File: control_point.rs
 * Project: focus
 * Created Date: 06/10/2023
 * Author: Shun Suzuki
 * -----
 * Last Modified: 08/10/2023
 * Modified By: Shun Suzuki (suzuki@hapis.k.u-tokyo.ac.jp)
 * -----
 * Copyright (c) 2023 Shun Suzuki. All rights reserved.
 *
 */

use crate::geometry::Vector3;

/// Control point for FocusSTM
#[derive(Clone, Copy)]
pub struct ControlPoint {
    /// Focal point
    point: Vector3,
    /// Duty shift
    /// Duty ratio of ultrasound will be `50% >> shift`.
    /// If `shift` is 0, duty ratio is 50%, which means the amplitude is the maximum.
    shift: u8,
}

impl ControlPoint {
    /// constructor (shift is 0)
    ///
    /// # Arguments
    ///
    /// * `point` - focal point
    ///
    pub fn new(point: Vector3) -> Self {
        Self { point, shift: 0 }
    }

    /// constructor
    ///
    /// # Arguments
    ///
    /// * `point` - focal point
    /// * `shift` - duty shift
    ///
    pub fn with_shift(self, shift: u8) -> Self {
        Self { shift, ..self }
    }

    pub fn point(&self) -> &Vector3 {
        &self.point
    }

    pub fn shift(&self) -> u8 {
        self.shift
    }
}

impl From<Vector3> for ControlPoint {
    fn from(point: Vector3) -> Self {
        Self::new(point)
    }
}

impl From<(Vector3, u8)> for ControlPoint {
    fn from((point, shift): (Vector3, u8)) -> Self {
        Self::new(point).with_shift(shift)
    }
}

impl From<&Vector3> for ControlPoint {
    fn from(point: &Vector3) -> Self {
        Self::new(*point)
    }
}

impl From<&(Vector3, u8)> for ControlPoint {
    fn from((point, shift): &(Vector3, u8)) -> Self {
        Self::new(*point).with_shift(*shift)
    }
}

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

    #[test]
    fn control_point() {
        let c = ControlPoint::from(Vector3::new(1., 2., 3.));
        assert_eq!(c.point().x, 1.);
        assert_eq!(c.point().y, 2.);
        assert_eq!(c.point().z, 3.);
        assert_eq!(c.shift(), 0);

        let c = ControlPoint::from((Vector3::new(1., 2., 3.), 4));
        assert_eq!(c.point().x, 1.);
        assert_eq!(c.point().y, 2.);
        assert_eq!(c.point().z, 3.);
        assert_eq!(c.shift(), 4);

        let c = ControlPoint::from(&Vector3::new(1., 2., 3.));
        assert_eq!(c.point().x, 1.);
        assert_eq!(c.point().y, 2.);
        assert_eq!(c.point().z, 3.);
        assert_eq!(c.shift(), 0);

        let c = ControlPoint::from(&(Vector3::new(1., 2., 3.), 4));
        assert_eq!(c.point().x, 1.);
        assert_eq!(c.point().y, 2.);
        assert_eq!(c.point().z, 3.);
        assert_eq!(c.shift(), 4);

        let cc = Clone::clone(&c);
        assert_eq!(cc.point().x, 1.);
        assert_eq!(cc.point().y, 2.);
        assert_eq!(cc.point().z, 3.);
        assert_eq!(cc.shift(), 4);
    }
}