muri 0.13.6

Menu Utilities for Rust Interfaces — a cross-platform, fully-styleable tray-icon and popup-menu system (a custom-drawn muda/tray-icon replacement).
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

//! Present path: blit the shared [`Framebuffer`] to a panel's content view via
//! a `CALayer`, replacing the old `softbuffer` framebuffer.
//!
//! The framebuffer is premultiplied RGBA; we wrap its bytes in a `CGImage` and
//! set that as the content view's `layer.contents`. Per-pixel alpha lets the
//! rounded-corner transparency composite over the OS vibrancy backdrop (spec
//! 20 §2) — no opaque flatten happens here (that was the shipped bug that hid
//! vibrancy).

use core::ptr;

use objc2::runtime::AnyObject;
use objc2_app_kit::NSView;
use objc2_core_foundation::{CFData, CFRetained};
use objc2_core_graphics::{
    CGBitmapInfo, CGColorRenderingIntent, CGColorSpace, CGDataProvider, CGImage, CGImageAlphaInfo,
};
use objc2_quartz_core::CATransaction;

use crate::render::Framebuffer;

/// The device-RGB color space, created once per thread and cheaply retained on
/// each present. The color space is constant, so recreating it on every frame
/// (the present runs on every hover row-change) was pure waste; a `CFRetained`
/// clone is a refcount bump, not a rebuild. The present path is main-thread only,
/// so a `thread_local` sidesteps `Send`/`Sync` on the CF wrapper.
fn device_rgb_color_space() -> Option<CFRetained<CGColorSpace>> {
    thread_local! {
        static DEVICE_RGB: Option<CFRetained<CGColorSpace>> = CGColorSpace::new_device_rgb();
    }
    DEVICE_RGB.with(|cs| cs.clone())
}

/// Build a `CGImage` from a premultiplied-RGBA framebuffer. The returned image
/// retains a copy of the pixel bytes (via the `CFData` its data provider
/// holds), so it stays valid after the framebuffer is dropped; keep it alive for
/// as long as it is the layer's contents.
pub(super) fn framebuffer_to_cgimage(fb: &Framebuffer) -> Option<CFRetained<CGImage>> {
    let w = fb.width() as usize;
    let h = fb.height() as usize;
    if w == 0 || h == 0 {
        return None;
    }
    let data = fb.pixels();
    // `CFDataCreate` copies the bytes, so the framebuffer may be freed afterwards.
    let cfdata = unsafe { CFData::new(None, data.as_ptr(), data.len() as isize) }?;
    let provider = CGDataProvider::with_cf_data(Some(&cfdata))?;
    let color_space = device_rgb_color_space()?;
    // Alpha last (RGBA), premultiplied — matches the framebuffer's pixel format.
    let bitmap_info = CGBitmapInfo(CGImageAlphaInfo::PremultipliedLast.0);
    unsafe {
        CGImage::new(
            w,
            h,
            8,
            32,
            w * 4,
            Some(&color_space),
            bitmap_info,
            Some(&provider),
            ptr::null(),
            false,
            CGColorRenderingIntent::RenderingIntentDefault,
        )
    }
}

/// Set `image` as the layer contents of a layer-backed content view and pin the
/// contents scale to the device scale so device pixels map back to points.
pub(super) fn set_layer_contents(view: &NSView, image: &CGImage, scale: f32) {
    let Some(layer) = view.layer() else {
        return;
    };
    // A `CGImageRef` is toll-free acceptable as `CALayer.contents`.
    let obj: *const AnyObject = (image as *const CGImage).cast();
    // `contents` is animatable: assigning it outside `drawRect:` otherwise
    // triggers Core Animation's default ~0.25s cross-fade, making hover feel
    // laggy. Disable actions so the swap is immediate, like native.
    CATransaction::begin();
    CATransaction::setDisableActions(true);
    unsafe {
        layer.setContents(Some(&*obj));
    }
    layer.setContentsScale(scale as f64);
    CATransaction::commit();
}