rust-3d 0.25.2

2D/3D library written in rust
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

/*
Copyright 2017 Martin Buck
This file is part of rust-3d.
rust-3d is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
rust-3d is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with rust-3d.  If not, see <http://www.gnu.org/licenses/>.
*/

//! LineSegment3D, a line segment within 3D space

use std::fmt;

use prelude::*;
use distances_3d::dist_3d;
use functions::center_3d;

#[derive (Debug, PartialEq, PartialOrd, Eq, Clone, Hash)]
/// LineSegment3D, a line segment within 3D space
pub struct LineSegment3D {
    pub start: Point3D,
    pub end: Point3D
}

impl LineSegment3D {
    /// Creates a new LineSegment3D from a start and end point
    pub fn new(start: Point3D, end: Point3D) -> Self {
        LineSegment3D{start, end}
    }
}

impl IsMovable3D for LineSegment3D {
    fn move_by(&mut self, x: f64, y: f64, z: f64) {
        self.start.move_by(x, y, z);
        self.end.move_by(x, y, z);
    }
}

impl HasLength for LineSegment3D {
    fn length(&self) -> f64 {
        dist_3d(&self.start, &self.end)
    }
}

impl HasBoundingBox3D for LineSegment3D {
    fn bounding_box(&self) -> Result<BoundingBox3D> {
        let mut pts = Vec::new();
        pts.push(Box::new(self.start.clone()));
        pts.push(Box::new(self.end.clone()));
        BoundingBox3D::from_iterator(pts.iter())
    }
}

impl HasCenterOfGravity3D for LineSegment3D {
    fn center_of_gravity(&self) -> Result<Point3D> {
        Ok(center_3d(&self.start, &self.end))
    }
}

impl IsScalable for LineSegment3D {
    fn scale(&mut self, factor: Positive) {
        let c = self.center_of_gravity().unwrap(); //always known

        self.start.increase_distance_to_by(&c, factor);
        self.end.increase_distance_to_by(&c, factor);
    }
}

impl fmt::Display for LineSegment3D {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "({}, {}, {} -> {}, {}, {})", self.start.x(), self.start.y(), self.start.z(), self.end.x(), self.end.y(), self.end.z())
    }
}