mtl-rs 0.1.10

Rust bindings for Apple's Metal API
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

use objc2::{
    extern_class, extern_conformance, extern_methods, msg_send,
    rc::{Allocated, Retained},
    runtime::NSObject,
};
use objc2_foundation::{CopyingHelper, NSCopying, NSObjectProtocol, NSString};

use super::{MTLCompareFunction, MTLStencilDescriptor};

extern_class!(
    /// Descriptor for creating a `DepthStencilState`.
    ///
    /// Availability: macOS 10.11+, iOS 8.0+
    #[unsafe(super(NSObject))]
    #[derive(Debug, PartialEq, Eq, Hash)]
    pub struct MTLDepthStencilDescriptor;
);

extern_conformance!(
    unsafe impl NSCopying for MTLDepthStencilDescriptor {}
);

unsafe impl CopyingHelper for MTLDepthStencilDescriptor {
    type Result = Self;
}

extern_conformance!(
    unsafe impl NSObjectProtocol for MTLDepthStencilDescriptor {}
);

impl MTLDepthStencilDescriptor {
    extern_methods!(
        /// Depth compare function. Defaults to `Always`, which effectively skips the depth test.
        #[unsafe(method(depthCompareFunction))]
        #[unsafe(method_family = none)]
        pub fn depth_compare_function(&self) -> MTLCompareFunction;

        #[unsafe(method(setDepthCompareFunction:))]
        #[unsafe(method_family = none)]
        pub fn set_depth_compare_function(
            &self,
            value: MTLCompareFunction,
        );

        /// Whether depth writes are performed. Defaults to `false`.
        #[unsafe(method(isDepthWriteEnabled))]
        #[unsafe(method_family = none)]
        pub fn is_depth_write_enabled(&self) -> bool;

        #[unsafe(method(setDepthWriteEnabled:))]
        #[unsafe(method_family = none)]
        pub fn set_depth_write_enabled(
            &self,
            value: bool,
        );

        /// Separate stencil state for front face.
        #[unsafe(method(frontFaceStencil))]
        #[unsafe(method_family = none)]
        pub fn front_face_stencil(&self) -> Retained<MTLStencilDescriptor>;

        #[unsafe(method(setFrontFaceStencil:))]
        #[unsafe(method_family = none)]
        pub fn set_front_face_stencil(
            &self,
            value: Option<&MTLStencilDescriptor>,
        );

        /// Separate stencil state for back face.
        #[unsafe(method(backFaceStencil))]
        #[unsafe(method_family = none)]
        pub fn back_face_stencil(&self) -> Retained<MTLStencilDescriptor>;

        #[unsafe(method(setBackFaceStencil:))]
        #[unsafe(method_family = none)]
        pub fn set_back_face_stencil(
            &self,
            value: Option<&MTLStencilDescriptor>,
        );
    );

    pub fn label(&self) -> Option<String> {
        let label: Option<Retained<NSString>> = unsafe { msg_send![self, label] };
        label.map(|s| s.to_string())
    }

    pub fn set_label(
        &self,
        label: Option<&str>,
    ) {
        unsafe {
            let _: () = msg_send![self, setLabel: label.map(NSString::from_str).as_deref()];
        }
    }
}

impl MTLDepthStencilDescriptor {
    extern_methods!(
        #[unsafe(method(init))]
        #[unsafe(method_family = init)]
        pub fn init(this: Allocated<Self>) -> Retained<Self>;

        #[unsafe(method(new))]
        #[unsafe(method_family = new)]
        pub fn new() -> Retained<Self>;
    );
}