`cd9587f`

Exclude overlays from screenshots via SLS tag bit 9

Sets tag bits (1<<1) | (1<<9) on every overlay window: bit 1 is
kCGSIgnoreForEvents (click-through), bit 9 hides the window from
ScreenCaptureKit, the screenshot picker, and screen recordings.
Mirrors JankyBorders' approach (.refs/JankyBorders/src/border.c:290
and .refs/JankyBorders/src/misc/window.h:266).

Tags are now set BEFORE SLWindowContextCreate / drawing, which is the
critical difference from the prior tag-based attempt that poisoned
SLSNewWindow on stack-cycle recreates. Removes the now-redundant
SLSSetWindowEventShape/Mask, SLSSetWindowSharingState, and
SLSSetWindowClientPerceivedType bindings.

Authored by mfwolffe <wolffemf@dukes.jmu.edu> 2 weeks ago

SHA: cd9587f96bedc37cd8bd887715fc5815094f4834
Parents: 24073c1
Tree: d0fedce

2 changed files

Status	File	+	-
M	`src/main.rs`	13	22
M	`src/skylight.rs`	0	25

src/main.rsmodified

          );
          SLSSetWindowResolution(cid, wid, scale);
++
 +        // Tag bit 1 (kCGSIgnoreForEvents) makes the overlay click/scroll
 +        // through; tag bit 9 hides it from ScreenCaptureKit (cmd+shift+4
 +        // + space, screen recordings, the picker). Mirrors JankyBorders'
 +        // ordering: tags MUST be set before SLWindowContextCreate /
 +        // drawing — setting them post-draw poisons subsequent SLSNewWindow
 +        // calls on the shared connection during stack-cycle recreates.
 +        // tag_size 64 (0x40) is the SLS-documented length.
 +        let set_tags: u64 = (1u64 << 1) | (1u64 << 9);
 +        let clear_tags: u64 = 0;
 +        SLSSetWindowTags(cid, wid, &set_tags, 64);
 +        SLSClearWindowTags(cid, wid, &clear_tags, 64);
++
          SLSSetWindowOpacity(cid, wid, false);
          SLSSetWindowLevel(cid, wid, 0);
          SLSOrderWindow(cid, wid, 1, target_wid);
          SLSFlushWindowContentRegion(cid, wid, ptr::null());
          CGContextRelease(ctx);
 -        // Click-through. Setting an empty event/hit-test shape makes mouse
 -        // events pass through the overlay to the window beneath. We use
 -        // SLSSetWindowEventShape rather than SLSSetWindowTags(kCGSIgnoreForEvents)
 -        // because tag mutation in the event-driven recreate path poisons
 -        // subsequent SLSNewWindow calls on the shared connection.
 -        // SLSSetWindowEventMask alone was insufficient on Tahoe.
 -        let empty = CGRect::new(0.0, 0.0, 0.0, 0.0);
 -        let mut empty_region: CFTypeRef = ptr::null();
 -        if CGSNewRegionWithRect(&empty, &mut empty_region) == kCGErrorSuccess
 -            && !empty_region.is_null()
 -        {
 -            SLSSetWindowEventShape(cid, wid, empty_region);
 -            CFRelease(empty_region);
 -        }
 -        SLSSetWindowEventMask(cid, wid, 0);
+-
 -        // Capture-exclusion advisories. Tahoe's screen-capture picker
 -        // ignores both for SLS overlays but they're harmless and may help
 -        // capture clients that do honor them.
 -        SLSSetWindowSharingState(cid, wid, 0);
 -        SLSSetWindowClientPerceivedType(cid, wid, 2);
+-
          Some((cid, wid, bounds, scale))
+     }
+ }

src/skylight.rsmodified

      ) -> CGError;
      pub fn SLSSetWindowResolution(cid: CGSConnectionID, wid: u32, res: f64) -> CGError;
      pub fn SLSSetWindowOpacity(cid: CGSConnectionID, wid: u32, is_opaque: bool) -> CGError;
 -    /// Mask of events the SLS window captures. Set to 0 to make the window
 -    /// click-through (mouse events pass to the window beneath). Used by
 -    /// border overlays so the user can still click/scroll the underlying
 -    /// app window.
 -    pub fn SLSSetWindowEventMask(cid: CGSConnectionID, wid: u32, mask: u32) -> CGError;
 -    /// Hit-test/input shape. An empty region passes all mouse events
 -    /// through to the window beneath. Equivalent to NSWindow's
 -    /// `setIgnoresMouseEvents(true)` at the SLS layer.
 -    pub fn SLSSetWindowEventShape(cid: CGSConnectionID, wid: u32, shape: CFTypeRef) -> CGError;
 -    /// NSWindowSharingType for the SLS window: 0 = None (excluded from
 -    /// screen capture / picker / recording), 1 = ReadOnly, 2 = ReadWrite.
 -    /// Tahoe's exported symbol is `SLSSetWindowSharingState` (not `Type`).
 -    /// Setting 0 makes the overlay invisible to ScreenCaptureKit, the
 -    /// cmd+shift+4 + space picker, etc., so user screenshots fall through
 -    /// to the underlying app window.
 -    pub fn SLSSetWindowSharingState(cid: CGSConnectionID, wid: u32, state: u32) -> CGError;
 -    /// Marks the SLS window as a non-standard "perceived type" so that
 -    /// screen-capture clients can choose to skip it. Yabai/skhd use this
 -    /// to keep borders out of screenshots without poisoning SLSNewWindow
 -    /// (unlike tag bits). Type 2 = "popup", 13/14 = system overlays.
 -    pub fn SLSSetWindowClientPerceivedType(
 -        cid: CGSConnectionID,
 -        wid: u32,
 -        kind: u32,
 -    ) -> CGError;
      pub fn SLSSetWindowAlpha(cid: CGSConnectionID, wid: u32, alpha: f32) -> CGError;
      pub fn SLSSetWindowBackgroundBlurRadius(cid: CGSConnectionID, wid: u32, radius: u32)
      -> CGError;