mtl-rs 0.2.1

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

use objc2::{Message, extern_protocol, msg_send, rc::Retained, runtime::ProtocolObject};
use objc2_foundation::{NSObjectProtocol, NSString};

use crate::MTLDevice;

extern_protocol!(
    /// Apple's documentation: `https://developer.apple.com/documentation/metal/mtlfence?language=objc`
    pub unsafe trait MTLFence: NSObjectProtocol + Send + Sync {
        #[unsafe(method(device))]
        #[unsafe(method_family = none)]
        fn device(&self) -> Retained<ProtocolObject<dyn MTLDevice>>;
    }
);

/// Rust-native label access for a Metal fence.
pub trait MTLFenceExt: MTLFence + Message {
    /// A string to help identify this object.
    fn label(&self) -> Option<String>
    where
        Self: Sized,
    {
        let label: Option<Retained<NSString>> = unsafe { msg_send![self, label] };
        label.map(|label| label.to_string())
    }

    /// Sets the optional label, copying it into the fence.
    fn set_label(
        &self,
        label: Option<&str>,
    ) where
        Self: Sized,
    {
        let label = label.map(NSString::from_str);
        unsafe {
            let _: () = msg_send![self, setLabel: label.as_deref()];
        }
    }
}

impl<T: MTLFence + Message> MTLFenceExt for T {}