prophecy 0.5.0

FutureSDR GUI
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

//! Transformation of Rust arrays to JS.
// This Code is from maia-sdr
use js_sys::Float32Array;
use js_sys::Object;
use js_sys::Uint8Array;
use js_sys::Uint16Array;
use std::ops::Deref;
use web_sys::WebGl2RenderingContext;

/// Idiomatic transformation of Rust arrays to JS.
///
/// This trait gives an idiomatic way to transform Rust arrays into a JS typed
/// array (such as [`Float32Array`]) specifically for the use case of filling
/// WebGL2 buffers and textures.
///
/// For this, each Rust numeric type is associated with a JS typed array type
/// and with a constant that gives the corresponding WebGL2 data type (such as
/// `WebGL2RenderingContext::FLOAT`).
pub trait ArrayView: Sized {
    /// The associated JS typed array.
    type JS: Deref<Target = Object>;
    /// The associated WebGL2 data type.
    const GL_TYPE: u32;
    /// Creates a JS typed array which is a view into wasm's linear memory at
    /// the slice specified.
    ///
    /// This function uses the `view` method (such as [`Float32Array::view`]) of
    /// the JS typed array.
    ///
    /// # Safety
    ///
    /// The same safety considerations as with [`Float32Array::view`] apply.
    unsafe fn view(rust: &[Self]) -> Self::JS;
}

macro_rules! impl_array_view {
    ($rust:ty, $js:ty, $gl:expr_2021) => {
        impl ArrayView for $rust {
            type JS = $js;
            const GL_TYPE: u32 = $gl;
            unsafe fn view(rust: &[$rust]) -> $js {
                unsafe { <$js>::view(rust) }
            }
        }
    };
}

impl_array_view!(f32, Float32Array, WebGl2RenderingContext::FLOAT);
impl_array_view!(u16, Uint16Array, WebGl2RenderingContext::UNSIGNED_INT);
impl_array_view!(u8, Uint8Array, WebGl2RenderingContext::UNSIGNED_BYTE);