three-d 0.19.0

2D/3D renderer - makes it simple to draw stuff across platforms (including web)
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
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

#![macro_use]
//!
//! A collection of objects implementing the [Object] trait.
//!
//! Objects can be rendered directly or used in a render call, for example [RenderTarget::render].
//! Use the [Gm] struct to combine any [geometry] and [material] into an [Object].
//!

macro_rules! impl_object_body {
    ($inner:ident) => {
        fn render(&self, viewer: &dyn Viewer, lights: &[&dyn Light]) {
            self.$inner().render(viewer, lights)
        }

        fn material_type(&self) -> MaterialType {
            self.$inner().material_type()
        }
    };
}

mod gm;
#[doc(inline)]
pub use gm::*;

mod model;
#[doc(inline)]
pub use model::*;

mod instanced_model;
#[doc(inline)]
pub use instanced_model::*;

mod voxel_grid;
#[doc(inline)]
pub use voxel_grid::*;

mod skybox;
#[doc(inline)]
pub use skybox::*;

mod imposters;
#[doc(inline)]
pub use imposters::*;

mod terrain;
#[doc(inline)]
pub use terrain::*;

mod water;
#[doc(inline)]
pub use water::*;

mod axes;
#[doc(inline)]
pub use axes::*;

mod wireframe;
#[doc(inline)]
pub use wireframe::*;

use crate::core::*;
use crate::renderer::*;

///
/// Represents a 3D object which can be rendered directly or used in a render call, for example [RenderTarget::render].
///
pub trait Object: Geometry {
    ///
    /// Render the object.
    /// Use an empty array for the `lights` argument, if the objects does not require lights to be rendered.
    /// Must be called in the callback given as input to a [RenderTarget], [ColorTarget] or [DepthTarget] write method.
    ///
    fn render(&self, viewer: &dyn Viewer, lights: &[&dyn Light]);

    ///
    /// Returns the type of material applied to this object.
    ///
    fn material_type(&self) -> MaterialType;
}

use std::ops::Deref;
impl<T: Object + ?Sized> Object for &T {
    impl_object_body!(deref);
}

impl<T: Object + ?Sized> Object for &mut T {
    impl_object_body!(deref);
}

impl<T: Object> Object for Box<T> {
    impl_object_body!(as_ref);
}

impl<T: Object> Object for std::rc::Rc<T> {
    impl_object_body!(as_ref);
}

impl<T: Object> Object for std::sync::Arc<T> {
    impl_object_body!(as_ref);
}

impl<T: Object> Object for std::cell::RefCell<T> {
    impl_object_body!(borrow);
}

impl<T: Object> Object for std::sync::RwLock<T> {
    fn render(&self, viewer: &dyn Viewer, lights: &[&dyn Light]) {
        self.read().unwrap().render(viewer, lights)
    }

    fn material_type(&self) -> MaterialType {
        self.read().unwrap().material_type()
    }
}