cad-cs 0.1.0-beta.2

Calculations on Coordinate Systems (2D/3D geometry, vectors, transformations)
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

// 📃 ./src/libs/cs/macros.rs

/*/
 * // Makro generujące Cs<N>
 * #[macro_export]
 * macro_rules! cs {
 *     ($($x:expr),* $(,)?) => {
 *         $crate::libs::cs::Cs([$($x as f64),*])
 *     };
 * }
 */

/// 📚 【 POL 】: Konstruktor makrowy dla `Cs<N>`. Obsługuje rzutowanie typów numerycznych na f64.
/// 📚 【 ENG 】: Macro constructor for `Cs<N>`. Handles casting of numerical types to f64.
///
/// # Examples: `cs![1, 2]` (Cs2), `cs![1, 2, 3]` (Cs3)
#[macro_export]
macro_rules! cs {
	// Dopasowanie dokładnie dla 2 elementów
	($x:expr, $y:expr $(,)?) => {
		$crate::libs::cs::model::Cs([$x as f64, $y as f64])
	};
	// Dopasowanie dokładnie dla 3 elementów
	($x:expr, $y:expr, $z:expr $(,)?) => {
		$crate::libs::cs::model::Cs([$x as f64, $y as f64, $z as f64])
	};
}

/// 📚 【 POL 】: Konstruktor makrowy tworzący instancję Angle z formatu DMS.
/// 📚 【 ENG 】: Macro constructor creating an Angle instance from DMS format.
#[macro_export]
macro_rules! dms_angle {
    ($d:expr, $m:expr, $s:expr) => {
        // W pełni kwalifikowana ścieżka uwalnia użytkownika z konieczności importowania AbstractAngle!
        <$crate::libs::angle::Angle as $crate::libs::angle::AbstractAngle>::from_dms($d as i16, $m as u8, $s as f32)
    };
}

/// 📚 【 POL 】: Konwertuje format DMS bezpośrednio do wartości f64 w radianach.
/// 📚 【 ENG 】: Converts DMS format directly to a f64 value in radians.
#[macro_export]
macro_rules! dms {
    ($d:expr, $m:expr, $s:expr) => {
        // Tutaj tak samo - wywołujemy .rad() bezpośrednio z traita, aby uniknąć błędów zakresu (scope).
        <$crate::libs::angle::Angle as $crate::libs::angle::AbstractAngle>::rad(
            <$crate::libs::angle::Angle as $crate::libs::angle::AbstractAngle>::from_dms($d as i16, $m as u8, $s as f32)
        )
    };
}

/// 📚 【 POL】: Makro implementujące trait AbstractSignStrExt dla wskazanych typów liczbowych i zdefiniowanego punktu zera.
/// 📚 【 ENG】: Macro implementing the AbstractSignStrExt trait for specified numerical types and a defined zero point.
#[macro_export]
macro_rules! impl_sign_str {
	($t:ty, $zero:expr) => {
		impl $crate::libs::cs::abstracts::AbstractSignStrExt for $t {
			#[inline]
			fn sign_str(self) -> &'static str { if self >= $zero { "+" } else { "-" } }
			#[inline]
			fn sign_sn(self) -> &'static str { if self >= $zero { "N" } else { "S" } }
			#[inline]
			fn sign_we(self) -> &'static str { if self >= $zero { "E" } else { "W" } }
		}
	};
}