bresenham_zip 1.0.0

Iterator to perform Bresenham over two lines of the same triangle simultaneusly for triangle rasterization
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

/// Convenience tool to build a whole zip of any dimension and axis with a single line call.
/// The schema call goes like this:
///
/// `<dimension>:<axis> - <starting point> -> <first ending point>, <second ending point>`
///
/// Being: `dimension` one of `2` or `3`, axis: `x`|`y`|`z` and the points tuples of [crate::Point2]
/// or [crate::Point3] depending of the dimension of the Zip to create.
///
/// # Example
/// ```
/// # use std::error::Error;
/// # fn main() -> Result<(), Box<dyn Error>> { ///
/// // 2D Zip to iterate through X
/// let zip_2d_x = bresenham_zip::build_zip!(2D:X - (50, 50) -> (100, 0), (100, 100))?;
/// // 3D Zip to iterate through Z
/// let zip_3d_z = bresenham_zip::build_zip!(3D:Z - (50, 50, 50) -> (0, 0, 100), (25, 50, 100))?;
/// # Ok(())
/// # }
/// ```
#[macro_export]
macro_rules! build_zip {
    (2D:X - $start:tt -> $end_a:tt, $end_b:tt) => {
	    $crate::zip::Builder::new()
		      .axis($crate::Axis::X)
					.start_point($start)
					.first_ending_point($end_a)
					.second_ending_point($end_b)
					.build()
    };
    (2D:Y - $start:tt -> $end_a:tt, $end_b:tt) => {
	    $crate::zip::Builder::new()
		      .axis($crate::Axis::Y)
					.start_point($start)
					.first_ending_point($end_a)
					.second_ending_point($end_b)
					.build()
    };
    (3D:X - $start:tt -> $end_a:tt, $end_b:tt) => {
	    $crate::zip_3d::Builder3d::new()
		      .axis($crate::Axis::X)
					.start_point($start)
					.first_ending_point($end_a)
					.second_ending_point($end_b)
					.build()
    };
    (3D:Y - $start:tt -> $end_a:tt, $end_b:tt) => {
	    $crate::zip_3d::Builder3d::new()
		      .axis($crate::Axis::Y)
					.start_point($start)
					.first_ending_point($end_a)
					.second_ending_point($end_b)
					.build()
    };
    (3D:Z - $start:tt -> $end_a:tt, $end_b:tt) => {
	    $crate::zip_3d::Builder3d::new()
		      .axis($crate::Axis::Z)
					.start_point($start)
					.first_ending_point($end_a)
					.second_ending_point($end_b)
					.build()
    };
}