metal-rust 1.0.0

Safe Rust interfaces for Apple Metal
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

//! Checked descriptor-array access for vertex and stage-input configuration.

use crate::Error;

macro_rules! descriptor_array_access {
    ($array:ty, $item:ty) => {
        impl $array {
            /// Returns the descriptor at a checked Metal binding slot.
            pub fn get(&self, index: usize) -> Result<$item, Error> {
                self.inner
                    .get(index)
                    .map(<$item>::from_ffi)
                    .map_err(Error::from_ffi)
            }

            /// Sets or clears the descriptor at a checked Metal binding slot.
            pub fn set(&self, index: usize, value: Option<&$item>) -> Result<(), Error> {
                self.inner
                    .set(index, value.map(|value| &value.inner))
                    .map_err(Error::from_ffi)
            }
        }
    };
}

descriptor_array_access!(
    super::VertexBufferLayoutDescriptorArray,
    super::VertexBufferLayoutDescriptor
);
descriptor_array_access!(
    super::VertexAttributeDescriptorArray,
    super::VertexAttributeDescriptor
);
descriptor_array_access!(
    super::BufferLayoutDescriptorArray,
    super::BufferLayoutDescriptor
);
descriptor_array_access!(super::AttributeDescriptorArray, super::AttributeDescriptor);

impl super::VertexDescriptor {
    /// Creates the framework convenience descriptor after availability checks.
    pub fn default_descriptor() -> Result<Self, Error> {
        metal_rust_ffi::__private::objects::metal::VertexDescriptor::default_descriptor()
            .map(Self::from_ffi)
            .map_err(Error::from_ffi)
    }

    /// Resets the descriptor after checking runtime availability.
    pub fn reset_safe(&self) -> Result<(), Error> {
        self.inner.reset_safe().map_err(Error::from_ffi)
    }
}

impl super::StageInputOutputDescriptor {
    /// Creates the framework convenience descriptor after availability checks.
    pub fn default_descriptor() -> Result<Self, Error> {
        metal_rust_ffi::__private::objects::metal::StageInputOutputDescriptor::default_descriptor()
            .map(Self::from_ffi)
            .map_err(Error::from_ffi)
    }

    /// Resets the descriptor after checking runtime availability.
    pub fn reset_safe(&self) -> Result<(), Error> {
        self.inner.reset_safe().map_err(Error::from_ffi)
    }
}